クイックスタート
Beta feature. Learn more.
Cloudコンソールでカスタム エージェントを作成し、サービスに対して自然言語クエリを実行します。
前提条件
- クエリ可能な ClickHouse Cloud サービス。
- Agent Builder の Create agent オプション。表示されない場合は、sharing and access に記載のとおり、組織の管理者に依頼して、Admin Settings からエージェント作成権限を付与してもらってください。
エージェントを作成する
ClickHouse Agents を起動する
Cloud サービスの左側のサイドバーで ClickHouse agents をクリックし、エージェントのランチパッドを開きます。Launch ClickHouse agents をクリックして、エージェントビルダーを開きます。
エージェントを作成する
エージェントビルダーで、左側パネル上部の Create New Agent をクリックします。次に、基本フィールドを入力します。
- Name - エージェントの短い識別名。
- Description - エージェントの用途の説明。チームメンバーにも表示されます。
- Category - エージェントのカテゴリ。組織でカスタムカテゴリを使っていない場合は、
Generalのままで構いません。 - Instructions - システムプロンプト。エージェントの役割、答えるべき質問、従う必要があるビジネスルールを記述します。
- Model - ドロップダウンからモデルを選択します。
機能とツールを追加する
エージェントの機能とツールは、2 か所で設定します。
メインパネルの Capabilities — Run Code、ウェブ検索、File Context、Artifacts、MCPサーバー、スキル などのファーストパーティ機能です。エージェントに必要なものをオンにします。
パネル下部の Add Tools ボタンから開く Tools — image generation、ビジョン、検索 API、外部サービスなどのサードパーティ統合です。
Add Tools をクリックして、カタログを参照します。
サブエージェント は Advanced settings で設定します。詳細はサブエージェントのページを参照してください。
追加した機能とツールはいつでも変更できます。
クエリを実行する
エージェントを保存し、新しい会話を開いて、エージェントピッカーから対象のエージェントを選択します。たとえば "What are my top 10 tables by row count this week?" と質問すると、エージェントが計画を立て、必要に応じてツールを呼び出し、回答を返します。
次のステップ
- エージェントをチームメイトと共有します。
- エージェントが安定版になったら、マーケットプレイスに公開します。
