> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 在 ClickHouse Cloud 中使用 ClickHouse Assistant 聊天
> 在 ClickHouse Cloud 控制台中启用并使用 AI Chat 功能的指南
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
> 本指南介绍如何在 ClickHouse Cloud 控制台中启用并使用 AI Chat 功能。
1. 你必须有权访问已启用 AI 功能的 ClickHouse Cloud 组织 (如果无法使用，请联系你的组织管理员或支持团队) 。
1. 进入某个 ClickHouse Cloud 服务。
2. 在左侧边栏中，点击标有“ClickHouse Assistant”的闪光图标。
3. (快捷方式) 按 ⌘ + ' (macOS) 或 Ctrl + ' (Linux/Windows) 即可切换打开状态。
1. 首次使用时，系统会弹出同意对话框，说明数据处理方式以及第三方 LLM 子处理方。
2. 查看并接受后即可继续。如果你拒绝，面板将不会打开。
AI Chat 当前支持：
* **Agent**：基于 schema 和 metadata 进行多步推理 (服务必须处于唤醒状态) 。
* **Docs AI (Ask)**：专注于基于 ClickHouse 官方文档和最佳实践参考资料的问答。
使用弹出面板左下角的模式选择器进行切换。
1. 输入你的问题 (例如：“创建一个 materialized view，按用户聚合每日事件”) 。
2. 按 Enter 发送 (使用 Shift + Enter 换行) 。
3. 模型处理期间，你可以点击“Stop”中断。
在 Agent 模式下，你可能会看到可展开的中间“思考”或规划步骤。这些步骤可以帮助你了解助手是如何形成答案的。可根据需要折叠或展开。
点击“New Chat”按钮以清除上下文并开始新的会话。
1. 下方区域会列出你最近的聊天记录。
2. 选择之前的聊天以加载其中的消息。
3. 使用垃圾桶图标删除某个对话。
当助手返回 SQL 时：
* 检查其正确性。
* 点击“Open in editor”将查询加载到新的 SQL 选项卡中。
* 在 Console 中修改并执行。
如果响应耗时过长或开始偏离主题：
1. 点击“Stop”按钮 (处理期间可见) 。
2. 该消息会被标记为已中断；你可以完善提示词后重新发送。
| 操作 | 快捷键 |
| ---------- | -------------------- |
| 打开 AI Chat | `⌘ + '` / `Ctrl + '` |
| 发送消息 | `Enter` |
| 换行 | `Shift + Enter` |