知识库检索
应用基于知识库内容作答时,检索结果出现相同关键词,不代表包含了直接依据。使用原生知识库的 召回测试,可以输入问题、调整召回方式和过滤条件,再将检索内容与原文对照,验证检索结果能否支撑可追溯的回答。本页同时说明 MCP 检索工具的参数,方便应用使用相同的检索设置。
前提条件
-
已有工作空间,且已创建目标原生知识库。
-
目标文件已上传至知识库,且 概览 中的文件状态为就绪,并已通过 查看 检查正文和分块。
-
如需按业务分类筛选资料,已在模板声明对应的 Metadata 字段,且目标文档已具有相应值。
发起召回测试
-
在工作空间左侧栏进入 AGENT 上下文 > 知识库,打开目标原生库。
-
进入 召回测试,把一个资料中确有依据的问题填入 查询文本。
-
库采用默认检索配置时,可先按默认值测试:双路召回、TopK 10、RRF k 60,保持 启用 Rerank 精排 未勾选。各参数的含义与取值范围见选择召回方式与数量。
-
需要限定资料范围时设置 Metadata 过滤条件,再单击 开始测试。
-
对照原文检查检索内容是否包含直接依据,而不只是出现了相同关键词。
例如,制度写明“员工因公出差结束后,应在 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 过滤
召回测试提供 字段、数据类型、操作符、字段值,并可通过 添加条件 增加过滤条件。
-
从 字段 选择知识库已声明的 Metadata 字段。
-
核对 数据类型,选择页面提供的 操作符 并填写 字段值。
-
需要更多条件时单击 添加条件,逐项填写后再开始测试。
过滤只能引用已声明的字段。新建库默认仅有 document_name,需要按业务分类筛选时,应在模板声明对应字段,并确认目标文档已具有相应值。
模板修改不会自动补到旧文档,只适用于后续新文档和替换产生的新版本。出现“加了过滤就找不到”的情况时,先查看文件属性中的实际 Metadata,再检查条件。
找不到内容时依次检查
-
文档是否就绪、正文是否正确。 检查文件状态和原文;文档没有写的规定,无法靠调参补出来。
-
分块是否完整并启用。 在文档详情检查条件、结论和例外,查看 启用分片 开关。分段最大长度默认 512,范围 1~6000 字符,详见切片与向量化。
-
过滤条件是否排除了目标资料。 核对字段是否声明、文档是否赋值,以及类型和条件是否符合预期。
-
调整数量和排序。 对同一问题分别调整 TopK、融合算法或 Rerank,避免一次改动多项后无法判断原因。
如果检索到了新旧两版制度,应先核对适用对象和生效日期,再处理失效或重复资料。
将检索内容用于回答
应用应依据片段中的直接信息作答,并提供可追溯的来源。相关性高只表示内容与问题可能有关,不能证明条款现行有效,也不能证明答案一定正确。
对有访问限制的资料,应由服务在返回正文前完成权限检查,而不是把正文交给 Agent 后再要求它拒答。Metadata 过滤是检索范围设置,不能替代权限校验。