structure｜1️⃣ 三级笔记、思想框架

《Notion Developer Platform：让 coding agents 也能写 Notion 工具》

核心观点 / 主旨

Notion 这次发布的重点，不是单点 API 增强，而是把 Notion 从“人类团队协作空间”扩展成“团队、数据和 agents 共同工作的共享画布”。新的 Developer Platform 让开发者和 coding agents 可以把外部数据同步进 Notion、为 agents 编写确定性的工具、从任何系统触发 Notion 工作流，并把外部 agents 与 Notion 内部上下文连接起来。

一、Notion 正在补齐开发者平台这一层

1.1 从“不太面向开发者”到 Developer Platform

• 文章开头直接承认 Notion 过去并不总是最 developer-focused 的平台，然后用“Today that changes”转入这次发布。
• 新平台的目标是让开发者和 coding agents 写代码，同步任何数据、构建任何 agent tool，并且这些能力运行在 Notion 自己的基础设施上。
• Notion 不只是让 agents 访问页面，而是希望把 Claude、Codex、Decagon 或用户自建 agents 带入 Notion，让 Notion 成为团队与 agents 共用的工作画布。

1.2 平台命令行入口

• 文章把新的 CLI 作为开发者入口：安装 ntn 后，就能开始构建 syncs、agent tools 和 webhooks。
• CLI 的定位是“built for humans and agents alike”：命令 token-efficient，认证由 keychain 管理，适合人类开发者和 coding agents 使用。

二、Database sync：把任何 API 数据源同步成 Notion 数据库

2.1 同步对象与使用场景

• 新的 database sync 处于 Beta，目标是把任何有 API 的数据源同步到 Notion database。
• 文章举例包括 Zendesk tickets、Salesforce records、Postgres database。
• 这些数据进入 Notion 后，可以给整个团队和 agents 提供完成工作所需的上下文。

2.2 Notion 承担同步运行时

• 这套同步由 Workers 驱动，运行在 Notion 的基础设施上，用户不需要维护服务器，也不需要写胶水代码。
• OAuth、environment variables、rate-limit pacing、backfills 和 persistent cursors 都由平台内建。
• 这意味着 Notion 不只是数据展示层，而开始承担外部系统集成中的运行、认证、节流、增量同步和恢复责任。

2.3 PlanetScale 的例子

• PlanetScale CEO Sam Lambert 的例子说明 Workers 可以构建过去无法存在的深度集成。
• 他们使用 nightly worker 把 Google Drive 中不可编辑的 PDF 同步并转换成 Notion 中有组织的、可编辑页面。
• 这个例子强调两个结果：团队和 agents 都能访问原本锁在文件里的数据；同时减少大量人工处理时间。

三、Custom tools for agents：把确定性代码交给 agents 调用

3.1 弥补 Notion 和 MCP 原生能力之外的缺口

• Agent tools 的目标是给 Custom Agents 增加 Notion 和 MCP 本身没有覆盖的能力。
• 开发者把逻辑写成代码，再部署为 Worker。
• 这些工具可以生成资产、查询内部数据，或者在其他应用中采取动作。

3.2 为什么强调 deterministic

• 文章突出 composable workflows、typed I/O、repeatable runs 和 logged execution。
• 它把工具代码描述为 deterministic，因此比单纯依赖 LLM reasoning 更可靠，成本也更低。
• 这里的思想框架是：LLM 负责理解和协调，Worker 工具负责可重复、可审计、可控制的执行。

3.3 Every 的例子

• Every 的 Austin Tedesco 把 Notion Workers 看作 infrastructure。
• 在他的表述里，Workers 自动填充、自动更新，并搭起他需要的系统。
• 这个例子把 Workers 从“某个自动化脚本”提升为“系统基础设施”的角色。

四、Webhooks：让外部系统直接触发 Notion 工作流

4.1 从单向触发变成双向连接

• 文章说过去 Webhooks 像一条 one-way street：Notion 可以触发其他 apps，但其他 apps 不能反过来直接触发 Notion。
• 新能力让任何 app 都可以直接触发 Notion。
• 一个 Worker 接收 webhook，运行用户逻辑，然后在 Notion 中采取行动，或者继续调用其他 API。

4.2 业务动作例子

• PR merge 后关闭任务。
• 订阅变化后更新 CRM。
• offer 签署后创建 onboarding doc。
• 这些例子共同说明：Notion 想成为业务事件流的承接层，而不是只在用户打开页面时工作。

五、Notion Workers：贯穿同步、工具和 webhook 的新 primitive

5.1 Workers 的定义

