跳到主要内容

添加 Confluence (Add Confluence)

将 Confluence 集成为数据源。

本指南概述了如何将 Confluence 集成为 RAGFlow 的数据源。

前提条件 (Prerequisites)

在配置连接器之前，请从你的 Atlassian 账户中获取以下凭据：

  • Confluence 用户邮箱 (Confluence user Email)：执行索引的账户的电子邮箱地址。
  • Atlassian API 密钥 (Atlassian API Token)：通过 Atlassian 账户设置 生成。
  • Confluence 基础 URL (Confluence base URL)：实例的 URL（例如 https://<your-org>.atlassian.net/wiki）。

配置步骤 (Configuration steps)

将 Confluence 定义为外部数据源

导航到 RAGFlow 管理面板中的 连接器 (Connectors) 或 外部数据源 (External Data Source) 部分，然后选择 Confluence。在弹出的窗口中输入以下内容：

  • 是否为云端 (Is Cloud)：指示这是否为 Confluence Cloud 实例的开关。
    • Yes（默认）：Confluence Cloud。
    • False：Confluence Server/Data Center。
  • 名称 (Name)：必填。你的 Confluence 连接器的唯一标识符（例如 Engineering-Wiki）。
  • Confluence 用户名 (Confluence Username)：必填。
    • 对于 Confluence Cloud：你用于登录 Confluence 的完整邮箱地址。
    • 对于 Confluence Server/Data Center：你的登录 ID，通常是一个简写名称。
  • Confluence 访问令牌 (Confluence Access Token)：必填。允许 RAGFlow 代表你读取和索引 Wiki 页面内容的身份验证令牌。
    • 对于 Confluence Cloud：Atlassian API 密钥，从你的全局 Atlassian 账户生成的安全字符串。可以通过 id.atlassian.com/manage-profile/security/api-tokens 创建。
    • 对于 Confluence Server/Data Center：你的个人访问令牌 (Personal Access Token, PAT)。你需要登录公司的 Confluence，点击右上角的个人头像，选择“设置 (Settings)”，然后在左侧边栏中寻找“个人访问令牌 (Personal Access Tokens)”。
  • Wiki 基础 URL (Wiki Base URL)：你的 Confluence 实例的基础 URL，例如 https://your-domain.atlassian.net/wiki。
  • 索引模式 (Index Mode)：
    • Everything（默认）：索引所提供的凭据有权访问的所有页面。
    • Space：RAGFlow 将索引限制为你在此配置中明确列出的空间键 (Space Keys)。
      • 空间键 (Space Keys)：指定以逗号分隔的键（例如 ENG, HR）以限制索引范围。留空以索引所有可访问的空间。

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

RAGFlow 将立即验证连接。

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

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