# 为应用添加知识库
知识库是Agent中用于存储、管理和检索领域知识的核心组件，它通过结构化存储、智能检索以及动态更新机制，为Agent提供高匹配的信息支持。
为智能体添加知识库，能够提供准确的知识支持，增强大模型回答的可靠性和专业性。知识库有助于智能体减少错误信息的生成，提高对复杂查询的处理能力。知识库支持doc、pdf、pptx、xlsx、csv等多种格式上传，通过多源知识融合和向量化处理，知识库可实现对复杂语义的理解和推理，从而为Agent的决策、问答和任务执行提供可靠的知识支撑。开发者能够灵活配置知识来源、更新策略和检索方式，确保Agent在不同场景下快速调用信息，完成智能化服务。
关于知识库的详细介绍，请参考[知识库介绍](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0148.html)。
#### 费用说明
知识库存储及检索可能产生存储费用和向量索引费用，检索结果提交给大模型也会消耗Token，请关注资源用量，详细信息请参考[计费项](https://support.huaweicloud.com/price-agentarts/agentarts_08_0003.html)。
#### 前提条件
- 如果需要在单智能体中使用本地知识库，请确保已[创建平台知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0150.html)且知识库是启用状态。
- 如果需要在单智能体中使用第三方知识库，请确保已[接入第三方知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0164.html)且知识库是启用状态。
 
#### 约束与限制
详细请参考[知识库使用限制](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0149.html)。
#### 添加知识库
应用支持添加知识库。发送消息时，应用能够引用知识库中的内容回答用户问题。
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"单智能体"页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在"知识库"模块，单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950208.png)。
4. 在"添加知识库"窗口，选择知识库类型，单击目标知识库或目标知识库后![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389971.png)进行添加，单击"确定"。
   
   图1添加知识库   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389965.png "点击放大")
   也可在"添加知识库"窗口中，通过单击"创建知识库"，您可以选择"创建平台知识库"或"接入第三方知识库"，具体步骤参见[创建平台知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0150.html)或[接入第三方知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0164.html)。创建成功后，在知识库创建成功界面单击"确定"，可立即将新创建的知识库添加至当前智能体中。
   
   
5. 添加知识库后，可在"知识库"中查看当前已添加的知识库。 
   图2已添加知识库   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389973.png)
   
   
 
#### 知识库召回策略
可单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950206.png)对知识库进行高级配置，包括检索策略和各种召回阈值。
表1配置说明 
| 分类   | 配置项      | 说明                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| 检索策略 | 语义检索     | 使用向量检索技术检索，对文档及结构化数据中知识进行检索，召回与用户意图相关性高的切片内容，推荐在需要结合上下文相关性、并对用户意图进行理解场景中使用。                                                                                                                                                                                                                                      |
| 检索策略 | 关键词检索    | 使用倒排检索技术，对文档及结构化数据中知识进行检索，召回与Query关键词匹配度高的切片内容，推荐在需要用户提问关键词匹配度高的场景中使用。                                                                                                                                                                                                                                           |
| 检索策略 | 混合检索     | 使用向量检索和关键词检索两种策略混合检索知识库，推荐在需要兼顾用户意图理解及关键词匹配度场景中使用。                                                                                                                                                                                                                                                               |
| 召回阈值 | 相关度阈值    | 超过相关度阈值的搜索结果会提交给大模型进行总结，否则被过滤，可以参考知识库中命中测试的相关度分值调整该阈值。                                                                                                                                                                                                                                                           |
| 召回阈值 | topk召回数量 | 召回的相关性阈值top切片数量，如topk召回数量为5，则相关性阈值为前5的切片将被召回提交给大模型总结。                                                                                                                                                                                                                                                            |
| 召回阈值 | FAQ直出阈值  | 注意： 启用FAQ功能且未命中阈值时，会继续查询切片内容，可能带来一定的性能开销。 当开启"启用FAQ"功能，该参数显示。 FAQ检索超过阈值的结果将直接提交给大模型总结，不再进行文档检索。如果没有超过阈值的结果，将进行文档检索。 启用FAQ功能后，系统将优先检索FAQ数据。当FAQ检索结果超过预设阈值时，将直接提交给大模型进行总结，不再进行文档检索。如果未超过阈值，则将继续进行文档检索。 |
| 查看来源 | 查看来源     | 添加知识库并开启此功能后，可以在预览调试界面中查看搜索结果的详细来源信息，包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。                                                                                                                                                                                                                                           |
| 查看图片 | 查看图片     | 开启此功能后，当知识库支持图片检索时，可查看检索结果中的图片信息。                                                                                                                                                                                                                                                                                |
   
图3知识库高级配置
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950210.png)
#### 常见问题
**为什么检索不到知识库内容？**
- 可能原因：阈值设置太高；检索词语、策略不合适；精排模型不可用。
- 解决措施：调整阈值大小；修改检索词语、策略；在KooSearch服务中确认精排模型正常。
 
**如何提升知识库检索准确率？**
1. 优化文档结构：无结构的文档，转化为有层次结构的文档。
2. **团队标准版** 、**团队高级版** 、**企业专业版** 或**企业旗舰版** 支持更换接入的其他模型。
   **当前AgentArts团队标准版、团队高级版、企业专业版、企业旗舰版未开放，如果需要购买，请[提交工单](https://console.huaweicloud.com/ticket/#/ticketindex/createIndex)咨询购买相关事宜。**
   
3. 修改知识库的分段设置。
 
#### 相关文档
AgentArts中配置知识库的详细信息，请参考[创建平台知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0150.html)。