连接KooSearch知识库
AgentArts支持连接外部知识库平台，以便用户访问和利用外部的知识资源。
KooSearch可以帮助企业搭建企业级RAG，提升用户获取企业私有知识的效率，同时提供联网增强功能，提供互联网公域知识问答能力。主要用于智能客服应用、数字人、数字员工、AI助手、AI搜索等知识问答场景。
本文将介绍如何在AgentArts对接第三方KooSearch知识库。
费用说明
通过AgentArts调用KooSearch知识库会消耗KooSearch的API调用次数及流量，请关注KooSearch服务的资源使用情况。
约束与限制
当资源数量达到上限时，请删除不再使用的资源以释放配额：
- 外部知识库连接：进入 “外部知识库连接” 页签进行删除。具体操作请参考管理知识库中的“删除外部知识库连接信息”。
- 第三方知识库：进入 “知识库” 页签进行删除。具体操作请参考管理知识库中的“取消接入”。
关于知识库的更多约束与限制，请参考知识库使用限制。
步骤一：准备工作
- 确保需要连接的第三方KooSearch知识库平台已经开通了华为云KooSearch服务，并购买了相关资费套餐。第三方KooSearch的拥有者需要发布搜索知识库和获取知识库列表的两个API接口供后续使用者在AgentArts平台调用。发布API接口请参考通过API使用KooSearch实现搜索问答。
- 在KooSearch中创建一个知识库，并上传相关文档。
图2 KooSearch中的知识库
- 获取KooSearch服务地址：可以参考KooSearch接口获取获取APIG公网地址，也可以参考以下步骤：
- 登录KooSearch绑定的APIG服务，在“apig接口 > 实例管理”中单击实例名称。
图3 实例名称
- 在“实例信息”页签中找到并复制“弹性IP地址”，该弹性IP地址就是KooSearch的服务地址。
图4 弹性IP地址
- 登录KooSearch绑定的APIG服务，在“apig接口 > 实例管理”中单击实例名称。
- 获取项目id请参考获取KooSearch服务的项目id。
- 获取应用id请参考获取KooSearch服务的应用id。
- 获取APIG凭证请参考获取KooSearch服务的APIG凭证的APP认证部分。
- 获取KooSearch知识库详情页面链接。
- 登录KooSearch主页，单击需要接入的知识库，进入KooSearch知识库详情页面。
图5 KooSearch知识库列表
- 复制浏览器地址栏中的链接，该链接就是KooSearch知识库详情页面的链接。
图6 知识库详情页面链接
- 登录KooSearch主页，单击需要接入的知识库，进入KooSearch知识库详情页面。
步骤二：连接KooSearch外部知识库
- 登录AgentArts智能体开发平台。
- 在左侧导航栏中选择“开发中心 > 组件库”。
- 选择“知识库”页签，切换至“外部知识库连接”页面，单击“连接外部知识库”。
- 在弹出的对话框中，参见表1设置连接KooSearch外部知识库基本信息。
图7 连接外部知识库
表1 参数说明 参数
说明
示例
基本信息
选择类型
- General：通用外部知识库。
- RAGFlow：适用于已自建开源RAGFlow知识库系统的场景。
- KooSearch：适用于已自建开源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凭证，避免泄露。建议定期更换凭证以确保安全。
关于密钥加密：鼠标移动至“APIG凭证”右侧的
上，可参看密钥的加密方式。平台默认使用KMS加密 + 默认密钥方式对认证密钥进行加密存储，防止信息泄露。
- 加密机制：使用用户选择的密钥派生DEK进行加密，默认密钥为kms-agentarts/default。
- 费用说明：实例不收费，每月提供20,000次免费调用次数。解密时支持缓存，但敏感数据较多时可能超出免费次数。如需更换加密方式，具体请参考更换密钥的加密方式。
b099xxxxxxxx
知识库详情页面链接
第三方KooSearch知识库详情页面的链接，可通过该页面直接访问KooSearch知识库的详情页面。
注意需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。
https://xxxxx.com/xxxx?id={{id}}
- 单击“测试连接”，弹出“测试成功”提示。
如果显示“第三方知识库连接失败，请检查连接地址和认证信息”，请检查KooSearch服务是否支持在公网使用API访问。
- 测试成功后，单击“确定”。
页面返回第三方知识库列表，可以在“外部知识库连接”页签中查看，仅接入第三方知识库，“状态”为“已停用”，创建第三方知识库后，“状态”为“已启用”。
步骤三：创建KooSearch第三方知识库
AgentArts通过连接外部知识库，可以显著扩展知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。
- 登录AgentArts智能体开发平台。
- 在左侧导航栏中选择“开发中心 > 组件库”。
- 选择“知识库”页签，在“知识库”页面，单击“创建知识库”。
- 在“选择创建类型”弹框中选择“接入第三方知识库”，单击“确定”。
- 平台知识库：适用于数据在AgentArts平台直接管理的场景，支持上传文档和FAQ。具体操作请参考创建知识库。
- 接入第三方知识库：适用于企业已有现成知识库（如RAGFlow），希望直接对接复用的场景。
- 在“接入第三方知识库”界面中，单击“请选择”下拉框，从中选择需要接入的第三方知识库，“选择接入知识库类型”取值示例：第三方KooSearch。
- 在“知识库列表”中勾选添加所需知识库，单击
将其添加到右侧的“已选项”中。取值示例：自动化知识库。
图8 接入第三方知识库
- 单击“确定”，完成接入第三方知识库创建。创建完成后，可以在“接入第三方知识库 ”界面中查看接入的外部知识库。
创建完成的知识库，默认是启用状态。
常见问题
- 创建第三方知识库时为什么查不到知识库列表？
- 外部知识库连接中的已启用/已停用状态如何更改？
- 连接KooSearch失败如何排查？
- 接口返回401/403：检查APIG凭证是否正确。
- 链接超时：检查URL是否正确。
