このガイドでは、ClickHouse Cloud Console で AI Chat 機能を有効にし、使用する方法を説明します。
1
前提条件
- AI 機能が有効になっている ClickHouse Cloud 組織へのアクセス権が必要です (利用できない場合は、組織の管理者またはサポートにお問い合わせください) 。
2
AI Chat パネルを開く
- ClickHouse Cloud サービスに移動します。
- 左側のサイドバーで、「ClickHouse Assistant」と表示されたスパークルアイコンをクリックします。
- (ショートカット) ⌘ + ’ (macOS) または Ctrl + ’ (Linux/Windows) を押すと、開閉を切り替えられます。
3
データ利用への同意を承認する (初回実行時)
- 初回利用時には、データの取り扱いとサードパーティの LLM サブプロセッサに関する説明を含む同意ダイアログが表示されます。
- 内容を確認して同意すると、先に進めます。同意しない場合、パネルは開きません。
4
チャットモードを選択する
AI Chat は現在、以下をサポートしています。- Agent: スキーマとメタデータに基づく多段階の推論 (サービスが起動中である必要があります) 。
- Docs AI (Ask): 公式 ClickHouse ドキュメントとベストプラクティスのリファレンスに基づく、特化型の Q&A。
5
メッセージを作成して送信する
- 質問を入力します (例: 「ユーザーごとの日次イベントを集計する materialized view を作成して」) 。
- Enter を押して送信します (改行するには Shift + Enter を使用します) 。
- モデルが処理中の間は、「Stop」をクリックして中断できます。
6
「Agent」の thinking ステップを理解する
Agent モードでは、展開可能な中間の「thinking」または計画ステップが表示されることがあります。これにより、アシスタントがどのように回答を組み立てているかを把握できます。必要に応じて折りたたんだり展開したりしてください。7
新しいチャットを開始する
「New Chat」ボタンをクリックすると、コンテキストがクリアされ、新しいセッションを開始できます。8
チャット履歴を表示する
- 下部のセクションに最近のチャットが一覧表示されます。
- 以前のチャットを選択すると、そのメッセージを読み込めます。
- ゴミ箱アイコンを使って会話を削除します。
9
生成された SQL を操作する
アシスタントが SQL を返した場合:- 正しいことを確認します。
- 「Open in editor」をクリックして、クエリを新しい SQL タブに読み込みます。
- Console 内で修正して実行します。
10
応答を停止または中断する
応答に時間がかかりすぎる場合や、内容が逸れている場合:- 「Stop」ボタンをクリックします (処理中に表示されます) 。
- メッセージは中断済みとしてマークされ、プロンプトを調整して再送信できます。
11