连接外部知识库

为了确保你的外部知识库与 Dify 连接成功，请在建立 API 服务前仔细阅读由 Dify 编写的外部知识库 API 规范。

目前， Dify 连接外部知识库时仅具备检索权限，暂不支持对外部知识库进行优化与修改，开发者需自行维护外部知识库。

前往 “知识库” 页，点击右上角的 “外部知识库 API”，轻点 “添加外部知识库 API”。

按照页面提示，依次填写以下内容：

• 知识库的名称，允许自定义名称，用于区分所连接的不同外部知识 API；
• API 接口地址，外部知识库的连接地址，示例 api-endpoint/retrieval；详细说明请参考外部知识库 API；
• API Key，外部知识库连接密钥，详细说明请参考外部知识库 API；

前往 “知识库” 页，点击添加知识库卡片下方的 “连接外部知识库” 跳转至参数配置页面。

填写以下参数：

• 知识库名称与描述

• 外部知识库 API 选择在第二步中关联的外部知识库 API；Dify 将通过 API 连接的方式，调用存储在外部知识库的文本内容；

• 外部知识库 ID 指定需要被关联的特定的外部知识库 ID，详细说明请参考外部知识库 API。

• 调整召回设置

  Top K： 用户发起提问时，将请求外部知识 API 获取相关性较高的内容分段。该参数用于筛选与用户问题相似度较高的文本片段。默认值为 3，数值越高，召回存在相关性的文本分段也就越多。

  Score 阈值： 文本片段筛选的相似度阈值，只召回超过设置分数的文本片段，默认值为 0.5。数值越高说明对于文本与问题要求的相似度越高，预期被召回的文本数量也越少，结果也会相对而言更加精准。

建立与外部知识库的连接后，开发者可以在 “召回测试” 中模拟可能的问题关键词，预览从外部知识库召回的文本分段。若对于召回结果不满意，可以尝试修改召回参数或自行调整外部知识库的检索设置。

• Chatbot / Agent 类型应用

在 Chatbot / Agent 类型应用内的编排页中的 “上下文” 内，选中带有 EXTERNAL 标签的外部知识库。

• Chatflow / Workflow 类型应用

在 Chatflow / Workflow 类型应用内添加 “知识检索” 节点，选中带有 EXTERNAL 标签的外部知识库。

在 “知识库” 页，外部知识库的卡片右上角会带有 EXTERNAL 标签。进入需要修改的知识库，点击 “设置” 修改以下内容：

• 知识库名称和描述

• 可见范围 提供 「 只有我 」 、 「 所有团队成员 」 和 「部分团队成员」 三种权限范围。不具有权限的人将无法访问该知识库。若选择将知识库公开至其它成员，则意味着其它成员同样具备该知识库的查看、编辑和删除权限。

• 召回设置

  Top K: 用户发起提问时，将请求外部知识 API 获取相关性较高的内容分段。该参数用于筛选与用户问题相似度较高的文本片段。默认值为 3，数值越高，召回存在相关性的文本分段也就越多。

  Score 阈值： 文本片段筛选的相似度阈值，只召回超过设置分数的文本片段，默认值为 0.5。数值越高说明对于文本与问题要求的相似度越高，预期被召回的文本数量也越少，结果也会相对而言更加精准。

外部知识库所关联的 “外部知识库 API” 和 “外部知识 ID” 不支持修改，如需修改请关联新的 “外部知识库 API” 并重新进行连接。