连接KooSearch知识库

1. 确保需要连接的第三方KooSearch知识库平台已经开通了华为云KooSearch服务，并购买了相关资费套餐。第三方KooSearch的拥有者需要发布搜索知识库和获取知识库列表的两个API接口供后续使用者在Versatile平台调用。发布API接口请参考通过API使用KooSearch实现搜索问答。
2. 在KooSearch中创建一个知识库，并上传相关文档。
   图1 KooSearch中的知识库
   

3. 获取KooSearch服务地址：可以参考KooSearch接口获取获取APIG公网地址，也可以参考以下步骤：
   1. 登录KooSearch绑定的APIG服务，在“apig接口 > 实例管理”中单击实例名称。
      图2 实例名称
      
   2. 在“实例信息”页签中找到并复制“弹性IP地址”，该弹性IP地址就是KooSearch的服务地址。
      图3 弹性IP地址
      

4. 获取项目id请参考获取KooSearch服务的项目id。
5. 获取应用id请参考获取KooSearch服务的应用id。
6. 获取APIG凭证请参考获取KooSearch服务的APIG凭证的APP认证部分。
7. 获取KooSearch知识库详情页面链接。
   1. 登录KooSearch主页，单击需要接入的知识库，进入KooSearch知识库详情页面。
      图4 KooSearch知识库列表
      
   2. 复制浏览器地址栏中的链接，该链接就是KooSearch知识库详情页面的链接。
      图5 知识库详情页面链接
      

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏中选择“开发中心 > 知识库”。
3. 选择“外部知识库连接”页签，单击“连接外部知识库”。
4. 在弹出的对话框中，参见表1设置连接KooSearch外部知识库基本信息。
   图6 连接外部知识库
   

   表1 参数说明

   参数		说明	示例
   基本信息	选择知识库类型	必选参数。 选择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，用于认证鉴权。	b099xxxxxxxx
   	知识库详情页面链接	第三方KooSearch知识库详情页面的链接，可通过该页面直接访问KooSearch知识库的详情页面。 注意需要使用占位符{{id}}表示知识库ID，否则无法跳转到对应的知识库页面。	https://xxxxx.com/xxxx?id={{id}}

5. 单击“测试连接”，弹出“测试成功”提示。
6. 单击“确定”完成KooSearch知识库平台连接。连接成功后可以在“外部知识库连接”页签中查看。

Versatile通过连接外部知识库，可以显著扩展内部知识库的知识范围，引入更多领域和更广泛的信息资源，从而提高知识库的全面性和深度。

前提条件

已完成连接KooSearch外部知识库。

操作步骤

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏中选择“开发中心 > 知识库”，单击左上角“新建知识库”。
3. 在“选择创建类型”弹框中选择“第三方”，单击“确定”。
4. 在“接入第三方知识库”界面中，单击“选择接入知识库类型”下拉框，从中选择需要接入的第三方知识库，“选择接入知识库类型”取值示例：第三方KooSearch。
5. 在“知识库列表”中勾选添加所需知识库，单击将其添加到右侧的“已选项”中。取值示例：自动化知识库。
   图7 接入第三方知识库
   

6. 单击“确定”，完成接入第三方知识库创建。创建完成后，可以在“接入第三方知识库 ”界面中查看接入的外部知识库。

   创建完成的知识库，默认是启用状态。

Versatile通过对创建的知识库进行命中率测试，以评估知识库的效果和准确性。

前提条件

已经创建KooSearch第三方知识库。

操作步骤

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 在左侧导航栏中选择“开发中心 > 知识库”。
3. 在知识库列表中，单击操作列的“命中测试”。
4. 在命中测试页面左侧文本框中输入问题，单击“命中测试”。

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

   用户可以根据分值与匹配到的信息数量来评估当前知识库是否满足需求。

5. 单击右上角的“查看历史”，可以查看用户输入的历史问题。

知识库创建完成后，您可以执行如表2的操作。

知识库支持以列表和卡片形式展示。单击搜索框右侧按钮，知识库将以列表形式展示。单击搜索框右侧按钮，知识库将以卡片形式展示。