跳到主要内容

Notion 集成

将 Notion 连接到 Frevana,即可搜索、创建和管理您与集成共享的页面和数据库。

打开 notion.so/my-integrations​

登录并选择 Create a new integration。

创建 Notion 集成

备注

如果您的账号属于某个组织,您可能没有足够的权限创建集成。

输入基本信息​

输入 Integration name,选择 Icon 和 Associated workspace,然后选择 Create。

填写 Notion 集成基本信息

选择 Configure integration settings 打开 Edit integration 页面。

打开 Notion 集成设置

复制 Notion Secret Token​

找到 Internal Integration Secret 并选择 Show。复制令牌供 Frevana 智能体团队使用;它通常以 ntn_ 开头。

复制 Notion 集成密钥

备注

请妥善保管令牌。 拥有令牌的人可以访问您与集成共享的页面。如果丢失,可以返回此页面查看或刷新。

编辑内容访问权限​

选择集成可以访问的页面和数据库:

  • 打开 Content access 标签页。
  • 选择 Edit access。
  • 选择希望 AI 访问的页面和数据库。
  • 选择 Save。

编辑 Notion 内容访问权限

如果希望 AI 访问整个工作空间,可以选择所有页面;以后也可以随时返回修改。

在智能体团队聊天中提供令牌​

打开 Notion 智能体团队聊天,尝试发送:

List my Notion databases

如果 Notion 尚未连接,Frevana 会要求您提供上面复制的 Notion Secret Token。随后 Frevana 可以验证令牌并显示已连接的工作空间。现在,您已完成连接!

您可以做什么​

操作示例
搜索“查找关于产品路线图的页面。”
读取“显示项目简报的内容。”
创建“用今天的会议笔记创建新页面。”
更新“将该页面重命名为 Q2 Review。”
追加“在昨天的会议页面添加行动事项。”
列出数据库“显示我所有的 Notion 数据库。”
查询数据库“显示 Tasks 看板中本周到期的任务。”
添加条目“添加一个名为 Review PR、状态为 To Do 的任务。”
查看结构“我的 Projects 数据库有哪些属性?”

故障排查​

“Not found”或“Object not found”:页面或数据库未与集成共享。在 Notion 中打开页面,选择 ··· → Connections,添加您的集成。

“Invalid token”:令牌复制错误或已过期。打开 notion.so/my-integrations,选择集成并重新复制令牌;它应以 ntn_ 开头。

看不到数据库或搜索没有结果:必须明确将数据库和页面与集成共享。在侧边栏打开每个顶级页面,选择 ··· → Connections 并添加集成。共享父页面也会共享其子页面。

查询结果为空:筛选器中的属性名称区分大小写,必须完全匹配。请先让 AI 显示数据库结构,查看准确的属性名称和类型,再重新查询。

断开连接或切换工作空间:告诉 AI “Reconnect my Notion”,然后粘贴新令牌;旧令牌会自动替换。

隐私与安全​

  • 您的令牌仅保存在本机(~/.config/notion/config.json)。
  • AI 通过官方 API 访问 Notion;您的数据不会存储或发送到其他地方。
  • 集成只能查看您明确共享的页面。
  • 您可以随时在 notion.so/my-integrations 删除集成以撤销访问权限。