メインコンテンツまでスキップ
メインコンテンツまでスキップ

ClickHouse CloudでのAIチャットの利用

このガイドでは、ClickHouse CloudコンソールでAIチャット機能を有効にし、使用する方法を説明します。

必要条件​

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

AIチャットパネルを開く​

  1. ClickHouse Cloudサービスに移動します。
  2. 左のサイドバーで、「Ask AI」と記されたスパークルアイコンをクリックします。
  3. （ショートカット） ⌘ + '（macOS）または Ctrl + '（Linux/Windows）を押して開閉します。
AIチャットフライアウトを開く
  1. 初回使用時に、データ処理とサードパーティのLLMサブプロセッサについて説明する同意ダイアログが表示されます。
  2. 内容を確認し、進むには受け入れます。拒否した場合、パネルは開きません。
同意ダイアログ

チャットモードを選択する​

AIチャットは現在次のモードをサポートしています：

  • エージェント: スキーマとメタデータに基づく複数ステップの推論（サービスは起動している必要があります）。
  • Docs AI（Ask）: 公式のClickHouseドキュメントやベストプラクティスリファレンスに基づいた質疑応答。

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

モード選択

メッセージを作成して送信する​

  1. 質問を入力します（例: “ユーザー別に日次イベントを集約するマテリアライズドビューを作成します”）。
  2. Enterを押して送信します（改行するには Shift + Enterを使用します）。
  3. モデルが処理している間に「停止」をクリックして中断できます。

「エージェント」の思考ステップを理解する​

エージェントモードでは、展開可能な中間の「思考」またはプランニングステップが表示されることがあります。これにより、アシスタントがどのように回答を形成するかが透明になります。必要に応じて折りたたむことができます。

思考ステップ

新しいチャットを開始する​

「新しいチャット」ボタンをクリックしてコンテキストをクリアし、新しいセッションを開始します。

チャット履歴を表示する​

  1. 下部セクションには最近のチャットがリストされています。
  2. 前のチャットを選択してメッセージを読み込むことができます。
  3. ゴミ箱アイコンを使用して会話を削除します。
チャット履歴リスト

生成されたSQLで作業する​

アシスタントがSQLを返した場合：

  • 正確性を確認します。
  • 「エディタで開く」をクリックして新しいSQLタブにクエリを読み込みます。
  • コンソール内で修正し、実行します。
結果アクション
エディタで生成されたクエリを開く

応答を停止または中断する​

応答が遅すぎるか、逸脱している場合：

  1. 「停止」ボタンをクリックします（処理中に表示されます）。
  2. メッセージは中断されたとマークされ、プロンプトを洗練して再送信できます。

キーボードショートカット​

アクションショートカット
AIチャットを開く⌘ + ' / Ctrl + '
メッセージを送信Enter
新しい行Shift + Enter