ClickHouse Cloud で Ask AI チャットを使う
このガイドでは、ClickHouse Cloud Console で AI Chat 機能を有効化して利用する方法を説明します。
前提条件
- AI 機能が有効になっている ClickHouse Cloud 組織へのアクセス権が必要です（利用できない場合は組織の管理者かサポートに連絡してください）。
AI Chat パネルを開く
- 任意の ClickHouse Cloud サービスに移動します。
- 左側のサイドバーで「Ask AI」と表示されたスパークルアイコンをクリックします。
- （ショートカット）⌘ + '（macOS）または Ctrl + '（Linux/Windows）を押して開閉を切り替えます。
データ利用に関する同意を行う（初回）
- 初回利用時には、データの取り扱いとサードパーティ LLM サブプロセッサについて説明する同意ダイアログが表示されます。
- 内容を確認のうえ同意すると先に進めます。拒否した場合はパネルは開きません。
チャットモードを選択する
AI Chat は現在、以下をサポートしています：
- Agent: スキーマおよびメタデータに対するマルチステップ推論（対象サービスが起動している必要があります）。
- Docs AI (Ask): 公式 ClickHouse ドキュメントおよびベストプラクティスに基づいた Q&A。
フライアウト左下のモードセレクターでモードを切り替えます。
メッセージを作成して送信する
- 質問を入力します（例: 「ユーザーごとに日次イベントを集計する materialized view を作成して」）。
- Enter を押して送信します（改行する場合は Shift + Enter）。
- モデルが処理中は、「Stop」をクリックして中断できます。
「Agent」の思考ステップを理解する
Agent モードでは、展開可能な中間の「思考」や計画ステップが表示される場合があります。これにより、アシスタントがどのように回答を組み立てているかを確認できます。必要に応じて展開・折りたたみを行ってください。
新しいチャットを開始する
「New Chat」ボタンをクリックしてコンテキストをクリアし、新しいセッションを開始します。
生成された SQL を扱う
アシスタントが SQL を返した場合：
- 内容を確認し、正しさを検証します。
- 「Open in editor」をクリックして、そのクエリを新しい SQL タブに読み込みます。
- Console 内で修正し、実行します。
レスポンスを停止・中断する
レスポンスに時間がかかりすぎる、あるいは意図とずれてきた場合:
- 「Stop」ボタンをクリックします（処理中に表示されます）。
- メッセージには中断されたことがマークされます。プロンプトを改善して再送信できます。
キーボードショートカット
| 操作 | ショートカット |
|---|---|
| AI Chat を開く | ⌘ + ' / Ctrl + ' |
| メッセージを送信 | Enter |
| 改行 | Shift + Enter |
