Notion
索引内容
Notion 连接器会索引已共享给 Integration 的页面,包括页面 Property 和受支持的 Block 内容。它还会发现 Database 层级、查询 Database Data Source,并索引其中的页面。受支持内容包括嵌套子页面、Rich Text Block、Table 和 People Property。
提供 Root Page 时,连接器会使用递归遍历。没有 Root Page 时,部署配置也可以启用递归查找,以补偿 Notion Search 未返回的页面。
前置条件
- 在内容所属 Workspace 中创建 Notion Internal Integration。
- 将每个已批准的顶层页面或 Workspace 区域共享给 Integration。Integration Token 无法发现未共享给它的内容。
- 复制 Integration Token;需要缩小连接器范围时,再复制 Root Page ID。
- OpenCore Admin 必须决定索引所有 Integration 可访问页面,还是仅索引一个已批准的子树。
- 允许连接器 Worker 出站 HTTPS 访问
api.notion.com。
凭据
Notion 索引连接器未实现 OAuth。其他应用功能使用的 Notion OAuth 不会创建该连接器凭据。
在 OpenCore 中配置
- 在 Notion 中把已批准的源页面共享给 Internal Integration。
- 在 OpenCore Admin 后台打开 Connectors,选择 Notion,然后创建 Integration Token 凭据。
- 将 Root Page ID 留空可索引 Integration 能发现的所有页面;输入一个已批准的 Page ID,则只索引该页面及其后代。
- 对受限内容选择 Private 并分配 OpenCore 用户组;只有当所有账号都可搜索时才选择 Public。
- 设置刷新和清理选项,创建连接器,然后运行首次索引尝试。
- 审查已索引页面范围后,再将生成的文档集附加给 Agent。
权限
Notion 连接器不支持源权限同步。它使用 Integration 的访问权决定可以摄取哪些内容,但不会把每个 Notion 页面的 Viewer 列表复制到 OpenCore。
这意味着可以访问连接器或其文档集的 OpenCore 用户能够搜索所有已索引 Notion 内容,即使该用户无法在 Notion 中打开每个源页面。请为不同的源边界使用独立 Integration/Connector,并使用 OpenCore Private 访问模式显式分配用户组。不要对混合敏感度的 Notion 内容使用 Public。
验证
- 确认凭据验证能够搜索一个页面,或直接获取所配置的 Root Page。
- 运行索引尝试,并搜索 Root Page 和一个嵌套子页面中的文本。
- 当内容存在时,验证一个 Database Row、Table Cell 或 People Property 是否可搜索。
- 确认未共享页面或配置 Root 子树之外的页面不存在。
- 由于 Notion 源 ACL 不会同步,请使用分配给连接器的每个 OpenCore 用户组测试访问。