检索与质量调优

命中测试（检索实验室）在不改动生产配置的前提下运行真实检索，并展示召回、融合、重排序、最终排名各阶段的中间结果。用它验证分块改动、模式切换或参数调整是否真的改善了召回。入口：知识库详情 → 命中测试（需要查看知识库并进行检索测试的权限）。

检索模式

注意默认值有两层：检索请求不指定模式时按混合执行；而知识库设置里的检索方式默认是空的，只有你显式设置后才会成为该知识库 Agent/工作流检索的默认模式。字段定义见知识库设置参考。

混合检索的可用范围

混合检索由站点管理员控制开放范围：可能对全部团队开启、全部关闭，或按团队灰度（部分团队开启）。默认按团队灰度，且默认比例是全量开启。

• 未开启混合检索的团队，即使请求了混合模式，也会按纯向量返回，界面不会单独标注“已降级”；只有某一路召回失败时，结果里才会出现降级原因。
• 如果发现「选了混合但没有关键词召回」，先向管理员确认该团队是否在开放范围内，再看结果里的降级原因是否指出向量通道失败。
• 读取站点检索设置失败时按“开启”处理，避免配置故障让检索整体不可用。

参数参考

命中测试面板可覆盖以下参数（全部可选）：

两路结果如何合并

• 混合模式：向量与全文两路结果按各自排名合并成一份排序，排名靠前的候选优先；合并只在两路都成功时发生，任一路失败会给出降级原因。
• 跨知识库：Agent/工作流关联多个知识库时，各知识库先按自己的设置并发召回，所有候选汇总到同一个池，再统一排序，而不是逐库排名后拼接。全局排序后截断到候选池大小（返回结果数与重排序候选数中的较大者）。
• 只做一次全局重排：跨库检索的重排由按知识库顺序第一个绑定了重排序模型的活跃知识库统一执行，它的候选数与分数阈值决定候选池与过滤。重排失败会让整次检索失败，不会退回未重排的融合结果。

追问改写

自动模式的 Agent 在召回前，会把带指代的追问改写成可以独立检索的查询：

• 只对自动模式生效；智能体模式与直接使用命中测试都不改写。
• 只有当追问较短且包含指代词（如「它」「这个」「上述」）时才触发，普通问题不会多调用一次模型。
• 改写失败（超时、输出不合法、模型缺失）时回退为原始查询，不会让检索失败。

A/B 对比

打开 A/B 对比 可以并排运行同一查询的两套配置：

1. 分别配置 A、B 两侧（各自独立的模式、返回结果数、阈值、重排序参数）。
2. 提交后返回每个配置独立的结果：一侧失败不会隐藏另一侧的成功结果，失败侧会单独提示原因。
3. 结果面板显示两侧的名次、重合结果数（重合结果：N/总数）与各阶段分数。

读取结果与诊断

每条结果会标注各阶段取值，可据此判断最终排序由哪个阶段决定：

阶段耗时 拆分为召回、重排、上下文装配与总耗时，可直接定位是召回慢还是重排序慢。

诊断 会说明可处理的原因：

请求失败时，界面会指出失败分类与阶段，便于区分处理方向：

应用到生产

命中测试面板的配置可以保存为本地预设（保存在浏览器本地，不跨设备同步），然后选择应用到生产把 A 侧配置写回知识库设置：检索方式、返回结果数、相似度阈值、重排序开关、重排序候选数与重排序分数阈值。

应用前请确认：

• 嵌入模型与索引维度未变化（否则先重建索引）。
• 该知识库确实被 Agent/工作流引用——写回的是知识库级默认，Agent 关联上单独设置的返回结果数、阈值或检索方式仍会覆盖它。

故障排查

常见故障和恢复步骤另见知识库设置参考；调参取舍见知识库优化。