跳到主要内容
跳到主要内容

在 ClickHouse Cloud 中使用 Ask AI 聊天功能

本指南说明如何在 ClickHouse Cloud 控制台中启用并使用 AI Chat 功能。

前提条件​

  1. 你必须能访问已启用 AI 功能的 ClickHouse Cloud 组织（如果不可用，请联系你的组织管理员或支持人员）。

打开 AI Chat 面板​

  1. 进入某个 ClickHouse Cloud 服务。
  2. 在左侧边栏中点击标有 “Ask AI” 的闪光图标。
  3. （快捷键）按下 ⌘ + '（macOS）或 Ctrl + '（Linux/Windows）以打开或关闭面板。
打开 AI Chat 抽屉
  1. 第一次使用时，会弹出一个同意对话框，说明数据处理方式以及第三方 LLM 子处理器。
  2. 查看并接受以继续。如果你拒绝，该面板将不会打开。
同意对话框

选择聊天模式​

AI Chat 当前支持：

  • Agent：基于 schema 与元数据的多步推理（服务必须处于运行状态）。
  • Docs AI (Ask)：基于官方 ClickHouse 文档和最佳实践参考的聚焦问答。

在抽屉左下角使用模式选择器进行切换。

模式选择

编写并发送消息​

  1. 输入你的问题（例如 “Create a materialized view to aggregate daily events by user”）。
  2. 按下 Enter 发送（使用 Shift + Enter 换行）。
  3. 当模型正在处理时，你可以点击 “Stop” 以中断。

理解 “Agent” 思考步骤​

在 Agent 模式下，你可能会看到可展开的中间“思考”或规划步骤。这些步骤用于透明展示助手如何形成答案。根据需要进行折叠或展开。

思考步骤

开始新的聊天​

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

查看聊天历史​

  1. 下方区域会列出你最近的聊天。
  2. 选择某个先前的聊天以加载其消息。
  3. 使用垃圾桶图标删除某个会话。
聊天历史列表

使用生成的 SQL​

当助手返回 SQL 时：

  • 检查其正确性。
  • 点击 “Open in editor” 将该查询加载到一个新的 SQL 选项卡中。
  • 在控制台中修改并执行。
结果操作
在编辑器中打开生成的查询

停止或中断响应​

如果响应耗时过长或开始偏离主题：

  1. 点击 “Stop” 按钮（处理时可见）。
  2. 该消息会被标记为已中断；你可以调整提示内容后重新发送。

键盘快捷键​

操作快捷键
打开 AI Chat⌘ + ' / Ctrl + '
发送消息Enter
换行Shift + Enter