> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse Cloud の Assistant

> ClickHouse Cloud Console で Assistant について学び、有効化して使用する

Assistant を使用すると、自然言語で ClickHouse Cloud サービス内のデータを分析できます。アクティブなタブ、保存クエリ、スキーマ、ダッシュボードなどのコンテキストを使用して、クエリ、可視化、要約を生成できます。

Assistant には、ClickHouse ドキュメントに基づく質問に回答する Docs AI モードも含まれています。このガイドを使用して Assistant を有効にし、ClickHouse Cloud Console で両方のモードを利用してください。

**1. 前提条件**

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

**2. AI Chat パネルを開く**

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

![AI Chat のフライアウトを開く](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

**3. データ使用への同意を行う（初回利用時）**

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

![同意ダイアログ](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

**4. チャットモードを選択する**

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

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

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

![モード選択](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

**5. メッセージを作成して送信する**

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

**6. 「Agent」の Thinking ステップを理解する**

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

![Thinking ステップ](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**7. 新しいチャットを開始する**

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

**8. チャット履歴を表示する**

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

![チャット履歴の一覧](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

**9. 生成された SQL を操作する**

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

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

![結果の操作](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![生成されたクエリを editor で開く](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

**10. 応答を停止または中断する**

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

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

**11. キーボードショートカット**

| 操作 | ショートカット |
| - | - |
| AI Chat を開く | `⌘ + '` / `Ctrl + '` |
| メッセージを送信 | `Enter` |
| 改行 | `Shift + Enter` |
