故障排查GitHub issue2 分钟阅读故障排查

解决FastGPT知识库图片无法在问答环节正常输出的问题

FastGPT知识库通过录入或文档导入的方式支持Markdown格式内容,但在问答输出环节,知识库中包含的图片无法正常输出。

现象

FastGPT知识库通过录入或文档导入的方式支持Markdown格式内容,但在问答输出环节,知识库中包含的图片无法正常输出。该问题在知识库存有大量图片时尤为明显,用户尝试通过在提示词中提及图片、截图相关内容,或在知识库Markdown格式内容前后添加注释描述的方式操作,仅能提升图片输出渲染的概率,整体使用体验不友好。

可能原因

需按实际环境确认,目前无明确官方说明。已知用户调整提示词的操作未完全解决该问题。

排查步骤

  1. 检查知识库中图片的Markdown格式是否符合基础规范。
  2. 尝试在问答提示词中添加与图片、截图相关的描述内容。
  3. 对比测试仅包含文本的知识库与包含图片的知识库的问答输出结果,确认问题触发条件。

解决与验证

按照在提示词中添加图片相关描述,或在知识库Markdown格式内容前后添加注释描述的方式操作,可提升图片在问答环节输出渲染的概率。验证方式为:向配置完成的知识库发起相关问答,观察图片是否正常渲染输出。若需实现稳定的图片输出效果,需按实际环境进一步确认优化方案。

来源: FastGPT 官方来源

适用性与版本范围

本页适用于官方来源记录的 故障排查 场景。执行变更前,需核对 FastGPT、依赖、API 与部署版本。

安全护栏

凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。

回滚指引

恢复变更前的技术内容权威快照、已保存配置与数据快照,再执行最小验证场景。