在扣子（Coze）平台上搭建RAG知识库时，经常会遇到一个典型的检索困境。比如用户问“订单号ORD-2024-001的发货状态”，纯粹的语义向量搜索可能会给你一堆泛泛而谈“订单流程”的文档；而如果只用关键词匹配，又很容易漏掉那些语义相近但用词不同的描述，比如“物流追踪情况”或者“包裹派送进度”。

要精准命中目标，启用混合检索几乎是必经之路。它的核心价值在于，让关键词的精准匹配和语义的模糊理解，能在同一次查询中并行生效，取长补短。

确认Bot是否启用混合检索能力

操作路径很简单：进入Bot编辑页面，点击左侧的「知识库」菜单，然后留意右上角的「检索设置」按钮。如果这个按钮是灰的，或者干脆提示“当前Bot版本不支持”，那就别忙活了——这意味着你的Bot处于免费版。一个明确的限制是：免费版Bot不支持混合检索功能，没有变通方法。

你需要先将Bot升级到Pro或Enterprise版本。升级后，再次点击「检索设置」，如果弹出的窗口中间出现了「混合检索」的开关，以及「向量权重」、「关键词权重」两个滑块，那就说明能力已经就位，可以开始配置了。

配置混合检索参数

参数配置是决定混合检索效果好坏的关键，主要分三步走：

第一步：开启开关。 打开「混合检索」的开关，系统就会自动启动双路召回机制。

第二步：设定向量权重。 建议将「向量权重」滑块拖动到0.6～0.8这个区间。在大多数中文对话或客服场景下，用户的真实意图（语义）往往比他们用的具体词汇更难捕捉，因此让语义理解占主导是合理的。当然也有例外，如果你的知识库里充斥着产品编号、型号、日期这类高度结构化的字段，那么可以考虑把向量权重适当调低到0.4～0.5，给予关键词匹配更多话语权。

第三步：设定关键词权重。 相应地，「关键词权重」通常设置在0.2～0.4。这里有个误区，觉得关键词权重越低越好，其实不然。当用户非常明确地输入了“PO-2024-001”或“发片代码123456789”这样的精确字符串时，足够高的关键词权重分数，才能压制住那些语义或许相似但内容完全无关的干扰项，确保精确匹配的结果排在前面。

有一点必须注意：两个权重的滑块数值之和必须等于1。虽然系统界面没有做强制校验，但如果你手动输入数值导致总和不为1（比如设成0.7和0.5，总和1.2），保存时系统会自动按比例进行缩放（变成约0.58和0.42）。这会导致实际生效的权重和你预想的完全不同，效果自然大打折扣。

验证混合检索是否生效

配置好了，怎么知道它真的在工作呢？这里有两个实用的验证方法。

方法一：使用调试面板发起测试查询。 在Bot编辑页右上角点击「调试」，输入一个典型的混合型问题，例如：“帮我查Q3财报里提到的AI芯片型号”。然后仔细观察返回的结果列表。如果混合检索生效了，你应该能在结果顶部同时看到两类来源：一类是带着「