使用 Workers 运行自定义代码（测试版）

Notion Workers 是我们 开发者平台 的一部分。它们在 Notion 的基础设施上运行自定义代码，以支持：

• 数据库同步

• 自定义代理工具

• Webhook 触发器

• Workers 仅适用于商业方案和企业版。

• 默认情况下，Workers 已为工作空间开启（仅限所有者）。

• 工作空间所有者可以：

  • 将 Worker 创建权限仅限于所有者。

  • 允许特定成员或群组创建 Workers。

  • 为工作空间关闭 Workers。

• 如果你尝试部署或管理 Worker，通常需要遵循我们的 开发者文档 并使用 Notion CLI

• 你可以开启开发者模式以在 Notion 中查看 Workers、读取日志，以及关闭或删除 Workers。要部署 Worker 或更改其代码或设置，请使用 Notion CLI 或你团队的编码工具。了解关于 开发者模式 → 的更多信息

要了解关于 Workers 价格的更多信息，请参阅 本文。

同步数据库（由 Workers 提供支持）可将外部工具中的信息引入 Notion 数据库并自动保持更新。设置完成后，同步数据库会自动保持最新状态，因此你团队和代理无需在工具之间复制粘贴，即可始终查看最新数据。

一些常见示例：

• 将 Zendesk 支持工单同步到分类数据库中。

• 将 Salesforce 帐号同步到销售漏斗追踪器中。

• 从内部工具或数据库同步数据。

一旦上线，同步的数据库就像 Notion 中的任何其他数据库一样。访问权限由你标准的 Notion 共享权限管理。

代理工具（由 Workers 提供支持）扩展了你自定义代理在 Notion 内置操作和 MCP 之外的功能，具备根据你团队工作方式量身定制的能力。

一些常见示例：

• 查询数据仓库。

• 从 Notion 文档生成资产。

• 在不原生支持或通过 MCP 可用的其他应用中执行操作。

Webhook 触发器（由 Workers 提供支持）允许其他工具中的事件启动 Notion 或任何其他连接系统中的工作流。⁠⁠⁠⁠

一些常见示例：

• 当拉取请求合并时关闭任务。

• 当订阅更改时更新 CRM 记录。

• 当签署报价时创建入职文档。

一旦设置完成，每当事件发生时，工作流程会自动运行，因此你团队无需手动在工具之间移动信息。

通过 开发者模式，你可以从侧边栏的开发者部分打开 Workers。使用此视图进行快速检查和基本操作。在 Notion 中，你可以：

• 在一个列表中查看所有 Workers。

• 打开一个 Worker 并查看概览、日志、环境变量和设置。

• 读取 Worker 日志。

• 关闭或删除一个 Worker。

要部署 Worker 或更改其代码或设置，请使用 Notion CLI 或你团队的编码工具。

默认情况下，只有创建 Worker 的人可以修改并将其添加为新连接。与团队成员共享 Worker，以便他们可以将其连接到自定义代理或协助管理。

了解更多关于如何共享 Worker →

请按顺序尝试以下步骤：

1. 确保你的工作空间符合资格，并且工作空间所有者已启用 Workers。Workers 仅适用于商业方案和企业版，并需要工作空间管理员启用。

2. 确认你正在使用预期的设置路径。对于大多数设置，你将使用 Notion CLI 加上 开发者文档。

3. 如果你的 Worker 部署失败，请检查权限。即使你可以查看其中的页面，也可能没有在该工作空间部署的权限。

4. 如果你的 Worker 运行但未在 Notion 中更改任何内容，请先手动测试该操作。如果你无法在 Notion 中进行相同的更改，通常是权限或工作空间设置问题。

5. 如果成本看起来比预期的要高，请降低运行频率。运行更频繁的 Workers 会花费更多。从较慢的日程开始，一旦确信其正常工作，再增加频率。

6. 还卡住了吗？关注此页面开发者文档，查找特定错误消息的解决方案，他们会提供最准确的修复方法。