Notion’s Developer Platform

Notion’s Developer Platform 是什么？

Notion’s Developer Platform 是一组开发者功能，用于以 Notion 作为共享工作空间进行构建——将外部数据同步到 Notion、创建 Notion Agents 可用的自定义工具，并编排多步骤代理工作流。

其核心目的是让您将外部系统连接到 Notion（例如，从其他来源保持 Notion 数据库更新），并通过专属操作和工具接口扩展 Notion Agents。

使用 Workers 持续 upsert 外部记录到 Notion 数据库，采用声明式 schema 和持久游标，从而支持跨运行恢复更新。
外部数据集到 Notion 的定时同步（例如，在示例中定义如 5m 的同步计划）。
为 Notion Agents 提供自定义代理工具，生成输出（如资产）并与外部 API 或实时数据交互。
结构化工具接口，定义工具的输入 schema（例如，用于创建演示文的 pageId 字符串，或用于运行仓库查询的 SQL query 字符串）。
Webhook 驱动的工作流编排，监听来自其他应用的传入 webhook，并使用 Notion Agents、页面、数据库和外部 API 调用触发 Notion 工作流。

创建或指定 Notion 数据库，并定义该数据库与外部数据字段之间的 schema 映射。
构建 Worker 同步数据：配置托管数据库连接，提供初始 schema/主键，并编写返回记录变更的同步函数（例如，将源字段映射到 Notion 属性）。
设置同步计划和稳定标识符（主键），以实现记录 upsert 而非重复。
可选添加自定义工具供 Notion Agents 使用：注册工具名称、描述、输入 schema 和执行处理程序（例如，从 Notion 页面生成 .pptx 资产并上传回页面）。
如果需要事件驱动自动化，配置 webhook 监听器，触发使用代理和外部 API 调用的 Notion 工作流。

支持票据摄入到 Notion：使用 Worker 持续将外部帮助台票据同步到 Notion 数据库，按票据 ID upsert，并映射主题、CSAT 和标签等字段。
从 Notion 内容自动生成资产：创建自定义工具（例如 createPresentation），将 Notion 页面读取为 markdown，将标题转换为幻灯片，上传生成的 .pptx 并附加到页面。
代理工具查询数据仓库：定义工具（例如 queryRevenue），接受 SQL 查询字符串，对仓库表运行查询，并将结果返回给代理工作流。
外部事件触发的操作工作流：构建 webhook 驱动的工作流，监听任意应用的イベント，然后使用 Notion Agents 结合页面/数据库和外部 API 调用运行 Notion 工作流。
代理工具控制基于浏览器的应用操作：实现代理工具，使用浏览器自动化提供商在外部应用中执行多步骤任务（示例场景：列出保存的餐食、确认订单并检查配送状态）。

是的。示例描述了使用持久游标持续将外部记录 upsert 到 Notion 数据库的 Workers，支持恢复更新。

提供的示例包括从 Notion 页面内容生成 PowerPoint（.pptx）并上传回页面。

是的。一个示例工具对交易仓库表运行 SQL 查询，另一个示例描述通过浏览器自动化使用外部应用操作。

页面描述了监听任意应用的传入 webhook，然后运行使用 Notion Agents、页面、数据库和外部 API 调用的 Notion 工作流。

在示例中，您定义带有 schema 和主键属性的托管数据库连接，然后提供将外部记录映射为 Notion 属性的 upsert 同步函数。

通用 ETL/ELT 工具（仅限数据同步）：如果您的主要目标是将数据移动并转换到数据库中，ETL 工具可以处理定期摄取，而 Notion Developer Platform 还涵盖代理工具和工作流编排。
工作流自动化平台（用于触发和编排）：此类工具可以协调跨应用的 Webhook 和操作，但可能无法提供与 Notion Agents 在 Notion 页面和数据库上操作相同的紧密耦合。
具有外部集成的代理工具框架（用于自定义工具调用）：如果您已在构建代理系统，可以使用工具框架调用 API 并生成资产；Notion 的平台专门针对围绕 Notion 工作区的代理交互和数据同步。