Skip to main content
本指南介绍如何在 ClickHouse Cloud 控制台中启用并使用 AI Chat 功能。
1

前置条件

  1. 你必须有权访问已启用 AI 功能的 ClickHouse Cloud 组织 (如果无法使用，请联系你的组织管理员或支持团队) 。
2

打开 AI Chat 面板

  1. 进入某个 ClickHouse Cloud 服务。
  2. 在左侧边栏中，点击标有“ClickHouse Assistant”的闪光图标。
  3. (快捷方式) 按 ⌘ + ’ (macOS) 或 Ctrl + ’ (Linux/Windows) 即可切换打开状态。
4

选择聊天模式

AI Chat 当前支持：
  • Agent：基于 schema 和 metadata 进行多步推理 (服务必须处于唤醒状态) 。
  • Docs AI (Ask)：专注于基于 ClickHouse 官方文档和最佳实践参考资料的问答。
使用弹出面板左下角的模式选择器进行切换。
5

编写并发送消息

  1. 输入你的问题 (例如：“创建一个 materialized view，按用户聚合每日事件”) 。
  2. 按 Enter 发送 (使用 Shift + Enter 换行) 。
  3. 模型处理期间，你可以点击“Stop”中断。
6

理解“Agent”的思考步骤

在 Agent 模式下，你可能会看到可展开的中间“思考”或规划步骤。这些步骤可以帮助你了解助手是如何形成答案的。可根据需要折叠或展开。
7

开始新的聊天

点击“New Chat”按钮以清除上下文并开始新的会话。
8

查看聊天历史

  1. 下方区域会列出你最近的聊天记录。
  2. 选择之前的聊天以加载其中的消息。
  3. 使用垃圾桶图标删除某个对话。
9

处理生成的 SQL

当助手返回 SQL 时：
  • 检查其正确性。
  • 点击“Open in editor”将查询加载到新的 SQL 选项卡中。
  • 在 Console 中修改并执行。
10

停止或中断响应

如果响应耗时过长或开始偏离主题：
  1. 点击“Stop”按钮 (处理期间可见) 。
  2. 该消息会被标记为已中断；你可以完善提示词后重新发送。
11

键盘快捷键

最后修改于 2026年7月23日