成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Notion 数据库与 data source API 简报

按 database / data source / page 对象分层、属性 schema 与筛选排序入口,生成企业自动化对接简报;不代调生产 Notion 写入。

飞书ClaudeChatGPTn8n⚡ 效率办公🏢 企业协作

场景说明

面向企业自动化与独立开发者:把「多维表对接」写成对象模型简报,区别于仅聊 Notion Agent 控制面。

案例叙事

01他们做了什么

把飞书/表格流程迁到 Notion 或用 n8n 写回多维表时,最常见卡点是:只拿到一个「库链接」,却分不清该调 database 还是 data source,属性写到哪一层。

Notion Docs《Working with databases》说明:Notion database 组织 pages;data source 定义这些 pages 共享的属性。API 将 database、其 data sources 与 pages 视为分离对象。结构上,database 含 data sources 与 views,`data_sources` 数组给出各源的 id 与 name;data source 持有 schema,并作为其 pages 的 parent;schema 定义属性名、类型与设置。在表格视图中,属性像列、page 像行,属性值填单元格,内容块构成页面正文。文档指向创建 data source 中的 page、读取页面属性、更新 data source 属性等步骤页,并涵盖遍历 database 对象、向 data source 加 page、查找/过滤/排序 data source pages,以及 linked / wiki 等额外库类型。本场景据此输出对接简报与提问清单。禁止声称「已写入客户正式库」。

02实际效果

  • 源未披露量化「对接一次平均工时」;公开文只描述 database/data source/page 分层与操作入口。
  • 能避免把 database id 当成可直接当「表 schema 父级」误用。
  • 为企业自动化(工单/清单回写)提供可复用对象词汇表。

03值得知道

  • Notion API 版本与属性类型会演进,以实现时官方参考与升级说明为准。
  • 集成权限不足时读得到库结构也写不进页,须先核 capabilities。
  • 上面写的是文档结构说明,不是你工作区实时 schema。

04可复制提示词

Notion 库对接简报

你是 Notion Data API 对接助手。只根据文档结构给简报,不要编造已写入成功。

业务目标:{{business_goal}}
已知 ID/属性(可打码):{{ids_and_props}}
集成权限摘要:{{integration_caps}}

输出 Markdown:
1. database / data source / page 分层对照
2. 创建页、读属性、过滤排序应落在哪一层
3. 还需向业务确认的字段清单
4. 沙箱验证步骤
禁止索要正式 integration secret;禁止代发写请求。

属性对不齐排查提纲

自动化读写 Notion 库时属性对不齐或找不到行,请写排查提纲。

现象:{{symptom}}
使用的对象 ID 类型:{{id_kind}}
过滤器摘要:{{filter_brief}}

输出:
1. 是否用错 database vs data_source id
2. schema 是否在 data source
3. 过滤/排序入口核对
4. 下一步人工 API 调用建议
不要伪造「数据已同步」。

05一手来源

Notion Docs · Working with databases ↗

文档更新

怎么做

  1. 粘贴目标库用途、已知 database/data_source ID 形态(可打码)与要读写的属性名
  2. Agent 按官方结构说明输出:database→data_sources→pages/属性→筛选排序相关入口提问
  3. 人工用集成 token 在沙箱库验证;Agent 不代发写入请求

实用提示

  • API 把 database、其 data sources 与 pages 视为不同对象;表头 schema 在 data source,行是 page
  • 与 notion-agents-control-plane 不同:本条是 Data API 对象模型与库操作入口,不是 Agent 控制面叙事
#Notion API#database#data source#企业自动化#多维表