跳转到主内容
跳转到主内容

在 ClickHouse Cloud 中使用 ClickHouse Assistant 聊天

本指南介绍如何在 ClickHouse Cloud 控制台中启用和使用 AI Chat 功能。

前提条件​

  1. 您必须有权访问已启用 AI 功能的 ClickHouse Cloud 组织 (如果没有，请联系组织管理员或支持) 。

打开 AI Chat 面板​

  1. 进入某个 ClickHouse Cloud 服务。
  2. 在左侧边栏中，点击标有 “ClickHouse Assistant” 的闪光图标。
  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