ClickHouse Cloud の ClickHouse Assistant

1. AI 機能が有効化された ClickHouse Cloud の組織にアクセスできる必要があります (利用できない場合は、組織の管理者またはサポートにお問い合わせください) 。

1. ClickHouse Cloud サービスに移動します。
2. 左側のサイドバーで、「ClickHouse Assistant」と表示されたスパークルアイコンをクリックします。
3. (ショートカット) ⌘ + ' (macOS) または Ctrl + ' (Linux/Windows) を押すと、開閉を切り替えられます。

1. 初回利用時には、データの取り扱いとサードパーティの LLM サブプロセッサについて説明する同意ダイアログが表示されます。
2. 内容を確認して同意すると続行できます。拒否した場合、パネルは開きません。

AI Chat は現在、次のモードをサポートしています。

• Agent: スキーマとメタデータに基づいて複数ステップの推論を行います (サービスが起動中である必要があります) 。
• Docs AI (Ask): 公式の ClickHouse ドキュメントとベストプラクティス資料に基づく、ドキュメント中心の Q&A です。

切り替えるには、フライアウト左下のモードセレクタを使用します。

1. 質問を入力します (例: 「ユーザーごとの日次イベントを集計する materialized view を作成して」) 。
2. 送信するには Enter を押します (改行するには Shift + Enter を使用します) 。
3. モデルの処理中は、「Stop」をクリックして中断できます。

Agent モードでは、展開可能な中間の「thinking」ステップや計画ステップが表示されることがあります。これにより、アシスタントがどのように回答を組み立てているかを把握できます。必要に応じて折りたたみまたは展開してください。

「New Chat」ボタンをクリックすると、コンテキストがクリアされ、新しいセッションを開始できます。

1. 下部のセクションに最近のチャットが一覧表示されます。
2. 以前のチャットを選択すると、そのメッセージを読み込めます。
3. ゴミ箱アイコンを使用して会話を削除します。

アシスタントが SQL を返したら、次を行います。

• 内容が正しいか確認します。
• 「Open in editor」をクリックして、クエリを新しい SQL タブに読み込みます。
• Console 内で修正して実行します。

応答に時間がかかりすぎている場合や、意図した内容から外れている場合:

1. 「Stop」ボタンをクリックします (処理中に表示されます) 。
2. メッセージは中断済みとしてマークされます。プロンプトを調整して再送信できます。