WFGY ProblemMap｜RAG 故障模式清单与诊断指南

用途说明

WFGY ProblemMap 是一个开源的 RAG 故障模式清单与诊断工具包，聚焦检索增强生成（RAG）应用在落地时容易出问题的环节，把故障按数据、嵌入、检索器、工具调用与评测等层面分类，帮助开发者从“效果不好”定位到“具体哪一步出错”。

适用人群

• 正在搭建或维护 RAG 问答系统的工程师；
• 需要给团队建立排障流程的技术负责人；
• 做 RAG 评测与调优的研究人员。

已知能力

• 按环节梳理 RAG 常见故障模式，覆盖数据准备、向量嵌入、检索器配置、工具调用与评测；
• 提供结构化的诊断思路，便于对照自查；
• 原始资料称其采用 MIT 许可，并被多个实验室与基础设施项目作为实用调试参考；
• 以文档清单形式呈现，可离线阅读，便于纳入内部知识库或排障手册。

使用步骤

1. 打开仓库中的 ProblemMap 说明文档，通读故障分类结构；
2. 针对当前系统表现（如答非所问、召回为空、答案与上下文矛盾），在清单中找到对应环节；
3. 按清单列出的检查点逐项验证：数据切分是否合理、嵌入模型是否匹配语种、检索参数是否合适、工具返回是否被正确注入；
4. 记录修改前后的表现差异，形成团队可复用的排查记录；
5. 将清单条目映射到自建评测集，作为回归检查项。

示例场景

当问答系统对简单问题回答正常、对长文档问题频繁出错时，可先检查切分粒度与检索返回条数，再核对嵌入模型对中文的支持情况，最后检查生成阶段是否忽略检索内容。

限制与注意事项

• 该资料是诊断参考清单，不是开箱即用的软件；实际效果取决于系统实现；
• 许可信息来自原始资料，使用与再分发前需核对仓库许可证文件；
• 部分故障模式可能针对特定技术栈，需结合自身方案判断适用性；
• 项目维护状态与文档更新频率待核验。

来源与使用边界

原始入口：https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md

整理来源：https://github.com/ikaijua/Awesome-AITools

依据来源资料经AI翻译整理，未由本站实测。原始资料许可：CC-BY-4.0；目录许可不代表各产品或文件的使用授权。费用、账号、国内访问与版本兼容条件以原始发布者最新说明为准。