接入第三方RAGFlow知识库

场景介绍

在特定业务场景中，大模型可能需要处理大量特定领域的数据和知识。例如，在医疗领域，大模型可能需要访问最新的医学研究和临床数据；在金融领域，大模型可能需要实时获取市场数据和经济指标。接入第三方知识库可以提供这些特定领域的数据和知识，从而提高大模型的性能和适用性。

当前Versatile支持对接开源第三方RAGFlow知识库，本实践以本地搭建的RAGFlow知识库为例介绍如何接入第三方知识库。

前提条件

已搭建好RAGFlow知识库，具体请参考RAGFlow文档。

准备工作

获取已搭建的RAGFlow知识库连接信息：

1. 在RAGFlow里创建一个知识库，并上传相关文档。
   图1 RAGFlow中的知识库
   

2. 在RAGFlow“个人中心 > API”中获取RAGFlow的连接信息，包括API Key和API服务器地址。
   图2 RAGFlow连接信息
   

3. 在第三方知识库中，进入已创建的知识库详情页，在浏览器的地址栏中获取知识库详情页的链接地址（用于从知识库列表中直接跳转到第三方知识库详情页）。
   图3 RAGFlow知识库详情页
   

连接外部知识库

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择进入所需空间。

   如果已选择团队空间，界面显示为实际的团队空间名称，而非“个人空间”。

   图4 选择团队空间
   

2. 在左侧导航栏中选择“开发中心 > 知识库”。
3. 选择“连接外部知识库”页签，单击“连接外部知识库”。
4. 在弹出的对话框中，参见表1设置外部知识库基本信息。
   图5 连接外部知识库
   

   表1 参数说明

   参数		示例	说明
   基本信息	选择知识库类型	RAGFlow	需要连接的第三方知识库类型，当前版本仅支持对接RAGFlow。
   	知识库名称	张三的RAGFlow	自定义第三方知识库的名称。
   	描述	人才政策知识库	第三方知识库的相关描述。
   	知识库图标	使用系统默认图标	上传LOGO，也可不上传，自动使用系统默认图标。
   连接信息	知识库详情页面链接	http://xxxxx/knowledge/dataset?id={{id}}	填入准备工作步骤3中获取的第三方知识库详情页的访问链接。注意需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。
   	服务地址	https://xxx.com	填入准备工作步骤2中获取的API服务地址。
   	API Key	sk-xxxxxxxx	填入准备工作步骤2中获取的API Key。

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

新建第三方知识库

1. 在左侧导航栏中选择“开发中心 > 知识库”，单击左上角“新建知识库”。
2. 在“选择创建类型”弹框中选择“第三方”，单击“确定”。
3. 在“接入第三方知识库”界面中，单击“选择接入知识库类型”下拉框，从中选择需要接入的第三方知识库“张三的RAGFlow”。
4. 在“知识库列表”中勾选添加所需知识库，取值示例：人才政策知识库。
   图6 接入第三方知识库
   

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

命中测试

1. 在左侧导航栏中选择“开发中心 > 知识库”。
2. 在知识库列表中，单击操作列的“命中测试”。
3. 在命中测试页面左侧文本框中输入问题，单击“命中测试”。

   在命中测试页面右侧将根据语义检索方式，展示多条匹配的内容，并按照匹配分值降序排列。

4. 用户可以根据分值与匹配到的信息数量来评估当前知识库是否满足需求。如果满足需求，则知识库接入完成，您可以在智能体或工作流中使用该知识库。
   图7 命中测试结果
   

相关文档

• 接入第三方知识库的详细信息，请参考《用户指南》“管理资源>知识库>创建本地知识库”。
• 接入第三方知识库相关问题请参考《常见问题》的“知识库”章节。