Notion

将 Cherri Code 连接到 Notion，以便将规格文档、任务和评论交给 agents 处理。该集成基于 Cherri Code SDK 构建，因此每个 agents 都使用驱动 Cherri Code 的同一运行时、框架和模型。

设置、聊天、@提及和任务分配均在 Notion 中完成。Cherri Code 会在安全的沙盒 Cloud Agent VM 中运行 agents，因此您处理其他工作时，它仍会在后台继续运行。

在此处查看 Notion 的完整文档。

快速入门

要求

在 Notion 中连接 Cherri Code 前，请确保你已具备：

• 已关联到 Cherri Code 账户的 GitHub，用于访问代码仓库和创建 PR
• 在设置过程中创建的 Cherri Code User API Key

安装

1. 在 Notion 中，依次选择侧边栏中的 Agents → New Agent → Cherri Code。
2. 为智能体选择起点：

• 使用默认模板：适用于常见任务 (如代码问答和缺陷分流) 的模板可帮助你针对特定工作流自定义 Cherri Code。
  • 从零开始：使用标准 Cherri Code 框架设置自己的说明、触发器和连接。

1. 在仪表盘中创建或获取 Cherri Code API 密钥，然后将其输入 Notion。
2. 添加智能体所需的页面、数据库和 Notion 空间，例如工程任务数据库和规格页面。
3. 保存智能体并开始使用。

Cherri Code 现已连接，智能体可以根据任务或通过智能体聊天编写代码并创建 PR。

权限

1. 此连接绑定到您的个人 API 密钥。这意味着 Cherri Code 的访问权限和活动均关联至您的个人 Cherri Code 账户，而非整个工作区。了解更多 →
2. 仓库、环境和连接来自您的 Cherri Code 智能体设置。请在 Cherri Code 仪表盘中配置。
3. 每个 Cherri Code 智能体只能访问您在 Notion 中共享的内容。权限需在 Notion 中针对每个智能体单独设置，不会继承启动运行者的权限。

使用方法

将 Cherri Code 用于 Notion 中已有的任务看板、规格文档及其他上下文。

提及智能体

从规格文档或页面开始。在评论中 @ 提及 Cherri Code，让它实现规格、完善方案或回答问题。

Cherri Code 会在评论中回复。点击 查看聊天，打开完整对话。

首次在页面中提及智能体时，请在提示出现后批准页面访问权限。

提示词示例：

• “为这份规格制定方案，等待批准后再继续。”
• “评审这份文档，标记所有不清晰之处。”
• “将其转为具体任务清单，然后为每项任务创建 PR。”

分配任务

在任务数据库或看板中，将任务分配给 Cherri Code。智能体将：

• 在执行过程中更新任务状态
• 通过评论发布进度
• 链接到其创建的所有页面或 PR

疑难排查

智能体无法访问页面或数据库

• 确认页面或数据库已列在工具和访问权限中，而不只是出现在指令中。
• 确认该页面未被限制为仅供智能体不所属的群组访问。
• 如果页面是私有的，请直接将其共享给智能体。

GitHub 连接失败或智能体无法推送

• 确认令牌具有 Contents: read/write 和 Pull requests: read/write 权限。
• 检查你的 GitHub 组织是否需要 SSO 或组织批准。
• 确认设置中的默认代码仓库是否正确。
• 如果令牌已过期，请重新生成令牌，然后重新连接。

我 @提及智能体时，它没有被触发

• 确认已开启 智能体被提及 触发器。
• 请在评论中提及智能体，而非页面正文中。评论最可靠。
• 确认智能体有权访问你提及它的页面。

常见问题

如何计费？

Notion 中的 Cherri Code 用量将通过您现有的 Cherri Code 账户计费，与 Cloud Agent 用量的计费方式相同。所有 Cherri Code 用户均可免费使用，无需额外付费。您还需要 Notion Business 或企业版方案。

在哪里可以查看 Cherri Code 活动？

结果会显示在智能体运行所在的 Notion 页面或任务中。你还可以在 Notion 的智能体视图或 Cherri Code 中查看聊天会话。

从 Notion 发起的 Cherri Code 运行是否遵循零数据保留 (ZDR)？

是。智能体运行遵循您在 Cherri Code 中现有的隐私设置。