Confluence 是一个功能强大的协作平台，用于保存和组织项目相关的所有资料。它作为一个知识库，主要用于内容管理活动。在开发过程中，有时候我们需要从 Confluence 上读取和加载文档，这就是 ConfluenceLoader 的用途。本文将介绍如何使用 ConfluenceLoader 轻松地加载 Confluence 页面及其附件，帮助您在开发过程中实现更高效的文档内容管理。

核心原理解析

ConfluenceLoader 是一个用于从 Confluence 页面加载文档的工具，支持多种方式的认证，包括用户名/API 密钥、OAuth2 登录，以及适用于自托管版本的个人访问令牌（PAT）认证。它允许指定 page_id 和/或 space_key 来加载对应的页面，并支持包括附件的加载。

示例代码演示

以下是如何使用 ConfluenceLoader 进行加载的示例代码：

使用用户名和密码或 API Token 认证

# 导入必要的模块
from langchain_community.document_loaders import ConfluenceLoader

# 创建 ConfluenceLoader 实例
loader = ConfluenceLoader(
    url="https://yoursite.atlassian.com/wiki", 
    username="me", 
    api_key="12345"
)

# 加载文档，包含附件
documents = loader.load(
    space_key="SPACE", 
    include_attachments=True, 
    limit=50
)

使用个人访问令牌 (Server/On-Prem only)

# 导入必要的模块
from langchain_community.document_loaders import ConfluenceLoader

# 创建 ConfluenceLoader 实例
loader = ConfluenceLoader(
    url="https://yoursite.atlassian.com/wiki", 
    token="12345"
)

# 加载文档，包含附件
documents = loader.load(
    space_key="SPACE", 
    include_attachments=True, 
    limit=50, 
    max_pages=50
)

应用场景分析

ConfluenceLoader 在以下场景中非常有用：

• 团队协作文档处理：在大规模协作项目中，需要高效地访问和处理文档。
• 自动化知识库管理：通过程序化接口自动加载和管理文档，提高效率。
• 内容检索与分析：结合其他 AI 工具对加载的文档进行进一步的分析和处理。

实践建议

• 在使用 ConfluenceLoader 之前，请确保已经安装并更新 atlassian-python-api 包。
• 使用 API Token 时，请注意账号的访问权限，以确保可以访问所需的文档。
• 定义 limit 和 max_pages 参数以优化加载性能和资源占用。

结束语：

如果遇到问题欢迎在评论区交流。

—END—