> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/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 组织 (如果无法使用，请联系组织管理员或支持团队) 。
## 打开 AI Chat 面板
1. 进入某个 ClickHouse Cloud 服务。
2. 在左侧边栏中，点击标有“ClickHouse Assistant”的闪光图标。
3. (快捷方式) 按 ⌘ + ' (macOS) 或 Ctrl + ' (Linux/Windows) 可切换打开或关闭。
## 接受数据使用同意 (首次使用)
1. 首次使用时，系统会弹出同意对话框，说明数据处理方式以及第三方 LLM 子处理方。
2. 查看并接受后即可继续；如果拒绝，面板将不会打开。
## 选择聊天模式
AI Chat 目前支持：
* **Agent**：基于 schema 和元数据进行多步推理 (服务必须处于已唤醒状态) 。
* **Docs AI (Ask)**：专注于基于 ClickHouse 官方文档和最佳实践参考资料的问答。
使用弹出面板左下角的模式选择器进行切换。
## 输入并发送消息
1. 输入你的问题 (例如：“创建一个 materialized view，按用户聚合每日事件”) 。
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` |