需确保Confluence版本≥6.13或7.0+、API账号具空间“查看”权限、启用v2 REST API；Dify中正确配置Base URL、Space Keys、Personal Access Token（含read:confluence-space/content权限）及邮箱用户名；同步后验证内容抽取与向量库集成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让员工在内网直接提问“上季度销售复盘会议纪要里提到的客户流失主因是什么”，就能精准返回Confluence中对应页面的原文段落，不走公网、不传数据、不依赖人工维护索引。
确认Confluence环境与权限准备
登录目标Confluence实例，进入【空间设置】→【权限】→【群组权限】，确保用于对接的API账号至少拥有对应空间的“查看”权限。若使用匿名访问或未启用REST API，后续所有步骤将失败。
检查Confluence版本是否为6.13+或7.0+。低于该版本的Confluence默认禁用v2 REST API，且不支持/rest/api/content/search高级查询语法，Dify无法执行语义化内容拉取。
打开浏览器开发者工具，访问https://wiki.yourcompany.com/rest/api/content?spaceKey=KB&limit=1，用API账号凭据发起GET请求。若返回401或403，说明认证方式未配置正确；若返回空数组但状态码200，说明空间Key拼写错误或该空间为空。
在Dify中创建Confluence数据集并配置连接器
进入Dify控制台 → 知识库 → 新建数据集 → 选择“外部数据源” → 类型选“Confluence”。
填写以下字段：
• Base URL：【必须以https://开头，末尾不带斜杠】
• Space Keys：多个用英文逗号分隔，如KB,DEV,HR，注意大小写敏感
• API Token：使用Personal Access Token（非密码），需在Confluence用户设置中生成并勾选read:confluence-space和read:confluence-content.summary权限
• Username：仅填邮箱地址，不是用户名或昵称
保存后点击“测试连接”。这一步会触发一次轻量级探测请求，验证Token时效性与空间可读性。若提示“Connection failed”，90%概率是Token过期或权限不足，此时不要重试，应立即重新生成Token并替换。
启动同步任务并验证内容抽取质量
第一步：在数据集详情页点击“同步”按钮，选择“全量同步”。
第二步：观察右上角任务状态，从“queued”变为“running”后，打开浏览器新标签页，访问https://wiki.yourcompany.com/pages/viewpage.action?pageId=XXXXX（任一已知页面ID），复制其正文纯文本（不含HTML标签）
第三步：回到Dify知识库搜索框，输入该页面中独有的3～5个连续词（如“Q3客户挽回率提升至78.5%”），确认是否命中且摘要高亮准确
若搜索无结果，先检查Dify后台日志中的confluence_sync_worker报错信息；常见原因是Confluence启用了自定义Content Rendering插件，导致/rest/api/content/{id}?expand=body.storage返回的body.storage字段为空——此时需联系Confluence管理员临时禁用该插件或切换为body.view渲染模式。
同步完成后的文档条目默认按Confluence页面标题建立索引，但Dify不会继承页面层级结构。如需保留“KB/产品文档/前端规范/React组件命名规则”这类路径语义，必须在Confluence页面属性中手动添加metadata.path标签，格式为["KB","产品文档","前端规范"]，否则RAG检索时无法做目录过滤。
启用RAG增强并绑定向量数据库
方法一：使用Dify内置Weaviate（推荐首次部署）
进入Dify设置 → 向量数据库 → 选择“Weaviate” → 填写Weaviate服务地址（如http://weaviate:8080）→ 测试连接成功后，点击“启用”
方法二：复用企业已有Milvus集群
选择“Milvus” → 输入host、port、collection_name（建议命名为dify_confluence_v1）→ 在Milvus中预先执行create_collection，指定dimension=1024（匹配BGE-large-zh嵌入模型输出维度）→ 启用前务必确认Milvus版本≥2.4.0，旧版本不支持consistency_level="Strong"，会导致检索结果延迟可见
启用后，Dify自动对已同步的Confluence页面执行切片（chunk_size=512 tokens，overlap=64），调用嵌入模型生成向量，并写入向量库。整个过程无需人工干预，但首次全量向量化耗时取决于页面总数与服务器GPU性能——1万页PDF等效文本量约需23分钟（RTX 4090实测）。
