先做召回测试确认知识库“记性”在线：输入原文原句、口语化表达、同义替换问法三类问题，若仅原句命中说明语义检索未生效，若全无结果需检查文档是否成功解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
扣子知识库明明上传了完整业务文档，用户问“怎么申请价保”，系统却返回“订单查询流程”或干脆说“暂未找到答案”，根本原因是召回测试没做、命中率参数没调——这不是模型问题，是检索链路断在了第一步。
先做召回测试，确认知识库“记性”是否在线
这一步不能跳，否则后续所有调优都是盲调。进入知识库详情页→点击右上角「测试」按钮→在输入框中输入3类典型问题：① 知识库原文原句（如“价保申请需提供订单号和商品照片”）；② 用户口语化表达（如“买贵了能退差价不？”）；③ 同义替换问法（如“如何获得价格保护”）。
观察右侧召回结果：若第①类能命中但②③类全漏，说明语义检索没生效；若三类都无结果，【检查文档是否已成功解析】——上传后状态栏显示“处理中”超5分钟未变，需重新上传PDF或转为纯文本再试。
分场景调整切片策略，堵住逻辑断裂漏洞
方法一：FAQ类短文档（如客服话术、政策问答） 直接启用自动切片，系统会按问答对自然分段，无需干预。
方法二：长篇业务文档（如《售后操作手册V3.2》） 必须关闭自动切片→切换至「自定义分块」→将「单块最大字符数」设为1800→关闭「重叠分块」。过大的切片会让“价保申请条件”和“退货时效说明”混在同一段，模型无法精准定位关键句。
方法三：含表格/流程图的混合文档 先导出为Word→手动在每张表格前后插入分节符→保存为PDF再上传。Coze对原生PDF表格识别极弱，不预处理会导致整张表内容被吞掉，彻底消失在召回路径中。
混合检索参数三步调优
第一步：开启查询改写 进入知识库设置→「高级配置」→打开「启用查询改写」开关。这能让“咋取消订单”自动转为“如何撤销订单”，匹配知识库标准表述。
第二步：设召回数量与最小相关度 在Agent挂载该知识库时，配置参数：召回数量固定为4（太少覆盖不全，太多噪声干扰）；最小相关度从默认0.35逐步上调至0.52——【低于0.52时误召回率陡增，高于0.55则开始漏掉合理片段】，这个阈值需配合你文档密度实测微调。
第三步：强制启用混合检索 即使界面显示“已启用”，也要手动点击「编辑检索策略」→确认勾选「关键词检索+向量检索」双通道。纯向量检索在术语密集场景（如“B2B价保SLA响应时效”）极易失焦，必须靠关键词锚定核心词。
用标签和元数据给知识片段装导航
在知识库文档上传页，点击「添加元数据」→为每份文档手动填入：业务域（如“售后”）、文档类型（如“政策”）、适用角色（如“客服专员”）。这些字段不会出现在正文里，但会在召回时作为硬过滤条件参与排序。
上传后，进入「文档管理」列表，对每条切片点击「编辑标签」→添加2～3个业务关键词（如“价保”“差价”“订单号”）。当用户问“买贵了怎么办”，系统会优先召回带“价保”标签的片段，而非仅靠向量相似度泛泛匹配。
这一步做完，测试窗口输入“价保要几天内申请”，应能稳定召回含“7个自然日内”的原始段落，且不再夹带退货、换货等无关内容。
