更新时间:2026-04-15 GMT+08:00
分享

在单智能体中使用知识库

支持在AgentArts中添加引用知识库,以根据用户意图来检索召回对应的知识切片。

通过关联知识库,智能体可在回答用户问题前,先从私有知识库中检索相关信息,从而基于私有数据生成准确回答,有效减少模型幻觉。

费用说明

使用知识库进行对话时,检索召回的内容将作为上下文输入大模型,这会增加Token消耗,请关注用量成本。

前提条件

配置知识库

  1. 登录AgentArts智能体开发平台
  2. 单击左侧导航栏开发中心 > 智能体管理 ,单击左上角“单智能体”页签,进入单智能体应用管理界面。
  3. 单击目标单智能体应用,在“单智能体配置”页签中,在“知识库”模块,单击
  4. “添加知识库”窗口,选择知识库类型,勾选目标知识库右侧的进行添加,单击“确定”完成知识库添加。

    图1 添加知识库

  5. 单击“知识库”模块的按钮,弹出配置弹窗。

    图2 高级配置

  6. 参见表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

    查看来源

    添加知识库并开启此功能后,可以在预览调试界面中查看搜索结果的详细来源信息,包括上下文内容和文件名称。有助于更快速、准确地定位和理解搜索结果。

    开启

    查看图片

    开启后此功能后,当知识库支持图片检索时,可查看检索结果中的图片信息。

    说明:

    此功能仅在知识库包含图片数据且支持图片检索时生效。

    开启

  7. 单击其他位置退出弹窗,完成配置。

    配置完成后,在“知识库”模块中可看到已添加的知识库卡片。您可以在单智能体界面的“预览调试”区域进行对话测试,验证知识库是否生效。

常见问题

为什么检索不到知识库内容?
  • 可能原因:阈值设置太高;检索词语、模式不合适;精排模型不可用。
  • 解决措施:调整阈值大小;修改检索词语、模式;在KooSearch服务中确认精排模型正常。
如何提升知识库检索准确率?
  1. 优化文档结构:无结构的文档,转化为有层次结构的文档。
  2. 修改知识库的分段设置。

相关文档