04 ClickHouse Agents
模块 04 的讲师笔记，时间安排、讲解要点、常见故障与重置步骤。
macOS terminal: Run workshop commands in Terminal using zsh or bash.
学员课程 04 ClickHouse Agents 的讲师配套材料。
时间安排
约 10 分钟。节奏抓紧；这是探索环节，而且效果立竿见影。
讲解要点
- 把它定位成对话式 BI：用英文提问，得到有依据的 SQL 和答案。
- 说明它由 Claude 驱动且处于 beta 阶段，所以结果会有波动。
- 准备好一个足够有说服力的示例问题用于投影演示。
- TODO：扩充。
常见故障
- 入口（服务侧边栏 -> ClickHouse agents -> Launch，或 ai.clickhouse.cloud）： beta 版 UI 可能会变，所以当天要确认路径。
- Agent 看不到 taxi 相关的表，因为服务/数据库没有连接上。
- 2026-07 的净室预演覆盖了本模块；已验证的故障模式、时间数据和需人工确认的步骤都在 2026-07 的净室预演中得到确认。
重置步骤
- 重新创建 agent，并把它重新连接到服务和表。
- TODO：确认重置命令。