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

FastGPT上传图片后无法获取图片URL的排错方法

在FastGPT对话框上传图片后,无法获取对应的图片URL参数,无法在对话流程中判断是否上传了图片。调用FastGPT对话API传入image-url参数时,仅首个AI对话模型可读取图片内容,后续AI对话模型无法读取。

现象

在FastGPT对话框上传图片后,无法获取对应的图片URL参数,无法在对话流程中判断是否上传了图片。调用FastGPT对话API传入image-url参数时,仅首个AI对话模型可读取图片内容,后续AI对话模型无法读取。

可能原因

当前FastGPT未将上传图片的URL暴露为可调用的参数或全局变量,且对话API的image-url参数未实现跨AI对话模块的传递。

排查步骤

  1. 确认已在对话框中完成图片上传操作,检查对话流程中是否存在内置的图片URL输出参数。
  2. 检查全局变量配置页面,确认未预先配置用于存储图片URL的变量。
  3. 调用对话API时,检查image-url参数的传入格式与参数位置是否正确。
  4. 测试多AI对话模块的场景,确认图片读取仅在首个配置的AI对话模块中生效。

解决与验证

首先,需将上传图片的URL存入全局变量,可通过现有对话流程将图片URL赋值给指定全局变量(需按实际环境确认具体配置步骤)。其次,在分支判断节点中读取该全局变量,变量为空则判定未上传图片,变量非空则判定已上传。调用对话API时,需确保image-url参数正确传入,且需按实际场景确认多模块图片读取的适配方式。验证时,上传图片后触发对话流程,检查全局变量是否被正确赋值,分支判断是否按预期执行。

来源: FastGPT 官方来源

适用性与版本范围

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

安全护栏

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

回滚指引

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