# 在单智能体中使用知识库
支持在AgentArts中添加引用知识库，以根据用户意图来检索召回对应的知识切片。
通过关联知识库，智能体可在回答用户问题前，先从私有知识库中检索相关信息，从而基于私有数据生成准确回答，有效减少模型幻觉。
**典型使用场景**：
- 企业内部知识问答：员工可通过智能体查询公司制度、流程规范等。
- 产品文档查询：基于产品手册回答用户技术问题。
- 私有数据问答：基于企业专属数据生成回答，避免通用模型的局限性。
#### 费用说明
使用知识库进行对话时，检索召回的内容将作为上下文输入大模型，这会增加Token消耗，请关注用量成本。检索召回的切片数量（topk设置）直接影响Token消耗，建议根据实际需求调整。
#### 前提条件
- 如果需要在单智能体中使用本地知识库，请确保已[创建平台知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0150.html)且知识库是启用状态。
- 如果需要在单智能体中使用第三方知识库，请确保已[接入第三方知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0164.html)且知识库是启用状态。
 
#### 配置知识库
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"单智能体"页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在"单智能体配置"页签中，在"知识库"模块，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389491.png)。
4. 在"添加知识库"窗口，选择知识库类型，勾选目标知识库右侧的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389495.png)进行添加，单击"确定"完成知识库添加。
   
   图1添加知识库   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549371.png "点击放大")
   
   
5. 单击"知识库"模块的![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549365.png "点击放大")按钮，弹出配置弹窗。
   
   图2高级配置   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949740.png)
   
   
6. 参见[表1]设置参数。
   
    表1参数说明 
   | 参数       | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 示例    |
   |:---|:---|:---|
   | 检索策略     | 检索策略，文档检索的方式，有三种： - 语义检索，使用向量检索技术检索，对文档及结构化数据中知识进行检索，召回与用户意图相关性高的切片内容，推荐在需要结合上下文相关性、并对用户意图进行理解场景中使用。  - 关键词检索，使用倒排检索技术，对文档及结构化数据中知识进行检索，召回与Query关键词匹配度高的切片内容，推荐在需要用户提问关键词匹配度高的场景中使用。  - 混合检索，使用向量检索和关键词检索两种策略混合检索知识库，推荐在需要兼顾用户意图理解及关键词匹配度场景中使用。   | 语义检索  |
   | 相关度阈值    | 超过相关度阈值的搜索结果会提交给大模型进行总结，否则被过滤，可以参考知识库中命中测试的相关度分值调整该阈值。 **取值范围**：0\~1。 **默认值**：0.5。                                                                                                                                                                                                                                                                                                                                                      | 0.500 |
   | topk召回数量 | 召回相关性排名前topk的切片数量，如topk召回数量为5，则相关性排名前5的切片将被召回提交给大模型总结。 取值范围：1\~50。 默认值：3。                                                                                                                                                                                                                                                                                                                                                                  | 3     |
   | FAQ直出阈值  | FAQ检索超过阈值的结果将直接提交给大模型总结，不再进行文档检索。如果没有超过阈值的结果，将进行文档检索。 **取值范围**：0\~1。 启用FAQ功能后，系统将优先检索FAQ数据。如果未命中结果，则会继续查询切片内容，可能会带来一定的性能开销。当FAQ检索结果超过预设阈值时，将直接提交给大模型进行总结，不再进行文档检索。如果未超过阈值，则将继续进行文档检索。                                                                                                                                                                                                                                                 | 0.900 |
   | 查看来源     | 添加知识库并开启此功能后，可以在预览调试界面中查看搜索结果的详细来源信息，包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。                                                                                                                                                                                                                                                                                                                                                                                                                                        | 开启    |
   | 查看图片     | 开启此功能后，当知识库支持图片检索时，可查看检索结果中的图片信息。 说明： 此功能仅在知识库包含图片数据且支持图片检索时生效。                                                                                                                                                                                                                                                                                                                                                                        | 开启    |
      
   
   
7. 单击其他位置退出弹窗，完成配置。 
   配置完成后，在"知识库"模块中可看到已添加的知识库卡片。您可以在单智能体界面的"预览调试"区域进行对话测试，验证知识库是否生效。在预览调试区域输入与知识库内容相关的问题，观察回答是否引用了知识库信息。开启"查看来源"功能后，可查看引用的具体切片来源。
   
   
 
#### 常见问题
**为什么检索不到知识库内容？**
- 可能原因：阈值设置太高；检索词语、策略不合适；精排模型不可用。
- 解决措施：调整阈值大小；修改检索词语、策略；在KooSearch服务中确认精排模型正常。
 
**如何提升知识库检索准确率？**
1. 优化文档结构：无结构的文档，转化为有层次结构的文档。
2. **团队标准版** 、**团队高级版** 、**企业专业版** 或**企业旗舰版** 支持更换接入的其他模型。
   **当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)咨询购买相关事宜。**
   
3. 修改知识库的分段设置。