在 ClickHouse Cloud 中使用 ClickHouse Assistant 聊天

在 ClickHouse Cloud 控制台中启用和使用 AI Chat 功能的指南

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

1. ​

   前置条件

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

   打开 AI Chat 面板

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

   接受数据使用同意 (首次使用)

   1. 首次使用时，系统会弹出同意对话框，说明数据处理方式以及第三方 LLM 子处理方。
   2. 查看并接受后即可继续；如果拒绝，面板将不会打开。
4. ​

   选择聊天模式

   AI Chat 目前支持：

   • Agent：基于 schema 和元数据进行多步推理 (服务必须处于已唤醒状态) 。
   • 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 标签页中。
   • 在控制台中修改并执行。
10. ​

    停止或中断响应

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

    1. 点击“Stop”按钮 (仅在处理中可见) 。
    2. 该消息会被标记为已中断；你可以调整提示词后重新发送。
11. ​

    键盘快捷键

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