# 连接RAGFlow知识库
AgentArts支持连接外部知识库，通过连接外部知识库，可以显著扩展内部知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。
本文将介绍如何在AgentArts对接第三方RAGFlow知识库。
图1连接RAGFlow知识库流程   
![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538543088.png)
#### 约束与限制
当资源数量达到上限时，请删除不再使用的资源以释放配额：
- **外部知识库连接** ：进入 "外部知识库连接" 页签进行删除。具体操作请参考[管理知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0287.html)中的"删除外部知识库连接信息"。
- **第三方知识库** ：进入 "知识库" 页签进行删除。具体操作请参考[管理知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0287.html)中的"取消接入"。
关于知识库的更多约束与限制，请参考[知识库使用限制](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0149.html)。
#### 步骤一：准备工作
- 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考[管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.html)。
- 获取第三方RAGFlow知识库的连接信息：
  1. 在RAGFlow里创建一个知识库，并上传相关文档。
     图2RAGFlow中的知识库   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538383154.png) 
  
  2. 在RAGFlow"个人中心 \> API"中获取RAGFlow的连接信息。
     图3RAGFlow连接信息   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422821.png) 
  
  3. 在知识库列表中选中第三方知识库，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538543098.png)复制知识库地址，在新浏览器窗口的地址栏中粘贴该链接并访问，即可直接跳转到第三方知识库的详情页。
     图4复制知识库地址   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538383120.png)
     图5RAGFlow知识库详情页   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422799.png) 
   
 
 #### 步骤二：连接RAGFlow外部知识库
1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
2. 在左侧导航栏中选择"开发中心 \> 组件库"。
3. 选择"知识库"页签，切换至"外部知识库连接"页面，单击"连接外部知识库"。
4. 在弹出的对话框中，参见[表1]设置外部知识库基本信息。
   
   图6连接外部知识库   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538543068.png)
    表1参数说明 
   | 参数              || 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 示例                                           |
   |:---|---|:---|:---|
   | 基本信息 | 选择知识库类型   | - General  - RAGFlow  - KooSearch                                                                                                                                                                                                                         | RAGFlow                                      |
   | 基本信息 | 知识库名称     | 用于标识知识库。它是用户在创建知识库时必须填写的字段。 命名规则： - 命名要求：仅支持以字母、数字、或中文开头。  - 支持字符：中英文、数字、中划线（-）、下划线（_）。  - 长度限制：1\~50个字符。                                          | B030_ragflow_kv04                            |
   | 基本信息 | 描述（非必填）   | 用于简要说明知识库内容和用途。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。 命名规则：长度不大于255个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 外部知识库                                        |
   | 基本信息 | 知识库图标     | 知识库图标。单击当前显示的知识库图标，在弹出的对话框中，选择要上传的新图标文件。 支持jpg、jpeg、png及gif格式，大小不大于200KB。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 默认                                           |
   | 连接信息 | 服务地址      | 能够访问检索接口及查询列表接口的地址。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | https://xxx.com                              |
   | 连接信息 | APIKey    | 用于访问第三方RAGFlow知识库的鉴权密钥。 **关于密钥加密：** 鼠标移动至"APIKey"右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422813.png)上，可参看密钥的加密方式。平台默认使用**KMS加密+默认密钥** 方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。  - 费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考[更换密钥的加密方式](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0288.html)。   | sk-xxxxxxxx                                  |
   | 连接信息 | 知识库详情页面链接 | 第三方RAGFlow知识库详情页面的链接，可通过该页面直接访问RAGFlow知识库的详情页面。注意需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | http://xxxxx.com/knowledge/dataset?id={{id}} |
      
   
   
5. 单击"测试连接"，弹出"测试成功"提示。 
   如果显示"第三方知识库连接失败，请检查连接地址和认证信息"，请检查RAGFlow服务是否支持在公网使用API访问。
   
   
6. 单击"确定"，完成RAGFlow知识库连接。连接成功后可以在"外部知识库连接"页签中查看。
 
#### 步骤三：创建RAGFlow第三方知识库
已完成[步骤二：连接RAGFlow外部知识库]。
1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
2. 在左侧导航栏中选择"开发中心 \> 组件库"。
3. 选择"知识库"页签，在"知识库"页面，单击"创建知识库"。
4. 在"选择创建类型"弹框中选择"第三方"，单击"确定"。
5. 在"接入第三方知识库"界面中，单击"选择接入知识库类型"下拉框，从中选择需要接入的第三方知识库，"选择接入知识库类型"取值示例：B030_ragflow_kv04。
6. 在"知识库列表"中勾选添加所需知识库，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569342809.png)将其添加到右侧的"已选项"中。取值示例：rag_kv01。
   
   图7接入第三方知识库   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538383146.png)
   
   
7. 单击"确定"，完成接入第三方知识库创建。创建完成后，可以在"知识库 "界面中查看接入的外部知识库。 
   创建完成的知识库，默认是启用状态。