> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

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>ベータ</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ベータ機能です。 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        詳しくはこちら。
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

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

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

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

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

<Steps>
  <Step title="ClickHouse Agents を起動する" id="launch-agents">
    Cloud サービスで、左側のサイドバーにある **ClickHouse agents** をクリックして、エージェントのランチパッドを開きます。次に **Launch ClickHouse agents** をクリックして、エージェントビルダーを開きます。

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

  <Step title="エージェントを作成する" id="create-the-agent">
    エージェントビルダーで、左側パネル上部の **Create New Agent** をクリックします。次の主要フィールドを入力します。

    * **Name** - エージェントの短い識別名です。
    * **Description** - エージェントの用途を説明する文です。チームメンバーにも表示されます。
    * **Category** - エージェントのカテゴリです。組織でカスタムカテゴリを使っていない場合は、`General` のままで構いません。
    * **Instructions** - システムプロンプトです。エージェントの役割、回答すべき質問、従うべき業務ルールを記述します。
    * **Model** - ドロップダウンからモデルを選択します。

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

  <Step title="機能とツールを追加する" id="attach-tools">
    エージェントの機能とツールは 2 か所で設定します。

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

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

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

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/tools-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e98e46712afcbb5aa6347c8b7446ffd2" 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.webp" />

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

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat-query.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=c3dcfe8f94d8348a1bae938cb8c04f3d" 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.webp" />
  </Step>
</Steps>

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

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