> ## 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でClickHouse Assistant chatを使用する

> ClickHouse Cloud ConsoleでAI Chat機能を有効化して使用するためのガイド

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> このガイドでは、ClickHouse Cloud Console で AI Chat 機能を有効にし、利用する方法を説明します。

<Steps>
  <Step title="前提条件" id="prerequisites">
    1. AI 機能が有効化された ClickHouse Cloud の組織にアクセスできる必要があります (利用できない場合は、組織の管理者またはサポートにお問い合わせください) 。
  </Step>

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=99adfce6ae6ec1ea4e895688ebcb96f2" alt="AI Chat のフライアウトを開く" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=54010396eff18df4fe545f4ad70f7b57" alt="同意ダイアログ" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step title="チャットモードを選択する" id="modes">
    AI Chat は現在、次のモードをサポートしています。

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=39a7ccc19b995812b0ad6115ccd8fa46" alt="モード選択" size="sm" width="584" height="262" data-path="images/use-cases/AI_ML/AIChat/3_modes.webp" />
  </Step>

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=0df1ca2235dcec9f8d0f49fa6271a892" alt="Thinking ステップ" size="md" width="1702" height="1180" data-path="images/use-cases/AI_ML/AIChat/4_thinking.webp" />
  </Step>

  <Step title="新しいチャットを開始する" id="new-chats">
    「New Chat」ボタンをクリックすると、コンテキストがクリアされ、新しいセッションを開始できます。
  </Step>

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=dea90fb7824b49a2fb5b6af0f71fa987" alt="チャット履歴の一覧" size="md" width="1754" height="634" data-path="images/use-cases/AI_ML/AIChat/5_history.webp" />
  </Step>

  <Step title="生成された SQL を操作する" id="sql-actions">
    アシスタントが SQL を返したら、次を行います。

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=409c86a0ec90d48221a6dfdffcb7945f" alt="結果の操作" size="md" width="1746" height="1362" data-path="images/use-cases/AI_ML/AIChat/6_result_actions.webp" />

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=ff40fb5f4aea3697dda1db999622d341" alt="生成されたクエリを editor で開く" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step title="応答を停止または中断する" id="interrupt">
    応答に時間がかかりすぎている場合や、意図した内容から外れている場合:

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

  <Step title="キーボードショートカット" id="shortcuts">
    | 操作          | ショートカット              |
    | ----------- | -------------------- |
    | AI Chat を開く | `⌘ + '` / `Ctrl + '` |
    | メッセージを送信    | `Enter`              |
    | 改行          | `Shift + Enter`      |
  </Step>
</Steps>
