自定义代理

自定义代理可以为你的整个团队自动处理那些重复且需要手动完成的工作流程。它们会根据预设的触发器，利用你现有的文档和数据库作为上下文，在后台自动运行。

设置一次——为每周报告或反馈分类等重复性任务构建工作流程——它就会成为整个团队依赖的共享资源。

自定义代理驻留在 Notion 中，并根据你的指令运行。一旦设置完成，它们可以：

• 读取 Notion 页面、数据库以及某些已连接应用。

• 根据重复触发器和工作空间事件运行。

• 执行诸如发布报告、提交 bug、更新记录或发送消息等操作。

与 Notion 代理不同，自定义代理旨在根据触发器和日程在后台自动运行。

自定义代理直接内置于 Notion 中。代理使用你现有的文档和数据库作为上下文，并连接 Slack，从而提高工作效率。通过自定义代理，你可以：

• 在 Notion 页面、数据库属性和评论中 @提及 代理。

• 将它们附加到数据库事件（例如，当页面被创建或更新时）。

• 让它们根据你配置的触发器监控你的工作空间和已连接的工具。

使用触发器让自定义代理运行，无需你每次手动启动。设置一次触发器，工作就会在后台持续进行。

• 按日程运行（每日、每周、每月等）。

• 响应 Notion 和 Slack 中的事件。

• 发布后在后台持续运行。

这可以解锁自动化工作流程，例如定期报告、分类队列和知识维护，帮助你节省时间。

代理仅在你明确授予访问权限的页面、数据库和外部应用上执行操作。默认情况下，它们永远不会拥有完整的工作空间访问权限，从而降低风险。

• 控制谁可以编辑、运行或与每个代理交互。

• 查看活动日志以了解代理执行了什么操作以及执行时间。

• 使用版本历史记录来查看或恢复过去的配置。

• 保持运行可评价且可恢复，以便你可以安全地进行迭代。

自定义代理的关键配置和访问权限更改（如指令更新、权限更改和集成添加）都会记录在Notion 审计日志中。这有助于企业版管理员跟踪代理更改，以进行安全和合规性审查。

• 你必须使用 Notion 的商业方案或企业版方案。了解更多关于自定义代理价格的信息。

• 使用桌面端或网页端来构建、编辑、查看或与自定义代理交互。

你可以从多个位置构建自定义代理。主要入口是侧边栏中的代理部分。

1. 前往侧边栏中的代理部分，然后选择+以创建新的自定义代理。

2. 选择你想要开始的方式：

• 使用 AI 聊天创建

  • 在聊天中，使用自然语言描述你希望代理执行的操作。

  • 查看 Notion AI 生成的草稿指令、触发器和访问权限，并进行迭代。

  • 保存。

• 从模板创建

  • 选择模板。

  • 查看 Notion AI 生成的草稿指令、触发器和访问权限，并进行迭代。

  • 保存。

• 从头开始创建

  • 选择 创建空白。

  • 从空的指令字段开始，或与你聊天。

  • 手动编写你的指令，遵循清晰、具体指令的最佳实践。定义 Agent 应该执行什么任务、如何表现以及应处理哪些工作。

  • 设置触发器、访问权限和你的 AI 模型，直到它们符合你的工作流。

  • 保存。

触发器决定了你的 Agent 何时运行。你可以为一个 Agent 组合多种触发器类型。你还可以使用过滤器帮助你的 Agent 仅针对你关心的页面或消息运行，或者仅在满足你设置的特定条件（例如，特定状态或关键字）时运行。

使用周期性计划按节奏运行代理。

1. 打开你的自定义代理的 Settings。

2. 转到 触发器 部分。

3. 添加一个 周期性 触发器。

4. 选择你希望 Agent 运行的时间：

   • 选择频率（每天、每周、每月或每年）。

   • 设置特定时间，包括时区（例如，“每天午夜 PST”）。

5. 查看下一次计划运行时间，以确认计划是否正确。

6. 保存你的触发器。

Notion 触发器根据你工作空间中的事件运行你的代理。你可以在以下情况触发代理：

• 页面中添加了评论。

• 数据库中添加了页面。

• 数据库中的属性已更新。

• 数据库中删除了页面。

某些 Notion 触发器允许你添加筛选器，例如匹配特定的属性值或将运行限制为特定数据库视图中的页面。

要添加 Notion 触发器：

1. 打开自定义代理的 设置 并选择 触发器。

2. 选择一个 Notion 触发器类型。

3. 指定：

   • 要监视的页面或数据库。

   • 事件（例如，“在数据库中创建了页面”）。

   • 可选的筛选器或条件（例如，特定的状态值或数据库视图）。

4. 保存。

Slack 触发器允许代理监视公共和私人 Slack 频道中的事件。

