クイックスタート

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

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

​

前提条件

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

​

エージェントを構築する

1. ​

   ClickHouse Agents を起動する

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

2. ​

   エージェントを作成する

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

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

   機能とツールを追加する

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

   メインパネルの Capabilities — Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル などのファーストパーティ機能です。エージェントに必要なものを有効にします。

   パネル下部の Add Tools ボタンから開く Tools — 画像生成、ビジョン、検索 API、外部サービスなどのサードパーティのインテグレーションです。

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

   サブエージェント は Advanced settings で設定します。詳細はサブエージェントのページを参照してください。

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

4. ​

   クエリを実行する

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

​

次のステップ

• エージェントを共有し、チームメイトが利用できるようにします。
• エージェントが安定版になったら、マーケットプレイスで公開します。