Codatum AI Agent 保留了代码审阅和回滚

你是 LLM 吗？你可以在 /features/ai-agent/overview.md 阅读此页面的更优化文档（Markdown 格式）

AI 代理 测试版 可选功能 ​

AI 代理接收自然语言指令，自主执行数据分析以及笔记本的创建和编辑。它可以在运行 SQL、检查结果和创建图表时引用目录和笔记本内容。

它使用的模型、权限和固定上下文通过“AI 配置文件”进行管理。有关自动加载的上下文准备，请参阅“代理上下文”。

如果你正在使用旧的 AI 助手，请参阅“AI 助手”。

信息

此功能处于测试版。规范可能会更改，恕不另行通知。

提示

这是一个可选功能。根据你的合同，它可能不可用。

主要功能 ​

• 向 LLM 发送数据：数据如何处理以用于训练，以及可能向 LLM 发送哪些信息。
• 启用它：在工作区设置中的“AI 功能设置”下启用 AI 代理。
• 显示模式：侧面板 / 全页。
• 画布：列出、查看、共享和下载由 AI 代理创建的页面。
• 操作模式：询问（分析）/ 代理（包括创建和编辑）。
• 指定上下文：使用“@”指定表、笔记本、保存的查询等。
• 代理上下文：.agent文件夹或页面，以及来自 AI 配置文件的上下文。
• 消息队列：在一次运行进行时将消息排队、编辑或提前发送。
• 计划与待办事项：查看当前会话的计划和待办事项。
• 对话历史摘要：总结长时间对话历史。
• 记忆：跨会话记住你的偏好和反馈。
• 设置：用户偏好、自动批准 SQL、自动加载上下文和记忆。
• AI 配置文件：管理使用的模型、权限和固定上下文。
• 代理使用情况：检查会话和令牌使用情况。
• 代理连接器：与外部工具（MCP / API）的集成。

向 LLM 发送数据 ​

仅使用合同上保证你的输入数据不会用于训练的外部 LLM 服务。如果你想使用自己的 API 密钥，可以在“自定义”下的“AI 配置文件”中进行配置。有关详细信息，请参阅“AI 功能政策”。

当 AI 代理分析和处理数据时，它可能会将表数据、SQL 执行结果等信息发送到 LLM 服务。使用此功能前，请检查你组织的 AI 使用政策。

启用它 ​

启用 AI 功能需要工作区所有者权限。

1. 打开“全局导航” > “工作区设置” > “AI 功能设置”。
2. 使用屏幕顶部的开关打开 AI 功能总体开关。
3. 在“AI 代理”下打开“可用的 AI 功能”。

你也可以在同一屏幕上单独启用以下功能。

打开它 ​

你可以通过以下任何方式打开它。

1. 打开“全局导航” > “AI 代理”（全页）。
2. 打开屏幕右下角的“AI 代理”图标（侧面板）。
3. 使用“AI 助手”快捷键打开侧面板（默认 ⌘+L / Ctrl+L；请参阅“键盘快捷键”）。
4. 从笔记本中的 SQL 块选择“在 AI 代理中提及”。

如果未启用，则显示“AI 代理已禁用”，并且你可以从“管理设置”进入启用屏幕。

显示模式 ​

画布 ​

AI 代理可以将分析结果和其他内容呈现为 HTML 画布。每个画布在创建时获得自己的 URL，并在其原始会话结束后保持可用。

你可以从聊天中打开画布预览。在预览中，你可以从菜单中选择“在新标签页中打开”以在其专用页面上查看显示的版本。所有者可以切换版本，切换版本也会将页面 URL 更新为该版本。

没有版本的 URL 将打开最新版本。如果你只能查看共享版本，例如查看者或使用公共链接的人，则显示该版本，并从 URL 中删除版本。所有者可以从“共享”更改共享设置。

在 AI 代理的全页中，预览出现在聊天旁边。

画布 ​

打开全页上的“画布”从左侧边栏查看你可以访问的画布卡片。每张卡片显示缩略图、名称、描述、共享状态和上次更新时间。前 20 个先显示。选择“加载更多”加载下一页。

使用顶部的标签更改显示的画布。

卡片上的共享状态为“公共”、“所有者”或“共享”。选择你拥有的且创建会话仍然存在的卡片将打开全页聊天和预览。其他卡片打开专用 URL 页面。

