跳到主要内容

添加 Notion (Add Notion)

将你的 Notion 工作区 (Notion Workspace) 连接到 RAGFlow，使你能够将笔记、数据库和文档直接导入并同步到数据集中。配置完成后，RAGFlow 会从指定的 Notion 页面中获取数据，为你的 RAG 应用 (RAG Applications) 提供上下文。

前提条件 (Prerequisites)

在开始之前，请确保你拥有：

  • 具有 工作区所有者 (Workspace Owner) 权限的 Notion 账户（创建集成所必需）。
  • 你打算同步的特定页面或数据库。

创建内部集成 (Create an internal integration)

为了允许 RAGFlow 访问你的 Notion 数据，你必须首先在 Notion 开发者门户中创建一个内部集成，以生成安全令牌。

  1. 导航到 Notion 我的集成 页面。
  2. 点击 + 新建集成 (+ New integration)。
  3. 在 名称 (Name) 字段中，输入名称（例如 "RAGFlow Connector"）。
  4. 选择你的数据所在的 关联工作区 (Associated workspace)。
  5. 在 功能 (Capabilities) 下，确保已勾选 读取内容 (Read content)。RAGFlow 不需要写入或与用户相关的权限。
  6. 点击 提交 (Submit)。
  7. 在 机密 (Secrets) 选项卡下，点击 显示 (Show)，然后点击 复制 (Copy) 以保存你的 内部集成令牌 (Internal Integration Token)。

授予页面访问权限 (Grant access to your pages)

默认情况下，新集成的服务无法访问你工作区中的任何页面。你必须明确分享你希望 RAGFlow 进行索引的页面。

  1. 打开你希望用作数据源根目录的 Notion 页面或数据库。
  2. 点击右上角的 ...（三个点）菜单。
  3. 向下滚动到 连接到 (Connect to)（或 添加连接 (Add connections)）。
  4. 搜索你创建的集成（例如 "RAGFlow Connector"）并选择它。
  5. 出现提示时确认连接。
注意 (NOTE)

如果你共享了父页面，该集成将自动拥有对其下所有嵌套的子页面和数据库的访问权限。

识别根页面 ID (Identify the root page id)

根页面 ID (Root Page Id) 告诉 RAGFlow 从哪里开始索引。你可以在 Notion 页面的 URL 中找到它。

  1. 在 Web 浏览器中打开你的目标根页面。
  2. 查看地址栏中的 URL。页面 ID 是 URL 末尾的 32 位字母数字字符串。
    • 格式： https://www.notion.so/workspace-name/Page-Title-11a047149aef80578303e705001bb90e
  3. 仅复制这 32 位的字符串（排除 ? 后面的任何参数）。

在 RAGFlow 中配置 Notion 连接器 (Configure the notion connector in RAGFlow)

获取令牌和 ID 后，在 RAGFlow 界面中添加连接器。

字段 (Field)描述 (Description)是否必填 (Required)
名称 (Name)此数据源的唯一标签（例如 Engineering Wiki）。是
Notion 集成令牌 (Notion Integration Token)从 Notion 开发者门户复制的“内部集成机密”。是
根页面 ID (Root Page Id)你想要同步的顶层页面的 32 位 ID。否

配置完成后，点击 确认 (Confirm) 保存更改。

RAGFlow 将立即验证连接。

仅凭凭据不会触发索引。你必须将数据源链接到特定数据集：

  1. 导航到 数据集 (Dataset) 选项卡。
  2. 选择或创建目标数据集 (Dataset)。
  3. 导航到数据集的 配置 (Configuration) 页面，然后选择 链接数据源 (Link data source)。
  4. 在弹出窗口中选择先前创建的 Notion 连接器。