04 ClickHouse Agents
モジュール 04 のインストラクターノート — タイミング、トークトラック、よくある失敗、リセット手順。
macOS terminal: Run workshop commands in Terminal using zsh or bash.
学習者向けレッスン 04 ClickHouse Agents に対応するファシリテーター用の手引きです。
タイミング
約10分。テンポよく進めること。ここは探索であり、成果はすぐに現れる。
トークトラック
- 会話型 BI として位置づける: 英語で尋ねれば、根拠のある SQL と答えが返ってくる。
- Claude を基盤としたベータ版であるため、結果にばらつきがある点に触れる。
- プロジェクター用に、よい例となる質問を1つ用意しておく。
- TODO: 拡充する。
よくある失敗
- エントリーポイント（サービスのサイドバー -> ClickHouse agents -> Launch、または ai.clickhouse.cloud）: ベータの UI は変わる可能性があるため、当日に経路を確認する。
- サービス／データベースが接続されていないため、エージェントがタクシーのテーブルを認識できない。
- 2026-07 のクリーンルームでのドライランはこのモジュールを対象に含んでいた。検証済みの失敗モード、タイミング、人による確認が必要な手順は 2026-07 のクリーンルームでのドライランで確認済み。
リセット手順
- エージェントを作り直し、サービスとテーブルに再接続する。
- TODO: リセットコマンドを確定する。