当“全部”或“我创建的”没有画布时，你可以从“创建画布”开始新会话。输入字段已预填创建画布的请求。当“共享”没有画布时，显示“无共享内容”。

从聊天中的画布、预览和专用 URL 页面，你可以从“下载 HTML”或“下载 PDF”从“下载”保存内容。PDF 使用 A4 纵向，查看公共链接的人无需登录即可下载。

从“共享 > 复制链接”获取专用 URL。打开该 URL 将显示仅包含画布的页面。如果画布与“任何拥有链接的人”共享，人们无需登录即可查看。打开受限画布将显示登录路径，登录后返回同一 URL。

如果您已登录且可以使用工作区，左上角的徽标将带您进入工作区首页。在AI代理可用的工作区中，工作区查看者及以上角色可以看到AI代理启动器，工作区访客则看不到。

当您从Canvas页面打开AI代理时，它会将显示的Canvas作为上下文。所有者可以要求代理读取或编辑Canvas，而查看者只能要求其读取Canvas，不能编辑。

所有者还可以在此页面更改共享设置并切换版本。如果此页面上打开的AI代理会话创建了新版本，页面将切换到最新版本并从URL中移除版本号。如果代理未打开或打开了其他会话，则不会切换。

如果您需要设置多重身份验证，Canvas页面会显示设置路径，无论Canvas是否为公开状态。如果临时问题导致工作区无法加载，您可以通过同一URL重试。

共享设置 ​

所有者可以在共享下更改这些设置。

编辑Canvas不会自动推进固定的共享版本。要共享更新的内容，请将共享版本更改为较新版本。当除您之外的其他人可以查看Canvas时，版本切换器会将其看到的版本标记为共享。如果选择了最新，则当前最新版本会获得该标签。

操作模式 ​

您可以在聊天输入框的左下角在提问和代理之间切换。

没有笔记本编辑权限的用户不能选择代理，只能使用提问。

指定上下文 ​

在聊天输入框中，使用@来指定您希望AI代理引用的内容。

聊天界面操作 ​

在完整页面上，您可以从左侧边栏执行以下操作。在侧边面板中，您可以从标题栏执行它们。

在聊天输入框中，除了操作模式之外，您还可以更改以下设置。

• 要首选的连接（默认是自动，让代理选择）
• 设置（参见设置）
• AI档案
• 语言

消息队列 ​

如果您在显示思考中...或正在运行时发送消息，输入框上方会出现一个等待列表，标题为排队消息。当前运行完成后，排队消息将按顺序从第一条开始处理。当输入框中有文本时，发送按钮显示为加入队列。

计划与待办事项 ​

您可以查看AI代理在会话中创建的工作计划（计划）和待办事项列表（待办事项）。当聊天输入框附近显示计划与待办事项按钮时，打开它。

显示内容 ​

对话历史摘要 ​

在输入框中输入/并选择总结对话历史以总结当前会话中的对话历史。

摘要运行时，您可以继续向队列添加新消息。选择停止生成回复以停止摘要。

记忆 ​

AI代理会将在对话中您分享的偏好和反馈保存为记忆，并在以后的会话中引用。记忆以主题形式存储，每个主题都有名称、描述和内容。记忆按用户和工作区存储。

您可以通过聊天输入框中的设置的记忆部分下的启用记忆来开启或关闭它（默认开启）。关闭时，AI代理既不引用也不保存记忆，但现有主题不会被删除。

在记忆开启时，聊天输入框中的上下文使用情况会显示一个记忆行，其中包含主题数量。

管理记忆 ​

1. 打开聊天输入框中的设置，然后选择记忆部分中的管理记忆。
2. 从主题列表中选择要编辑的主题。
3. 编辑描述或内容。当字段失去焦点时，更改会保存。
4. 要删除主题，请选择删除，然后在确认对话框中选择删除。

两者描述和内容均为必填项。任一项为空，更改不会保存，下次显示主题时会恢复已保存的内容。无法重命名主题。已删除的主题无法恢复。

设置 ​

您可以通过聊天输入框中的设置更改这些设置。设置分为以下几部分。

权限 ​

AI代理的操作在用户的权限范围内执行。它可以探索的笔记本和可以使用的连接也仅限于用户可访问的内容。

您可以在工具权限下的AI配置文件中配置额外限制（笔记本、连接、连接器、网络搜索/抓取）。

如果您想确认每次SQL执行，请关闭运行SQL下的自动批准工具执行中的设置。