现象
当FastGPT工作流返回不正确或不完整的答案时，用户难以定位失败发生的具体位置。知识库类应用的使用者通常需要获取以下信息来调试检索质量：已检索的文本块、重排序后选中的文本块、最终提供给大模型的来源信息。缺少这些信息时，检索质量调试只能依靠反复尝试。
可能原因
当前缺少可选的检索追踪（Retrieval Trace）视图，无法直观展示检索流程的各环节数据。外部可观测工具仅能提供部分可见性，且缺少工作流专属的检索相关信息，同时还需要额外的配置步骤。
排查步骤
- 进入FastGPT工作流的执行日志页面，找到需要排查的目标查询执行记录。
- 确认页面中是否存在检索追踪的查看入口。
- 若未找到对应入口，需按实际环境确认是否需要开启相关配置。
- 查看已检索的文本块、检索分数、重排序结果、最终发送给大模型的上下文以及来源归属信息。
解决与验证
通过添加或启用检索追踪（Retrieval Trace）视图，可以展示所需的检索相关数据。验证时，发起一次测试查询，对比检索追踪展示的内容与实际返回结果，确认检索流程的各个环节是否符合预期，即可定位检索质量相关的问题。