• Database sync、agent tools 和 webhook triggers 都由同一个新 primitive 支撑：Notion Workers。
• Workers 是 Notion 的 hosted runtime for custom code，开发者可以扩展 Notion，而不需要运行自己的服务器。
• 开发者和 coding agent 写代码，通过 CLI 部署，在 secure sandbox 中运行。

5.2 Beta 与计费

• Workers 在 beta 期间免费试用。
• 从 2026-08-11 起，Workers 会消耗 Notion credits。
• 这说明 Notion 把 Workers 当作平台级执行资源，而不是一次性功能。

5.3 Vercel 的例子

• Vercel 的 Brian Emerick 把 Workers 描述为连接其他工具 API、自动化过去人工交接的方式。
• 在他的说法里，Notion becomes the connective layer，Workers 填补工具之间的空隙。
• 这个例子再次强化 Notion 的定位：不是替代所有工具，而是把工具上下文和自动化动作组织到一个共享层里。

六、Agents 进入和离开 Notion 的两条 API 路线

6.1 External Agents API：把任意 agent 带入 Notion

• External Agents API 处于 Alpha，目标是把 Claude、Codex、Decagon 或自建 agents 带进 Notion。
• Notion 希望成为 orchestration layer：例如 Decagon ticket 路由到 coding agent，coding agent 提出修复，再让团队审批。
• 文章强调 agents 不只是工程师的工具，任何人都可以在 Notion 中与 agents 协作。

6.2 Notion Agent SDK：把 Notion Agents 带到任何 app

• Agent SDK 处于 Alpha，方向与 External Agents API 相反：让 Notion Agents 不必停留在 Notion 内部。
• 它支持通过 API 触发 agent runs，包括 streaming responses、async polling 和 multi-turn threads。
• 典型使用场景包括把 agent 嵌入产品、驱动 Slack / Discord bot，或者启动异步工作流。

6.3 Brainlabs 的例子

• Brainlabs CEO Dan Gilbert 说 Notion 是他们的 AI layer，因为工作是在那里被创建或想象出来的。
• 这句话补足了 Notion 的 agent 平台叙事：agents 要靠近真实工作的发生地，而 Notion 认为自己就是这个位置。

七、连接、API 与开发者体验的底座更新

7.1 Connections tab

• Workspace settings 里的 Connections tab 被更新为统一连接管理页。
• personal connections、workspace connections、personal access tokens 和 internal API connections 都放在同一个地方。
• 每个 app 会把所有 connection type 汇总到同一个 listing 中，方便团队查看可用连接。

7.2 Agents “hall of fame”

• Notion 还整理了来自 Ramp、Clay、Vercel 等公司的 agent 示例库。
• 每个示例包含所需 databases、pages、tools 的 checklist 和 starter prompt。
• 这个部分服务于“知道该构建什么 agent 很难”的问题，用现成模式降低 agent 落地门槛。

7.3 API 与 MCP 更新

• Markdown API：支持以 Markdown 读写 Notion pages，符合 agents 已经习惯的文本工作方式。
• Notion MCP：支持 Meeting Notes 和 block comments，并让 database 创建和更新更 token-efficient。
• Notion API：任何成员都可以创建 connections，不再只限 Workspace Owners；同时提供 workspace-scoped OAuth 和 personal access tokens。
• Developer Portal：app.notion.com/developers 成为创建、管理和 listing connections / tokens 的专门入口。

关键概念 / 术语

• Notion Developer Platform：让开发者和 coding agents 在 Notion 基础设施上同步数据、构建工具、触发工作流和接入 agents 的平台层。
• Database sync：把任何有 API 的外部数据源同步成 Notion database 的能力。
• Notion Workers：Notion 托管的 custom code runtime，是 database sync、agent tools 和 webhook triggers 的共同执行 primitive。
• Custom tools for agents：开发者用代码为 agents 编写的确定性工具，用来补足 Notion 和 MCP 原生能力之外的执行能力。
• Deterministic workflows：与 LLM reasoning 相比更可重复、更可靠、更便宜的代码化执行路径。
• Webhooks into Notion：外部 app 直接触发 Notion 工作流的机制，让业务事件进入 Notion 并触发后续动作。
• External Agents API：把任意外部 agent 带入 Notion 的 Alpha API。
• Notion Agent SDK：把 Notion Agents 带到任意 app，并通过 API 触发 agent runs 的 Alpha SDK。
• ntn CLI：Notion 的新 CLI，面向人类开发者和 agents，提供 API、文件上传、构建和部署入口。
• Connections tab：统一管理 personal / workspace connections、tokens 和 internal API connections 的设置页。

concepts｜2️⃣ 关键概念、概念网络

agentic reading｜3️⃣ 费曼 x3