连接ragflow知识库-j9九游会登录

费用说明

调用外部ragflow知识库接口会产生ragflow服务侧的计算资源消耗及网络流量费用，请关注第三方服务状态。

约束与限制

删除外部知识库连接前，请确认无智能体正在使用该连接下的知识库，否则将导致智能体问答失败。

当资源数量达到上限时，请删除不再使用的资源以释放配额：

• 第三方知识库连接：进入 “第三方知识库连接” 页面进行删除。具体操作请参考管理知识库中的“删除外部知识库连接信息”。删除后，基于该连接接入的知识库将不可用。
• 第三方知识库：进入 “知识库” 页面进行删除。具体操作请参考管理知识库中的“取消接入”。

关于知识库的更多约束与限制，请参考知识库使用限制。

步骤一：准备工作

步骤二：连接ragflow第三方知识库

1. 登录。
2. 在左侧导航栏中选择“开发中心 > 组件库”，选择“知识库”页签。
3. 在“知识库”页面，单击“第三方知识库连接”。
4. 在“创建知识库连接”页面，设置连接ragflow知识库基本信息，参数配置请参考表1。
   图6 连接外部知识库
   

   表1 参数说明

   参数		说明	示例
   基本信息	选择类型	general：用于对接用户自研知识库平台，需自行实现检索接口。 koosearch：用于对接华为云企业搜索服务，开箱即用koosearch。 ragflow：用于对接开源项目ragflow，快速对接复用。	ragflow
   	知识库名称	用于标识知识库。 由1~50个字符组成，包含中文、字母、数字、中划线、下划线，且必须以中文、字母、数字开头。	ragflow
   	描述（可选）	用于简要说明知识库内容和用途。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。 由0~255个字符组成。	ragflow知识库
   	图标	系统默认知识库图标，可单击自动生成图标，也可以自定义图标。 鼠标移动至图标上，单击鼠标左键。 上传已准备好的知识库图标。 支持jpg、jpeg、png、gif格式图片，且不大于200kb。	默认
   连接信息	服务地址	能够访问检索接口及查询列表接口的地址。 需填写ragflow服务的api基础地址，如https://ragflow.example.com。	https://xxx.com
   	apikey	用于访问第三方ragflow知识库的鉴权密钥。 注意： 请妥善保管鉴权密钥，避免泄露。建议定期更换密钥以确保安全。 关于密钥加密：鼠标移动至“apikey”右侧的上，可查看密钥的加密方式。平台默认使用kms加密 默认密钥方式对认证密钥进行加密存储，防止信息泄露。 加密机制：使用用户选择的密钥派生dek进行加密，默认密钥为kms-agentarts/default。 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。超出后按实际调用次数计费，详见。	sk-xxxxxxxx
   	知识库详情页面链接	第三方ragflow知识库详情页面的链接，可通过该页面直接访问ragflow知识库的详情页面。注意需要使用占位符{{id}}表示知识库id，否则无法跳转到对应的知识库页面。	http://xxxxx.com/knowledge/dataset?id={{id}}

5. 单击“测试连接”，弹出“测试成功”提示。

   如果显示“第三方知识库连接失败，请检查连接地址和认证信息”，请检查ragflow服务是否支持在公网使用api访问。

6. 测试成功后，单击“确定”。

   页面返回第三方知识库连接列表，连接创建成功后“状态”为“已停用”，完成步骤三：创建general第三方知识库后“状态”变为“已启用”。

步骤三：创建ragflow第三方知识库

agentarts通过连接外部知识库，可以显著扩展知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。

已完成步骤二：连接ragflow第三方知识库。

1. 登录。
2. 在左侧导航栏中选择“开发中心 > 组件库”，选择“知识库”页签。
3. 在“知识库”页面，单击“创建知识库 > 接入第三方知识库”。
   • 创建平台知识库：适用于数据在agentarts平台直接管理的场景，支持上传文档和faq。具体操作请参考。
   • 接入第三方知识库：适用于企业已有现成知识库（如ragflow），希望直接对接复用的场景。
4. 在“接入第三方知识库”界面中，选择已接入的知识库，在右侧勾选知识库。
   

   如果列表中没有需要的第三方知识库，则可以单击“新建”，新建知识库连接，具体配置请参考表1。

   图7 接入第三方知识库
   
5. 单击“确定”，第三方知识库创建完成。

   创建完成的知识库，显示在知识库列表，“类型”为“ragflow”，“状态”为“已启用”。

相关操作

在“第三方知识库连接”页面，支持的其他操作请参考表2。

常见问题

• 创建第三方知识库时为什么查不到知识库列表？
• 外部知识库连接中的已启用/已停用状态如何更改？
• 连接ragflow失败如何排查？
  • 接口返回401/403：检查apikey是否正确。
  • 连接超时：检查url是否正确。

相关文档

• 连接外部知识库后，请参考知识库命中测试校验知识库是否可用。
• 连接外部知识库后，可以对外部知识库进行管理，具体请参考管理知识库。