设置要求

在设置 Slack 触发器之前，Slack 工作空间管理员必须先 将 Slack 连接到 Notion 工作空间。这会授予对所有公共频道的访问权限，并决定 Notion AI 是否可以访问私人频道。如果你想使用私人频道，还需要授权你的 Slack 帐号。

自定义代理可以监视：

• 发布到频道的消息。

• 添加到消息的表情符号回应。

• 消息中提及的自定义代理。

注意：若要通过在 Slack 中 @提及来触发代理，你的 Slack 工作空间管理员必须先允许所有成员创建用户组。启用此设置后，任何人都可以在关联的 Slack 频道中通过 @提及其名称来触发代理。

设置上述任何触发器时，你可以选择包含线程回复，这样代理不仅会响应顶级消息，还能响应线程中的回复。

您可以通过指定触发的关键字或短语来减少高流量群组中的干扰。

要添加 Slack 触发器：

1. 如果尚未连接，请在设置过程中将 Slack 连接到你的代理。

2. 在 触发器 中，添加一个 Slack 触发器。

3. 选择：

   • 事件类型。

   • 要监控的频道。

   • 可选过滤器（例如，仅在消息包含特定关键字或短语时触发）。

4. 保存。

每当自定义代理在 Slack 中被触发时，它可以显示“正在处理…”的提示，以表明正在处理请求，但这并不一定意味着代理会回复。你可以随时在触发器设置中关闭此功能。

要关闭正在输入指示器：

1. 转到你的自定义代理。

2. 在触发器中，选择 Slack 触发器。

3. 选择更多设置，然后取消勾选在 Slack 中显示正在输入指示器。

自定义代理仅使用你明确授权访问的内容来工作。你可以在每个代理的访问设置中进行配置。

要控制代理在 Notion 中可以看到的内容：

1. 打开你的自定义代理的 设置。

2. 前往 工具与访问权限 部分。

3. 添加代理应作为上下文使用的特定页面或数据库：

   • 为目标工作流添加重点页面和数据库（例如，“客户工单”、“错误”、“事件”）。

   • 如果你希望获得涵盖整个工作空间内容的广泛覆盖，请授予对 与 Notion 中所有人共享的页面 的访问权限。

4. 如果你希望范围更窄，请将访问权限限制为“无”或仅限一小部分页面。

代理可在需要时选择性地浏览网页；当你的工作流程依赖外部信息时，请使用网络访问权限，而对于严格的内部工作流程，或当你希望对信息源进行更严格的控制时，请将其关闭。要控制网络访问权限：

1. 打开你的代理的 设置。

2. 找到 网络访问权限切换按钮。

3. 将网络访问权限 开启，以允许代理从互联网检索信息。

4. 将网络访问权限 关闭，以限制代理仅能访问 Notion 和已配置的应用。

自定义代理可以通过专用集成读取和写入 Slack。

在将 Slack 连接到自定义代理之前，管理员必须先通过 Slack AI 连接器 将 Slack 工作空间连接到你的 Notion 工作空间。

连接后，自定义代理可以：

• 读取选定的公共和私人 Slack 频道。

• 仅向你选择的特定频道发布消息、回复和更新。

• 对线程做出反应，并使用来自 Slack 的信息作为上下文。

要授予自定义代理访问 Slack 的权限：

• 设置自定义代理时，请按照提示连接 Slack。

• 请确保 Slack 帐号使用与你的 Notion 帐号相同的（电子）邮件地址。

• 在 Slack 的授权流程中批准所请求的权限。

• 选择代理可以访问的频道。

如果你的组织使用 Slack Enterprise Grid，你也可以连接到自定义代理。

自定义代理可以运行在不同的大型语言模型上，这让你可以平衡速度、成本和质量。如果你的工作流程发生变化或有不同的性能需求，你可以随时调整模型。

支持的模型包括 Claude Fable 5（仅限商业和企业版）、Claude Sonnet 5、最新的 GPT 模型、Gemini 和 Grok。“自动”是推荐的默认设置。

Claude Fable 5 最适合进行深入研究、复杂写作以及涉及多个步骤的任务。在工作空间中的任何人使用它之前，管理员需要先将其开启。这是因为 Anthropic 处理该模型数据的方式与其他模型略有不同（见下文）。如果你需要访问权限，请让你的管理员在 设置 → Notion AI 中将其开启。

关于数据处理的说明：当你使用 Claude Fable 5 时，Anthropic 可能会在一段时间内存储你的提示词和响应，以确保模型的安全和稳定运行。Notion 中提供的其他 AI 模型并非如此，因此你的管理员需先进行审核并将其开启。

了解如何在 Notion 积分管理面板 中跟踪使用情况。

选择模型：

