# 连接KooSearch知识库 AgentArts支持连接外部知识库平台，以便用户访问和利用外部的知识资源。 KooSearch可以帮助企业搭建企业级RAG，提升用户获取企业私有知识的效率，同时提供联网增强功能，提供互联网公域知识问答能力。主要用于智能客服应用、数字人、数字员工、AI助手、AI搜索等知识问答场景。 本文将介绍如何在AgentArts对接第三方KooSearch知识库。 图1连接KooSearch知识库流程 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385344.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)。 - 获取第三方KooSearch知识库的连接信息： 1. 确保需要连接的第三方KooSearch知识库平台已经开通了华为云KooSearch服务，并购买了相关资费套餐。第三方KooSearch的拥有者需要发布**搜索知识库** 和**获取知识库列表** 的两个API接口供后续使用者在AgentArts平台调用。发布API接口请参考[通过API使用KooSearch实现搜索问答](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_0007.html)。 2. 在KooSearch中创建一个知识库，并上传相关文档。 图2KooSearch中的知识库 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538545276.png) 3. 获取KooSearch服务地址：可以参考[KooSearch接口获取](https://support.huaweicloud.com/api-koosearch/koosearch_08_0006.html)获取APIG公网地址，也可以参考以下步骤： 1. 登录KooSearch绑定的APIG服务，在"apig接口 \> 实例管理"中单击实例名称。 图3实例名称 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385320.png) 2. 在"实例信息"页签中找到并复制"弹性IP地址"，该弹性IP地址就是KooSearch的服务地址。 图4弹性IP地址 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385332.png) 4. 获取项目id请参考[获取KooSearch服务的项目id](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 5. 获取应用id请参考[获取KooSearch服务的应用id](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 6. 获取APIG凭证请参考[获取KooSearch服务的APIG凭证](https://support.huaweicloud.com/api-koosearch/koosearch_06_0009.html)的APP认证部分。 7. 获取KooSearch知识库详情页面链接。 1. 登录KooSearch主页，单击需要接入的知识库，进入KooSearch知识库详情页面。 图5KooSearch知识库列表 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538545264.png) 2. 复制浏览器地址栏中的链接，该链接就是KooSearch知识库详情页面的链接。 图6知识库详情页面链接 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569345033.png) #### 步骤二：连接KooSearch外部知识库 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 在左侧导航栏中选择"开发中心 \> 组件库"。 3. 选择"知识库"页签，切换至"外部知识库连接"页面，单击"连接外部知识库"。 4. 在弹出的对话框中，选择"KooSearch"知识库类型，参见[表1]设置连接KooSearch外部知识库基本信息。 表1参数说明 | 参数 || 说明 | 示例 | |:---|---|:---|:---| | 基本信息 | 选择知识库类型 | - General - RAGFlow - KooSearch | KooSearch | | 基本信息 | 知识库名称 | 用于标识知识库。它是用户在创建知识库时必须填写的字段。 命名规则： - 命名要求：仅支持以字母、数字、或中文开头。 - 支持字符：中英文、数字、中划线（-）、下划线（_）。 - 长度限制：1\~50个字符。 | 第三方KooSearch | | 基本信息 | 描述（非必填） | 用于简要说明知识库内容和用途。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。 命名规则：长度不大于255个字符。 | 外部知识库 | | 基本信息 | 知识库图标 | 知识库图标。单击当前显示的知识库图标，在弹出的对话框中，选择要上传的新图标文件。 支持jpg、jpeg、png及gif格式，大小不大于200KB。 | 默认 | | 连接信息 | 服务地址 | 能够访问检索接口及查询列表接口的地址，以https://或http://开头。 | https://xxx.com | | 连接信息 | 项目id | 登录KooSearch知识库平台账号的项目ID。 | 0503dda8970xxxxxx | | 连接信息 | 应用id | KooSearch知识库平台的应用ID。 | 9ae90c5e53xxxxxx | | 连接信息 | APIG凭证 | KooSearch平台接口绑定的APIG凭证的AppCode，用于认证鉴权。 **关于密钥加密：** 鼠标移动至"APIG凭证"右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385336.png)上，可参看密钥的加密方式。平台默认使用**KMS加密 + 默认密钥** 方式对认证密钥进行加密存储，防止信息泄露。 - 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。 - 费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考[更换密钥的加密方式](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0288.html)。 | b099xxxxxxxx | | 连接信息 | 知识库详情页面链接 | 第三方KooSearch知识库详情页面的链接，可通过该页面直接访问KooSearch知识库的详情页面。 注意需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。 | https://xxxxx.com/xxxx?id={{id}} | 5. 单击"测试连接"，弹出"测试成功"提示。 6. 单击"确定"完成KooSearch知识库平台连接。连接成功后可以在"外部知识库连接"页签中查看。 #### 步骤三：创建KooSearch第三方知识库 AgentArts通过连接外部知识库，可以显著扩展知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。 已完成[步骤二：连接KooSearch外部知识库]。 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 在左侧导航栏中选择"开发中心 \> 组件库"。 3. 选择"知识库"页签，在"知识库"页面，单击"创建知识库"。 4. 在"选择创建类型"弹框中选择"第三方"，单击"确定"。 5. 在"接入第三方知识库"界面中，单击"选择接入知识库类型"下拉框，从中选择需要接入的第三方知识库，"选择接入知识库类型"取值示例：第三方KooSearch。 6. 在"知识库列表"中勾选添加所需知识库，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538545270.png)将其添加到右侧的"已选项"中。取值示例：自动化知识库。 图7接入第三方知识库 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538545282.png) 7. 单击"确定"，完成接入第三方知识库创建。创建完成后，可以在"接入第三方知识库 "界面中查看接入的外部知识库。 创建完成的知识库，默认是启用状态。