故障排查GitHub Issue
解决FastGPT HTTP模块接入知识库后引用内容不显示问题
解决FastGPT HTTP模块接入知识库后引用内容不显示问题 现象 使用FastGPT HTTP模块接入知识库时，接口返回内容包含q、a、sourceName字段，部分用户还尝试添加id、sourceId字段。附带的截图显示接口返回了包含上述字段的有效数据，但对话界面无法正常展示知识库引用内容，未出现对应…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT高级编排中HTTP模块返回数据无法覆盖回复内容的问题
解决FastGPT高级编排中HTTP模块返回数据无法覆盖回复内容的问题 现象 用户反馈在使用FastGPT高级编排功能时，将HTTP模块返回的数据直接传递给指定回复的【回复内容】参数后，该参数被识别为空值，最终对话界面仍显示预设的固定回复内容。用户已在服务端验证HTTP模块的返回数据本身非空，调整返回字段的…
故障排查GitHub Issue
解决FastGPT工具调用HTTP请求未设输出字段时无响应的问题
解决FastGPT工具调用HTTP请求未设输出字段时无响应的问题 现象 在FastGPT私有部署4.8.12-fix版本中，使用工具调用HTTP请求时，若未配置输出字段，前端展示的Response为空，但查看详情可看到完整原始响应；此时模型也无法接收到原始响应内容。当配置了具体输出字段后，可正常显示响应内容…
故障排查GitHub Issue
解决FastGPT工具调用后HTTP请求参数附带undefined的问题
解决FastGPT工具调用后HTTP请求参数附带undefined的问题 现象 用户在私有部署4.89版本的FastGPT中，按照以下流程操作：AI对话节点总结知识库生成内容列表，将结果传入工具调用节点构建SQL查询语句，再通过HTTP请求节点调用query接口。工具调用可正常生成正确的SQL语句，但HTT…
故障排查GitHub Issue
解决FastGPT HTTP模块引用变量的格式与空值异常问题
解决FastGPT HTTP模块引用变量的格式与空值异常问题 现象 用户在FastGPT 4.9.0私有部署版本中使用HTTP模块时，发现当前模块通过字符替换方式引用变量。引用string类型变量时，需要手动为变量添加引号。当变量值为null时，替换后会生成值为"null"的字符串，无法符合接口要求的空值格…
故障排查GitHub Issue
解决FastGPT中HTTP模块处理后变量无法正确传递的问题
解决FastGPT中HTTP模块处理后变量无法正确传递的问题 现象 用户在FastGPT V4.8-preview2私有部署版本中，配置HTTP外部脚本处理带自定义指令的用户输入。例如输入-ty 最近AI有什么大事件，HTTP脚本返回正确的JSON格式响应{"message": "最近AI有什么大事件"}。…
故障排查GitHub Issue
FastGPT图片上传与应用头像无法正常显示的排错指南
FastGPT图片上传与应用头像无法正常显示的排错指南 现象 当前使用FastGPT v4.8.17-fix-title私有部署版本（docker部署搭配pgvector）时，所有涉及图片上传的功能均无法正常解析图片。具体表现为：在应用设置中替换应用头像后无生效效果；在支持图片的模型对话场景中，上传图片后无…
故障排查GitHub Issue
解决FastGPT中上传图片无法被LLM调用下载的问题
解决FastGPT中上传图片无法被LLM调用下载的问题 现象 用户在FastGPT中上传图片后，调用大语言模型处理图片时出现下载失败提示。对应日志包含如下报错信息： 同时会出现LLM response error的警告日志，请求体中包含指向localhost:3000的图片访问地址。 可能原因 1. 大语言…
故障排查GitHub Issue
解决FastGPT私有部署版关闭图像上传后仍提取用户图片的问题
解决FastGPT私有部署版关闭图像上传后仍提取用户图片的问题 现象 在FastGPT v4.8.10-fix2私有部署版本中，用户为简易应用关闭「图像上传」配置项后，通过Web端或API发起对话时，系统仍会自动提取用户输入内容中的图片链接。当用户输入无效图片地址时，会触发对应的报错提示。 可能原因 该问题…
故障排查GitHub Issue
解决FastGPT知识库img标签被转为Markdown图片的问题
解决FastGPT知识库img标签被转为Markdown图片的问题 现象 用户在FastGPT知识库中编辑的问答答案包含img标签，在实际AI回复的展示内容里，该img标签被自动转换为Markdown格式的图片。 可能原因 该问题由FastGPT前端内容渲染流程自动处理HTML标签触发，会将输入的img标签…
故障排查GitHub Issue
解决FastGPT 4.8.3版索引重排头部报错问题
解决FastGPT 4.8.3版索引重排头部报错问题 现象 用户使用FastGPT 4.8.3私有部署版本，勾选指定知识库的索引重排选项后执行聊天操作，后台出现报错Invalid character in header content ["Authorization"]，前端界面无任何反馈，且索引重排功能未…
故障排查GitHub Issue
解决执行init.sql后仍出现modeldata表不存在的数据库报错
解决执行init.sql后仍出现modeldata表不存在的数据库报错 现象 用户执行init.sql初始化脚本后，调用FastGPT的/api/plugins/kb/list接口时出现数据库报错。具体报错信息为：error: relation "modeldata" does not exist，Post…