知识库检索

更新时间:
复制 MD 格式

应用基于知识库内容作答时,检索结果出现相同关键词,不代表包含了直接依据。使用原生知识库的 召回测试,可以输入问题、调整召回方式和过滤条件,再将检索内容与原文对照,验证检索结果能否支撑可追溯的回答。本页同时说明 MCP 检索工具的参数,方便应用使用相同的检索设置。

前提条件

  • 已有工作空间,且已创建目标原生知识库。

  • 目标文件已上传至知识库,且 概览 中的文件状态为就绪,并已通过 查看 检查正文和分块。

  • 如需按业务分类筛选资料,已在模板声明对应的 Metadata 字段,且目标文档已具有相应值。

发起召回测试

  1. 在工作空间左侧栏进入 AGENT 上下文 > 知识库,打开目标原生库。

  2. 进入 召回测试,把一个资料中确有依据的问题填入 查询文本。

  3. 库采用默认检索配置时,可先按默认值测试:双路召回、TopK 10、RRF k 60,保持 启用 Rerank 精排 未勾选。各参数的含义与取值范围见选择召回方式与数量。

  4. 需要限定资料范围时设置 Metadata 过滤条件,再单击 开始测试。

  5. 对照原文检查检索内容是否包含直接依据,而不只是出现了相同关键词。

例如,制度写明“员工因公出差结束后,应在 10 个工作日内提交报销申请”,测试“出差回来多久内要报销”时,需要同时找到期限和适用条件。

选择召回方式与数量

配置 默认值与范围 使用说明
召回模式 默认双路,即全文 + 向量 全文按词语匹配;向量按语义匹配;双路结合两者
TopK 默认 10,范围 1~100 最终最多返回的片段数量,实际可能更少,不是每路的候选数量
融合算法 默认 RRF,可选加权融合 用于合并双路召回结果
RRF 参数 k 默认 60,控制台范围 1~200 用于排名计算,与 TopK 的数量限制不同
向量权重 选择加权融合后显示 0.7,范围 0~1 全文权重为 1 减去向量权重
启用 Rerank 精排 默认未勾选 开启后使用模型进一步排序,模型选项可见 qwen3-rerank

全文检索适合错误码、产品型号、制度编号等明确内容;向量检索适合“申请期限”和“多久内提交”等不同表述。比较时使用相同问题和同一份资料,每次只调整一个参数。

RRF、加权融合和 Rerank 有什么区别?

  • RRF 依据各路结果的片段排名融合,不直接相加全文与向量的原始分数。k 是排名计算参数,不表示返回多少条。

  • 加权融合 使用设定的全文和向量权重。向量权重为 0.7 时,全文权重为 0.3;两者之和为 1。

  • Rerank 再用模型评估问题与片段的相关性,不等同于双路融合。创建页的 模型排序 默认关闭,开启后显示 qwen3-rerank 和 刷新模型;不支持添加自定义模型。

使用 Metadata 过滤

召回测试提供 字段、数据类型、操作符、字段值,并可通过 添加条件 增加过滤条件。

  1. 从 字段 选择知识库已声明的 Metadata 字段。

  2. 核对 数据类型,选择页面提供的 操作符 并填写 字段值。

  3. 需要更多条件时单击 添加条件,逐项填写后再开始测试。

过滤只能引用已声明的字段。新建库默认仅有 document_name,需要按业务分类筛选时,应在模板声明对应字段,并确认目标文档已具有相应值。

重要

模板修改不会自动补到旧文档,只适用于后续新文档和替换产生的新版本。出现“加了过滤就找不到”的情况时,先查看文件属性中的实际 Metadata,再检查条件。

找不到内容时依次检查

  1. 文档是否就绪、正文是否正确。 检查文件状态和原文;文档没有写的规定,无法靠调参补出来。

  2. 分块是否完整并启用。 在文档详情检查条件、结论和例外,查看 启用分片 开关。分段最大长度默认 512,范围 1~6000 字符,详见切片与向量化。

  3. 过滤条件是否排除了目标资料。 核对字段是否声明、文档是否赋值,以及类型和条件是否符合预期。

  4. 调整数量和排序。 对同一问题分别调整 TopK、融合算法或 Rerank,避免一次改动多项后无法判断原因。

如果检索到了新旧两版制度,应先核对适用对象和生效日期,再处理失效或重复资料。

将检索内容用于回答

应用应依据片段中的直接信息作答,并提供可追溯的来源。相关性高只表示内容与问题可能有关,不能证明条款现行有效,也不能证明答案一定正确。

重要

对有访问限制的资料,应由服务在返回正文前完成权限检查,而不是把正文交给 Agent 后再要求它拒答。Metadata 过滤是检索范围设置,不能替代权限校验。