メインコンテンツへスキップ
Cloud Consoleでカスタムエージェントを作成し、サービスに対して自然言語クエリを実行します。

前提条件

  • クエリ可能な ClickHouse Cloud サービス。
  • エージェントビルダーの Create agent オプション。表示されない場合は、共有とアクセス に記載されている手順に従って、組織の Admin に依頼し、Admin Settings でエージェント作成を許可してもらってください。

エージェントを構築する

1

ClickHouse Agents を起動する

Cloud サービスで、左側のサイドバーにある ClickHouse agents をクリックして、エージェントのランチパッドを開きます。次に Launch ClickHouse agents をクリックして、エージェントビルダーを開きます。
ClickHouse agents(ベータ)が選択された Cloud サービスのナビゲーションと、Launch ClickHouse agents ボタンが表示されたランチパッド
2

エージェントを作成する

エージェントビルダーで、左側パネル上部の Create New Agent をクリックします。次の主要フィールドを入力します。
  • Name - エージェントの短い識別名です。
  • Description - エージェントの用途を説明する文です。チームメンバーにも表示されます。
  • Category - エージェントのカテゴリです。組織でカスタムカテゴリを使っていない場合は、General のままで構いません。
  • Instructions - システムプロンプトです。エージェントの役割、回答すべき質問、従うべき業務ルールを記述します。
  • Model - ドロップダウンからモデルを選択します。
Create New Agent ドロップダウン、フォームフィールド(Name、Description、Category、Instructions、Model)、および Capabilities セクションが表示されたエージェントビルダーパネル
3

機能とツールを追加する

エージェントの機能とツールは 2 か所で設定します。メインパネルの Capabilities — Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル などのファーストパーティ機能です。エージェントに必要なものを有効にします。
Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル の切り替えが表示されたエージェントビルダーパネルの Capabilities セクション
パネル下部の Add Tools ボタンから開く Tools — 画像生成、ビジョン、検索 API、外部サービスなどのサードパーティのインテグレーションです。
Add Tools ボタンが強調表示されたエージェントビルダーパネル下部
Add Tools をクリックしてカタログを参照します。
Google、OpenAI Image Tools、Wolfram、DALL-E-3、Tavily Search、Calculator、Stable Diffusion などのサードパーティインテグレーションがグリッド表示された Agent Tools モーダル
サブエージェント は 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 が表示されている

次のステップ