> ## 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 を構築して実行する

[ベータ機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## 前提条件

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

## エージェントを構築する

**1. ClickHouse Agents を起動する**

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

![ClickHouse agents（ベータ）が選択された Cloud サービスのナビゲーションと、Launch ClickHouse agents ボタンが表示されたランチパッド](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/launch-ch-agents.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7b76b7220ae2e5848fefb70d25e6401c)

**2. エージェントを作成する**

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

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

![Create New Agent ドロップダウン、フォームフィールド（Name、Description、Category、Instructions、Model）、および Capabilities セクションが表示されたエージェントビルダーパネル](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/agent-builder.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b18a3db920e9ec695938613037a72578)

**3. 機能とツールを追加する**

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

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

![Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル の切り替えが表示されたエージェントビルダーパネルの Capabilities セクション](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

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

![Add Tools ボタンが強調表示されたエージェントビルダーパネル下部](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

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

![Google、OpenAI Image Tools、Wolfram、DALL-E-3、Tavily Search、Calculator、Stable Diffusion などのサードパーティインテグレーションがグリッド表示された Agent Tools モーダル](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=31187ed13e978de4ad88020c060ab2d5)

[サブエージェント](https://clickhouse.com/docs/ja/agents/builder/subagents.md) は **Advanced settings** で設定します。詳細はサブエージェントのページを参照してください。

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

**4. クエリを実行する**

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

![「What are my top 10 tables by row count this week?」という質問と、それに対するエージェントの応答を示すチャット。行数でサービス全体の上位 10 テーブルを順位付けした Markdown テーブルと、その下に Key Observations が表示されている](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## 次のステップ

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