故障排查GitHub Issue
解决FastGPT对接云服务的鉴权失败与文档数超限报错
解决FastGPT对接云服务的鉴权失败与文档数超限报错 现象 调用FastGPT对接的qianfan.baidubce.com的/v1/rerank接口时出现两类报错： 1. 首次报错：接口返回200状态码但内部返回api错误，日志显示code: 14, msg: IAM Certification fai…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
FastGPT知识库上传代码及代码生成效果不佳的排错指南
FastGPT知识库上传代码及代码生成效果不佳的排错指南 现象 使用FastGPT公有云或私有部署版本时，上传代码到知识库后，AI代码生成出现答非所问的情况。直接导入代码到知识库难度较高，或导入后未达到预期效果。部分用户从网络爬取代码块直接使用，未通过规范方式导入。 可能原因 代码片段对FastGPT知识库…
故障排查GitHub Issue
解决FastGPT复杂逻辑处理缺少代码模块的问题
解决FastGPT复杂逻辑处理缺少代码模块的问题 现象 处理复杂业务逻辑时，无法直接使用代码模块功能，灵活性不足。典型应用场景包括字符串处理，基于HTTP模块接收返回数据后，无法通过通用HTTP模块完成返回数据的读取和自定义处理。 可能原因 当前使用的FastGPT版本未集成JS沙箱代码模块功能，无法直接编…
故障排查GitHub Issue
解决FastGPT代码节点输出被强制转为字符串的问题
解决FastGPT代码节点输出被强制转为字符串的问题 现象 使用FastGPT的代码节点处理多AI对话串联结果时，当前返回结果为长字符串，需通过特殊字符分隔。用户希望将结果以JSON格式直接返回，但代码节点的输出内容会被强制转为字符串，无法保留原始JSON结构，无法满足需求。 可能原因 代码节点的输出内容被…
故障排查GitHub Issue
解决FastGPT代码运行节点无法引用传入变量的问题
解决FastGPT代码运行节点无法引用传入变量的问题 现象 用户希望在代码运行插件的代码中支持变量引用，应用场景为部分节点生成代码后，需要将代码传递至代码运行插件中运行。典型场景为通过prompt声明代码模板，让AI补全代码后，将生成的代码输出至代码运行节点执行时，无法正常引用传入的变量。 可能原因 代码运…
故障排查GitHub Issue
修复FastGPT Collection搜索仅支持当前目录直接子文件的问题
修复FastGPT Collection搜索仅支持当前目录直接子文件的问题 现象 FastGPT的Collection搜索功能仅支持搜索当前目录下的直接子文件，无法遍历深层嵌套的子文件夹。该问题的应用场景为需要快速查找深层嵌套文件夹中的特定文件，在数据集根目录执行全局搜索时，无法覆盖深层文件，需多次手动切换…
故障排查GitHub Issue
FastGPT常见部署与使用异常问题排查与解决指南
FastGPT常见部署与使用异常问题排查与解决指南 现象 1. Milvus数据库连接异常：大量数据导入后出现fastgpt 14 UNAVAILABLE: Name resolution failed for target dns:milvusStandalone:19530错误，怀疑Milvus因数据量…
故障排查GitHub Issue
解决FastGPT社区版部署多模态模型后无文件图片上传入口的问题
解决FastGPT社区版部署多模态模型后无文件图片上传入口的问题 现象 社区版FastGPT本地部署多模态模型后，聊天输入框无上传文件入口，无法粘贴图片，无法通过输入框完成文件或图片的上传操作。例如使用deepseek-r1-8b模型时，未出现相关上传控件。 可能原因 社区版FastGPT中，多模态文件上传…
故障排查GitHub Issue
FastGPT 非流式 content 的字符串与数组格式核对
FastGPT 非流式 content 的字符串与数组格式核对 适用场景与历史记录 原议题询问非流式 completions 响应中的 content 为什么有时为字符串、有时为数组。 原始讨论提交于 2025-05-23，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程包含两种响应格式的…
故障排查GitHub Issue
FastGPT 4.8.14-fix 复杂工作流编辑与保存异常
FastGPT 4.8.14-fix 复杂工作流编辑与保存异常 适用场景与历史记录 原报告包含文本框编辑失效、连接线异常和重新打开后变更似乎丢失三类问题。 原始讨论提交于 2024-12-03，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 维护者只对第三类给出本地存储上限的定位，指出服务端保存…
故障排查GitHub Issue
配置FastGPT Compose部署以使用外部数据库并移除内置应用
配置FastGPT Compose部署以使用外部数据库并移除内置应用 现象 使用Compose方式部署FastGPT时，存在需要复用已有的外部数据库，且避免部署额外Docker应用的场景，需对默认部署配置进行调整。 可能原因 默认的Compose部署配置内置了数据库与相关应用组件，未提供直接复用外部已有服务…
故障排查GitHub Issue
解决FastGPT部署时config.json相关的配置异常问题
解决FastGPT部署时config.json相关的配置异常问题 现象 部署FastGPT v4.9.1版本时，出现与config.json相关的配置异常报错，服务无法正常启动。报错相关细节可通过部署日志或容器控制台查看，原始提交中包含报错日志截图。 可能原因 存在两类可能的触发因素：一是当前使用的Fast…