跳到主要内容
版本:2.0.x

让 Agent 查阅知识库

为 Agent 添加知识库后,AI 在回答前可以从知识库中检索相关信息,提升回答的准确性和时效性。

知识库适合承载事实资料,例如产品手册、制度文件、FAQ、历史文档、网页资料和操作说明。它解决的是“根据哪些资料回答”的问题;如果要规范 Agent “应该怎么处理任务”,更适合使用 AI技能

为主 Agent 配置知识库

在 Agent 编辑器中进入 能力编排 -> 知识库,支持三种模式:

  • 智能模式:系统自动收集应用中的可用知识库,Agent 根据任务自行判断是否需要查询
  • 自定义:手动搜索并勾选当前 Agent 可用的知识库
  • 禁用:Agent 不会感知知识库的存在,也不会暴露查询知识库的工具

选择自定义后,页面会显示知识库搜索框和知识库列表:

  • 可按知识库标题、描述或完整名称搜索。
  • 勾选目标知识库后,列表会显示已选数量。
  • 已勾选的知识库会进入当前 Agent 的可用知识库范围。

配置每个知识库的查询策略

在自定义模式下勾选知识库后,每个知识库附带一个"允许 Agent 自主决定查询"选项:

  • 勾选(默认):Agent 拥有查询工具,自行判断是否需要查询该知识库
  • 取消勾选:每次对话前系统自动预检索该知识库,将结果注入到提示词上下文中;Agent 仍然持有查询工具,可在后续对话中自主使用。适合必须依赖特定知识的场景。

这不是权限控制。它只影响知识库是否被加载、是否预检索以及是否向 Agent 暴露查询工具。真正的访问控制应在为 Agent 配置运行时权限边界中配置。

为 DeepAgent 的子 Agent 配置专属知识库

DeepAgent 的 能力编排 -> 子 Agent 用于选择可被委派的 ReActAgent 类型 Agent,不是在这里直接编辑子 Agent 的知识库。每个子 Agent 的知识库,需要到对应 ReActAgent 实例自己的编辑器中配置。

配置顺序通常是:

  1. 创建或打开将作为子 Agent 使用的 ReActAgent。
  2. 在该 ReActAgent 的 能力编排 -> 知识库 中配置知识库模式、可用知识库和允许 Agent 自主决定查询
  3. 打开 DeepAgent,在 能力编排 -> 子 Agent 中使用智能模式自定义模式,让 DeepAgent 能够委派这些 ReActAgent 类型 Agent。

这适合多角色协作场景。例如父 Agent 负责任务拆解,政策解读 Agent只接入制度知识库,产品支持 Agent只接入产品手册知识库,数据分析 Agent禁用知识库并专注调用数据模型工具。

子 Agent 的知识库配置只影响该 ReActAgent 自己的运行上下文。父 Agent 的知识库配置不会自动等同于每个子 Agent 的知识库配置;需要不同角色查阅不同资料时,应在对应 Agent 实例中分别配置。

关于知识库的创建,请参考创建可被 Agent 检索的 AI 知识库。关于知识库资料维护和查询测试,请参考管理知识库资料并验证检索效果

什么时候用知识库,什么时候用 AI技能

需求推荐能力
根据产品文档、制度条款、FAQ 回答问题知识库
让 Agent 按固定流程审核、分类、生成建议AI技能
查询或修改业务数据库数据模型工具
执行复杂业务动作服务函数工具

一个常见组合是:知识库存放产品资料,AI技能规定回答口径和处理步骤,Agent 根据用户问题检索资料并按 AI技能的规则输出。

如何验证知识库效果

配置完成后,建议用三类问题测试:

  • 资料内问题:答案应能引用知识库中的事实。
  • 资料外问题:Agent 应说明资料中没有明确依据,不要编造。
  • 需要流程判断的问题:如果答案不仅依赖资料,还依赖处理流程,应结合 AI技能或系统提示词补充规则。

如果 Agent 经常不查知识库,优先检查知识库名称、描述和 Agent 的提示词中是否明确要求“涉及产品、制度、流程问题时先检索知识库”。