RAG检索失效需分四步排查：先确认知识库状态为“已就绪”；再用召回测试判断文档解析、切分或引用环节问题；接着检查文档预处理质量及格式；最后验证AI员工任务中知识增强配置是否正确启用并保存部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
超级麦吉AI员工回答没引用你上传的知识库内容，说明RAG检索环节失效了——它没找到相关文档段落，只能靠大模型凭空编造。这不是模型能力问题，而是知识切分、向量化或检索配置出了偏差。
确认知识库是否真正生效
进入超级麦吉管理后台 → 点击「知识库」→ 查看目标知识库右侧状态栏。若显示【未启用】或【同步中（超过10分钟）】，说明文档尚未完成向量化，所有提问都走纯大模型路径。
点击“刷新状态”按钮强制重载，等待状态变为“已就绪”后再测试。不要跳过这一步，很多用户在文档刚上传就急着提问，此时向量库还是空的。
用召回测试定位具体断点
在知识库详情页找到「召回测试」功能入口，输入一个明确、带关键词的问题，例如：“JVS-BI支持连接哪些数据库？”
观察系统返回的3～5个匹配段落： ① 如果完全空白或只返回“暂无相关内容”，说明文档未被解析——大概率是扫描版PDF、加密PDF或表格密集型文件； ② 如果返回了段落但内容与问题明显无关（如问数据库却召回了安装步骤），说明chunk切分逻辑错乱； ③ 如果返回段落正确但AI最终回答里没引用任何一段，说明RAG链路中断，需检查Agent任务中是否勾选了“启用知识库增强”。
注意：召回测试必须用知识库中真实存在的术语提问，避免口语化表达。比如文档写的是“MySQL 8.0及以上版本”，你问“能连高版本MySQL吗？”可能无法命中。
检查文档预处理质量
方法一：打开任意一份已上传文档的预览页，点击右上角「查看解析结果」。重点看三处： - 文字是否完整可读（若全是方框或乱码，OCR失败）； - 表格是否被转成结构化文本（而非“[表格]”占位符）； - 每个chunk长度是否在256～512字符之间（过长会稀释关键信息，过短会丢失上下文）。
方法二：对高频失效文档，手动拆分为独立小文件再重传。例如把50页产品手册按章节拆成《数据库支持》《权限配置》《API调用》等单页Word，比一股脑传一个大PDF更利于精准检索。
扫描版PDF必须先用专业OCR工具（如Adobe Acrobat Pro）转为可选中文本PDF，再上传。直接传图格式PDF，超级麦吉无法提取任何文字。
验证AI员工任务配置
进入对应AI员工编辑页 → 找到「执行策略」模块 → 展开「知识增强」设置项：
✅ 确保开关为开启状态； ✅ 在「知识库来源」中勾选了你期望生效的具体知识库（不是“全部”）； ✅ 检查「最大引用段落数」不为0（建议设为3～5）； ❌ 若勾选了「仅使用本地知识」但该知识库为空，则自动降级为无知识模式。
修改后必须点击「保存并重新部署」，否则配置不生效。这一步漏掉会导致所有调试白费。
