# 在单智能体中使用知识库
支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。
#### 前提条件
- 登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考[管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.html)。
- 如果需要在单智能体中使用本地知识库，请确保已[创建平台默认知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0150.html)且知识库是启用状态。
- 如果需要在单智能体中使用第三方知识库，请确保已[接入第三方知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0164.html)且知识库是启用状态。
 
#### 配置知识库
1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"单智能体"页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在"单智能体配置"页签中，在"知识库"模块，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569344657.png)。
4. 在"添加知识库"窗口，选择知识库类型，勾选目标知识库右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544886.png)进行添加，单击"确定"。
   
   图1添加知识库   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544888.png)
   
   
5. 单击所需的知识库，单击"确定"完成知识库添加。
6. 单击"知识库"模块的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384938.png)按钮，弹出配置弹窗。
   
   图2高级配置   
   ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384944.png)
   
   
7. 参见[表1]设置参数。
   
    表1参数说明 
   | 参数       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 示例    |
   |:---|:---|:---|
   | 知识库检索策略  | 检索策略，文档检索的方式，有三种： - 语义检索，使用向量检索技术检索，对文档及结构化数据中知识进行检索，召回与用户意图相关性高的切片内容，推荐在需要结合上下文相关性、并对用户意图理解场景中使用。  - 关键词检索，使用倒排检索技术，对文档及结构化数据中知识进行检索，召回与Query关键词匹配度高的切片内容，推荐在需要用户提问关键词匹配度高的场景中使用。  - 混合检索，使用向量检索和关键词检索两种策略混合检索知识库，推荐在需要兼顾用户意图理解及关键词匹配度场景中使用。   | 语义检索  |
   | 相关度阈值    | 超过相关度阈值的搜索结果会提交给大模型进行总结，否则被过滤，可以参考知识库中命中测试的相关度分值调整该阈值。 取值范围：0\~1 默认值：0.500                                                                                                                                                                                                                                                                                                                                                               | 0.500 |
   | topk召回数量 | 召回的相关性阈值top切片数量，如topk召回数量为5，则相关性阈值为前5的切片将被召回提交给大模型总结。 取值范围：1\~50 默认值：3                                                                                                                                                                                                                                                                                                                                                                   | 3     |
   | FAQ直出阈值  | FAQ检索超过阈值的结果将直接提交给大模型总结，不再进行文档检索。如果没有超过阈值的结果，将进行文档检索。 取值范围为0\~1。 启用FAQ功能后，系统将优先检索FAQ数据。如果未命中结果，则会继续查询切片内容，可能会带来一定的性能开销。当FAQ检索结果超过预设阈值时，将直接提交给大模型进行总结，不再进行文档检索。如果未超过阈值，则将继续进行文档检索。                                                                                                                                                                                                                                                   | 0.900 |
   | 查看来源     | 添加知识库并开启此功能后，可以在预览调试界面中查看搜索结果的详细来源信息，包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。                                                                                                                                                                                                                                                                                                                                                                                                                                      | 开启    |
   | 查看图片     | 开启后此功能后，当知识库支持图片检索时，可查看检索结果中的图片信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 开启    |
      
   
   
8. 单击其他位置退出弹窗，完成配置。