> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> ClickHouse Cloud サービス向けに初めての ClickHouse Agent を構築して実行する

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

Cloud Consoleでカスタムエージェントを作成し、サービスに対して自然言語クエリを実行します。

<div id="prerequisites">
  ## 前提条件
</div>

* クエリ可能な ClickHouse Cloud サービス。
* エージェントビルダーの **Create agent** オプション。表示されない場合は、[共有とアクセス](/ja/products/cloud/features/ai-ml/agents/sharing-and-access) に記載されている手順に従って、組織の Admin に依頼し、Admin Settings でエージェント作成を許可してもらってください。

<div id="build-the-agent">
  ## エージェントを構築する
</div>

<Steps>
  <Step>
    ### ClickHouse Agents を起動する

    Cloud サービスで、左側のサイドバーにある **ClickHouse agents** をクリックして、エージェントのランチパッドを開きます。次に **Launch ClickHouse agents** をクリックして、エージェントビルダーを開きます。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/launch-ch-agents.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=eb003c363ea35ae4b3a128e7c05aa0f7" alt="ClickHouse agents（ベータ）が選択された Cloud サービスのナビゲーションと、Launch ClickHouse agents ボタンが表示されたランチパッド" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.png" />
  </Step>

  <Step>
    ### エージェントを作成する

    エージェントビルダーで、左側パネル上部の **Create New Agent** をクリックします。次の主要フィールドを入力します。

    * **Name** - エージェントの短い識別名です。
    * **Description** - エージェントの用途を説明する文です。チームメンバーにも表示されます。
    * **Category** - エージェントのカテゴリです。組織でカスタムカテゴリを使っていない場合は、`General` のままで構いません。
    * **Instructions** - システムプロンプトです。エージェントの役割、回答すべき質問、従うべき業務ルールを記述します。
    * **Model** - ドロップダウンからモデルを選択します。temperature などの生成設定は [model parameters](/ja/products/cloud/features/ai-ml/agents/builder/model-parameters) で調整します。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/agent-builder.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=d0b3a2968764d7409ca639eb0f338d59" alt="Create New Agent ドロップダウン、フォームフィールド（Name、Description、Category、Instructions、Model）、および Capabilities セクションが表示されたエージェントビルダーパネル" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.png" />
  </Step>

  <Step>
    ### 機能とツールを追加する

    エージェントの機能とツールは 2 か所で設定します。

    メインパネルの **Capabilities** — [Run Code](/ja/products/cloud/features/ai-ml/agents/builder/code-interpreter)、[ウェブ検索](/ja/products/cloud/features/ai-ml/agents/builder/web-search)、File Context、Artifacts、[MCPサーバー](/ja/products/cloud/features/ai-ml/agents/builder/mcp-servers)、[スキル](/ja/products/cloud/features/ai-ml/agents/builder/skills) などのファーストパーティ機能です。エージェントに必要なものを有効にします。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/capabilities.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=377d128f77dee49749200261eee7a2c3" alt="Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル の切り替えが表示されたエージェントビルダーパネルの Capabilities セクション" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.png" />

    パネル下部の **Add Tools** ボタンから開く **Tools** — [画像生成](/ja/products/cloud/features/ai-ml/agents/builder/image-generation)、[ビジョン](/ja/products/cloud/features/ai-ml/agents/builder/vision)、検索 API、外部サービスなどのサードパーティのインテグレーションです。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/tools-button.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=4b18f52a2aa9663c09cc719e6bdffffb" alt="Add Tools ボタンが強調表示されたエージェントビルダーパネル下部" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.png" />

    **Add Tools** をクリックしてカタログを参照します。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/tools-modal.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=80cb90aa3290765aeb07f2f9b7420c80" alt="Google、OpenAI Image Tools、Wolfram、DALL-E-3、Tavily Search、Calculator、Stable Diffusion などのサードパーティインテグレーションがグリッド表示された Agent Tools モーダル" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.png" />

    [サブエージェント](/ja/products/cloud/features/ai-ml/agents/builder/subagents) は **Advanced settings** で設定します。詳細はサブエージェントのページを参照してください。

    追加した機能やツールはいつでも変更できます。
  </Step>

  <Step>
    ### クエリを実行する

    エージェントを保存し、新しい会話を開いて、エージェントピッカーから対象のエージェントを選択します。たとえば *"What are my top 10 tables by row count this week?"* のような質問を入力すると、エージェントが手順を計画し、必要に応じてツールを呼び出して、回答を返します。

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/chat-query.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=d55ce37870027c47d6f71d90585cd09e" alt="「What are my top 10 tables by row count this week?」という質問と、それに対するエージェントの応答を示すチャット。行数でサービス全体の上位 10 テーブルを順位付けした Markdown テーブルと、その下に Key Observations が表示されている" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.png" />
  </Step>
</Steps>

<div id="next-steps">
  ## 次のステップ
</div>

* [エージェントを共有](/ja/products/cloud/features/ai-ml/agents/sharing-and-access)し、チームメイトが利用できるようにします。
* エージェントが安定版になったら、[マーケットプレイス](/ja/products/cloud/features/ai-ml/agents/marketplace)で公開します。