故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT检索到知识库但未传入大模型上下文的问题

用户在FastGPT V4.9.0私有部署版本中创建简单应用,配置包含法规的知识库,使用语义检索或混合检索发起提问。页面展示已检索到知识库内容且带有引用,但查看执行详情时,发现实际传给大模型的提问未携带检索到的上下文内容。

现象

用户在FastGPT V4.9.0私有部署版本中创建简单应用,配置包含法规的知识库,使用语义检索或混合检索发起提问。页面展示已检索到知识库内容且带有引用,但查看执行详情时,发现实际传给大模型的提问未携带检索到的上下文内容。

可能原因

暂无明确预设根因,需结合实际部署环境与配置排查,常见关联方向包括检索配置未正确生效、上下文拼接逻辑异常、大模型调用参数缺失上下文字段等场景。

排查步骤

  1. 登录FastGPT后台,进入对应简单应用的编辑页面,确认已正确关联目标知识库,且检索方式设置为语义检索或混合检索。
  2. 发起测试提问,等待页面返回结果后,点击执行详情查看完整调用日志,对比页面展示的检索引用内容与实际传入大模型的提问文本。
  3. 确认当前FastGPT部署版本为V4.9.0私有部署版本,排查版本相关的配置异常。
  4. 检查应用的上下文传递配置,确认检索到的知识库内容是否被正确拼接至大模型的提问参数中。

解决与验证

若为知识库关联或检索方式配置错误,重新完成关联配置并保存后重新发起测试。若为上下文拼接或调用参数异常,需结合执行详情日志定位问题位置,调整对应配置项。验证方式为:再次发起相同测试提问,查看执行详情中传给大模型的提问是否包含检索到的知识库上下文内容,确认页面展示的引用与实际传入内容一致。

来源:FastGPT GitHub issue