score threshold控制rag召回段落的余弦相似度下限,仅≥该值的段落进入prompt;默认0.4,业务中常调至0.25~0.35以平衡查全与查准;修改后实时生效,无需重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

调整Dify知识库段落相似度分数阈值(Score Threshold)直接影响RAG问答的召回精度——设得太高,可能漏掉相关段落;设得太低,会混入大量无关文本干扰大模型推理。
理解Score Threshold的实际作用
该阈值控制向大模型传递哪些知识片段:只有Embedding余弦相似度 ≥ 此值的段落才会被送入Prompt上下文。默认值0.4是通用起点,但真实业务中常需下调至0.25~0.35区间才能召回关键长尾语义匹配。
注意:此参数不改变向量索引构建过程,只在检索阶段生效,修改后无需重新上传或切分文档。
在Dify界面中定位并修改阈值
进入知识库详情页 → 点击右上角「设置」图标 → 在弹出面板中找到「检索设置」区域 → 找到「相似度分数阈值」滑块或输入框。
直接拖动滑块或手动输入数值(支持小数点后两位),输入后无需点击保存按钮,系统会自动实时生效。这一步操作起来很简单,直接改完就能看到后续测试问答的召回变化。
验证调优效果的实操步骤
第一步:准备3~5个典型用户问题,覆盖关键词精确匹配、同义替换、场景化模糊表达三类情况。
第二步:在知识库测试区依次提交这些问题,观察每次返回的「匹配段落」列表及对应「Score」字段数值。
第三步:对比不同阈值下各问题的召回结果——重点检查是否出现以下两种失败模式:【Score刚好卡在阈值边缘(如0.399→0.401)的段落被误判为不匹配】;或低分段落(如0.28)含关键答案却被过滤。
第四步:若发现关键段落Score集中分布在0.26~0.33区间,立即将阈值设为0.25并重测;若多数有效段落Score>0.45,则可尝试升至0.48以压缩噪声。











