# 连接General知识库 适用于企业已有现成知识库系统（如自研知识库、RAGFlow等），希望直接对接复用，避免数据迁移的场景。 目前业界有诸多知识库种类，但并没有一个统一的规范。对于用户自开发的知识库平台，AgentArts提供了[第三方通用知识库接入规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0246.html)。知识库的开发者参考此规范进行适配后，即能够作为第三方知识库接入AgentArts平台。 本文将介绍如何在AgentArts对接第三方General知识库。 图1连接General知识库流程 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790344.png) #### 费用说明 调用第三方知识库接口可能产生第三方平台的相关费用，请确保第三方服务账户状态正常。 #### 约束与限制 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/warning_3.0-zh-cn.png) 删除外部知识库连接前，请确认无智能体正在使用该连接下的知识库，否则将导致智能体问答失败。 当资源数量达到上限时，请删除不再使用的资源以释放配额： - **第三方知识库连接** ：进入 "第三方知识库连接" 页面进行删除。具体操作请参考[管理知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0287.html)中的"删除外部知识库连接信息"。删除后，基于该连接接入的知识库将不可用。 - **第三方知识库** ：进入 "知识库" 页面进行删除。具体操作请参考[管理知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0287.html)中的"取消接入"。 关于知识库的更多约束与限制，请参考[知识库使用限制](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0149.html)。 #### 步骤一：准备工作 - 用户拥有一个自开发的知识库系统（下文统称第三方知识库），并且已经按[第三方通用知识库接入规范](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0246.html)完成适配。知识库的服务接口发布到公网IP，并且可访问。 - 获取已搭建的第三方知识库连接信息： 1. 获取服务器接口地址，即第三方知识库接口的发布地址IP，例如，http://10.0.0.0:8080。 2. 获取鉴权信息密钥，该密钥是第三方知识库平台用户的认证信息，由第三方知识库提供。例如，123456789。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 用户填入时不需要在密钥开始处拼接Bearer，AgentArts平台会负责拼接操作。 3. 获取知识库详情页面链接，登录第三方知识库平台后，进入知识库详情页面，复制地址栏的URL，将其中的知识库ID替换为{{id}}。以下图RAGFlow为例，其知识库详情页面链接为：http://10.0.0.0/dataset?id={{id}} 。 该链接信息用于接入第三方知识库后，AgentArts用户可根据此链接跳转第三方知识库平台页面。如果第三方知识库只有后端服务器，没有web或前端页面，可填写http://xxx.com作为占位。 图2RAGFlow知识库详情页 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549831.png "点击放大") #### 步骤二：连接General第三方知识库 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"开发中心 \> 组件库"，选择"知识库"页签。 3. 在"知识库"页面，单击"第三方知识库连接"。 4. 在"第三方知识库连接"界面，单击"新建知识库连接"。 5. 在"创建知识库连接"页面，设置连接General知识库基本信息，参数配置请参考[表1]。 图3连接外部知识库 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790342.png "点击放大") 表1参数说明 | 参数 || 说明 | 示例 | |:---|---|:---|:---| | 基本信息 | 选择类型 | - General：用于对接用户自研知识库平台，需自行实现检索接口。 - KooSearch：用于对接华为云企业搜索服务，开箱即用。 - RAGFlow：用于对接开源项目RAGFlow，快速对接复用。 | General | | 基本信息 | 知识库名称 | 用于标识知识库。 由1\~50个字符组成，包含中文、字母、数字、中划线、下划线，且必须以中文、字母、数字开头。 | General | | 基本信息 | 描述（可选） | 用于简要说明知识库内容和用途。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。 由0\~255个字符组成。 | General知识库 | | 基本信息 | 图标 | 系统默认知识库图标，可单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950192.png)自动生成图标，也可以自定义图标。 1. 鼠标移动至图标上，单击鼠标左键。 2. 上传已准备好的知识库图标。 支持jpg、jpeg、png、gif格式图片，且不大于200KB。 | 默认 | | 连接信息 | 服务地址 | 能够访问检索接口及查询列表接口的地址，以https://或http://开头。 填入按[获取服务器接口地址，即第三方知识库接口的发布地址...]获取的信息。 | http://10.0.0.0:8080 | | 连接信息 | 鉴权信息密钥 | 在http/https的请求header中添加的用户鉴权信息密钥。 填入按[获取鉴权信息密钥，该密钥是第三方知识库平台用户的...]获取的信息。 注意： 请确保鉴权密钥来源安全，不要在非安全环境下泄露。 **关于密钥加密：** 鼠标移动至"鉴权信息密钥"右侧的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950196.png)上，可查看密钥的加密方式。平台默认使用**KMS加密 + 默认密钥** 方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。 - 费用说明：实例不收费，每月提供20,000次免费调用额度。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考[更换密钥的加密方式](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0288.html)。超出后按实际调用次数计费，详见[密码安全中心计费说明](https://support.huaweicloud.com/price-dew/dew_03_0001.html)。 | 123456789 | | 连接信息 | 知识库详情页面链接 | 第三方General知识库详情页面的链接，可通过该页面直接访问General知识库的详情页面。 填入按[获取知识库详情页面链接，登录第三方知识库平台后，...]获取的信息。 注意： 需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。 | http://10.0.0.0/dataset?id={{id}} | 6. 单击"测试连接"，弹出"测试成功"提示。 如果显示"第三方知识库连接失败，请检查连接地址和认证信息"，请参考[连接外部知识库失败如何排查？]。 7. 测试成功后，单击"确定"。 页面返回第三方知识库连接列表，连接创建成功后"状态"为"已停用"，完成[步骤三：创建General第三方知识库]后"状态"变为"已启用"。 #### 步骤三：创建General第三方知识库 在完成General知识库连接后，您可以将General中的知识库接入到AgentArts中进行使用。 已完成[步骤二：连接General第三方知识库]。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"开发中心 \> 组件库"，选择"知识库"页签。 3. 在"知识库"页面，单击"创建知识库 \> 接入第三方知识库"。 - 创建平台知识库：适用于数据在AgentArts平台直接管理的场景，支持上传文档和FAQ。具体操作请参考[创建平台知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0150.html)。 - 接入第三方知识库：适用于企业已有现成知识库（如RAGFlow），希望直接对接复用的场景。 4. 在"接入第三方知识库"界面中，选择已接入的知识库，在右侧勾选知识库。 ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 如果列表中没有需要的第三方知识库，则可以单击"新建"，新建知识库连接，具体配置请参考[表1]。 图4接入第三方知识库 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549833.png "点击放大") 5. 单击"确定"，第三方知识库创建完成。 创建完成的知识库，显示在知识库列表，"类型"为"General"，"状态"为"已启用"。 #### 相关操作 在"第三方知识库连接"页面，支持的其他操作请参考[表2]。 表2相关操作 | 操作 | 说明 | |:---|:---| | 编辑第三方知识库连接信息 | 在对应的"操作"列下，单击"编辑"，可以编辑外部知识库连接信息。 如遇连接失败，请参考[各个章节](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0164.html)的常见问题。 | | 删除第三方知识库连接信息 | 注意： 需要先取消接入后，才可以删除。 在对应的"操作"列下，单击"删除"，可以删除外部知识库连接信息。 | #### 常见问题 操作过程中如遇到以下问题，可参考对应解决方案： - [创建第三方知识库时为什么查不到知识库列表？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0027.html) - [外部知识库连接中的已启用/已停用状态如何更改？](https://support.huaweicloud.com/agentarts_faq/agentarts_09_0028.html) - **连接外部知识库失败如何排查？** - 接口返回401/403：检查鉴权信息密钥（API Key）是否正确。 - 连接超时：检查URL是否正确。 - 请检查General服务是否支持在公网使用API访问。 #### 相关文档 - 连接外部知识库后，请参考[知识库命中测试](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0171.html)校验知识库是否可用。 - 连接外部知识库后，可以对外部知识库进行管理，具体请参考[管理知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0287.html)。