1. 打开你的代理的 设置。

2. 前往 模型 部分。

3. 如果你希望行为保持一致，请选择特定模型；或者选择“自动”，让 Notion 根据每次请求选择最佳模型。

4. 保存。

为你的工作空间开启 Claude Fable 5（仅限管理员）：

1. 前往 设置 → Notion AI。

2. 找到 Claude Fable 5 并将其开启。

Claude Fable 5 仅适用于商业版和企业版方案。开启后，工作空间中的任何人都可以从 Notion 代理或自定义代理设置的模型选择器中进行选择。

在与工作空间中其他人共享时，自定义代理的行为与 Notion 页面相似，但存在一些差异。

共享后，代理可以出现在侧边栏的“代理”部分、搜索结果中，以及任何列出或引用代理的工作空间区域中。

共享代理：

1. 打开你的自定义代理。

2. 点击共享。

3. 添加人员、群组或整个工作区。

代理使用简化的权限级别：

• 全部权限拥有代理全部权限的用户可以配置指令、触发器、访问权限和模型，查看并管理活动日志，以及运行或与代理交互。

• 允许编辑拥有代理允许编辑权限的用户可以修改指令和配置，并评价活动。

• 允许查看和交互拥有代理允许查看和交互权限的用户可以运行代理、与代理对话，并以只读模式查看“设置”页面（触发器、指令、工具和访问权限）。他们无法编辑或共享该代理。

自定义代理构建完成后，它将出现在侧边栏中。每个自定义代理页面都有三个核心选项卡。请结合使用这些选项卡来设计、测试和维护代理。

1. 聊天 针对该特定代理的私人或共享一对一对话区域。

   • 适用于测试新说明、要求代理运行一次性任务以及迭代行为。

2. 活动 拥有全部权限的用户可见的每个代理运行日志。

   • 日志包括触发运行的内容、采取的操作以及任何错误或故障。

3. 设置 代理的控制中心。

   • “设置”面板包括代理指令、触发器、访问权限和模型选择。

1. 打开代理页面。

2. 前往 设置 选项卡。

3. 更新 指令、触发器、对页面、数据库和外部工具的访问权限，或模型选择。

4. 保存并发布你的更改。

5. 使用 聊天 选项卡和 活动 选项卡来验证代理在编辑后是否按预期运行。

要恢复自定义代理的先前版本：

1. 打开代理页面。

2. 访问 版本历史。

3. 查看过去的版本以了解：

   • 谁进行了更改。

   • 更改的时间。

   • 每个版本中更改的内容。

4. 选择要恢复的版本。

5. 确认将代理还原到该版本。

复制自定义代理可以让你复制现有代理并将其调整为类似的工作流程，而无需从头开始构建。

要复制自定义代理：

1. 打开要复制的自定义代理。

2. 点击 •••，然后选择 复制。

副本将作为私人代理打开。你可以在共享或发布前查看并更新它的设置。

复制代理所需条件

• 查看并与原始代理交互的权限。

• 在工作空间管理员的控制下创建自定义代理的权限。如果不确定，请咨询你的工作空间管理员。

迁移内容

• 名称：副本命名为{Original agent name} (1)。你可以随时重新命名。

• AI 模型：副本使用与原始代理相同的 AI 模型。

• 指令：已复制到新页面。如果指令中的任意链接指向你无权访问的页面，这些链接会显示为无权访问的标识，并不会被添加到副本的资源中。

• 页面和数据库：原始代理使用的所有你有权限访问的 Notion 内容都会被迁移。不具备访问权限的内容则不会包含。

• 触发器：使用你有权限访问的资源的触发器会被迁移。如果某个触发器依赖于你无法访问的资源（例如你未加入的 Slack 频道），则该触发器不会被复制。

复制后你需要设置的内容

• 已连接的工具（如 Slack）：副本不会继承任何工具连接。你需要在新副本上重新连接 Slack 等工具。

• 工作者：如果原始代理设置了工作者，你需要重新配置它们。它们不会自动迁移。

• 运行历史记录：副本从零开始，不包括原始代理的任何运行记录或活动。

• 额度限制：原始代理上设置的任何额度限制均不适用于副本。

默认隐私设置

该副本默认为私人，仅你可见。准备好后，可从共享菜单中分享它。

如果您拥有自定义代理的全部权限，则可以将其洞察对话和消息列导出为 CSV 文件，以便在 Notion 之外进行分析或报告。

导出步骤：

1. 打开自定义智能体并转到洞察选项卡。

2. 选择您要导出的时间段。

3. 将鼠标悬停在导出按钮上 → 选择导出为 CSV。

CSV 与 所有聊天 页面上的列相匹配。导出限制为所选期间最多 300 条聊天记录。