跳至主要内容
FASTGPT / 技术中心

从部署到 API，
直接找到可执行答案。

面向开发与部署人员，按任务搜索 4316 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。

4316 篇内容11 个主题官方文档与公开 Issue
推荐入口
API官方文档3 分钟阅读

FastGPT对话接口API的调用方法与参数配置说明

可在应用详情的路径中获取AppId。鉴权使用APIKey，支持两种方式：调用 chat/completions 时在请求体传入 body.appId ，或通过 Authorization: Bearer apiKey - a…

阅读 API 指南 查看官方文档

按任务找到答案

共 4316 篇

故障排查GitHub Issue

解决FastGPT代码节点输出被强制转为字符串的问题

解决FastGPT代码节点输出被强制转为字符串的问题 现象 使用FastGPT的代码节点处理多AI对话串联结果时，当前返回结果为长字符串，需通过特殊字符分隔。用户希望将结果以JSON格式直接返回，但代码节点的输出内容会被强制转为字符串，无法保留原始JSON结构，无法满足需求。 可能原因 代码节点的输出内容被…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT代码运行节点无法引用传入变量的问题

解决FastGPT代码运行节点无法引用传入变量的问题 现象 用户希望在代码运行插件的代码中支持变量引用，应用场景为部分节点生成代码后，需要将代码传递至代码运行插件中运行。典型场景为通过prompt声明代码模板，让AI补全代码后，将生成的代码输出至代码运行节点执行时，无法正常引用传入的变量。 可能原因 代码运…

1 分钟阅读
故障排查GitHub Issue

修复FastGPT Collection搜索仅支持当前目录直接子文件的问题

修复FastGPT Collection搜索仅支持当前目录直接子文件的问题 现象 FastGPT的Collection搜索功能仅支持搜索当前目录下的直接子文件，无法遍历深层嵌套的子文件夹。该问题的应用场景为需要快速查找深层嵌套文件夹中的特定文件，在数据集根目录执行全局搜索时，无法覆盖深层文件，需多次手动切换…

2 分钟阅读
故障排查GitHub Issue

FastGPT常见部署与使用异常问题排查与解决指南

FastGPT常见部署与使用异常问题排查与解决指南 现象 1. Milvus数据库连接异常：大量数据导入后出现fastgpt 14 UNAVAILABLE: Name resolution failed for target dns:milvusStandalone:19530错误，怀疑Milvus因数据量…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT社区版部署多模态模型后无文件图片上传入口的问题

解决FastGPT社区版部署多模态模型后无文件图片上传入口的问题 现象 社区版FastGPT本地部署多模态模型后，聊天输入框无上传文件入口，无法粘贴图片，无法通过输入框完成文件或图片的上传操作。例如使用deepseek-r1-8b模型时，未出现相关上传控件。 可能原因 社区版FastGPT中，多模态文件上传…

1 分钟阅读
故障排查GitHub Issue

FastGPT 非流式 content 的字符串与数组格式核对

FastGPT 非流式 content 的字符串与数组格式核对 适用场景与历史记录 原议题询问非流式 completions 响应中的 content 为什么有时为字符串、有时为数组。 原始讨论提交于 2025-05-23，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 原线程包含两种响应格式的…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.14-fix 复杂工作流编辑与保存异常

FastGPT 4.8.14-fix 复杂工作流编辑与保存异常 适用场景与历史记录 原报告包含文本框编辑失效、连接线异常和重新打开后变更似乎丢失三类问题。 原始讨论提交于 2024-12-03，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 维护者只对第三类给出本地存储上限的定位，指出服务端保存…

2 分钟阅读
故障排查GitHub Issue

配置FastGPT Compose部署以使用外部数据库并移除内置应用

配置FastGPT Compose部署以使用外部数据库并移除内置应用 现象 使用Compose方式部署FastGPT时，存在需要复用已有的外部数据库，且避免部署额外Docker应用的场景，需对默认部署配置进行调整。 可能原因 默认的Compose部署配置内置了数据库与相关应用组件，未提供直接复用外部已有服务…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT部署时config.json相关的配置异常问题

解决FastGPT部署时config.json相关的配置异常问题 现象 部署FastGPT v4.9.1版本时，出现与config.json相关的配置异常报错，服务无法正常启动。报错相关细节可通过部署日志或容器控制台查看，原始提交中包含报错日志截图。 可能原因 存在两类可能的触发因素：一是当前使用的Fast…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT配置自定义OpenAI代理网址的常见问题

解决FastGPT配置自定义OpenAI代理网址的常见问题 现象 在使用FastGPT时，用户希望配置自定义的OpenAI代理网址以适配国内网络环境，但无法找到对应配置入口，或配置后无法正常调用OpenAI API。 可能原因 一是未找到FastGPT中配置自定义OpenAI代理网址的官方入口；二是未采用官…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT V4.9.7-fix2版本的内容拼接异常问题

解决FastGPT V4.9.7-fix2版本的内容拼接异常问题 现象 FastGPT私有部署V4.9.7-fix2版本中，执行内容拼接操作时，出现非预期内容被纳入拼接结果的异常情况，具体异常表现需按实际环境确认。 可能原因 一是未对拼接内容进行类型校验，非文本数据流入拼接流程，导致异常内容被纳入结果；二是…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT长对话上下文溢出的记忆模块配置问题

解决FastGPT长对话上下文溢出的记忆模块配置问题 现象 长对话过程中出现上下文溢出，无法正常维持完整对话历史，影响对话连续性。为解决该问题，计划通过轻量记忆模块压缩历史对话，已设定的配置参数包括maxrounds（最大轮次，如15）、maxtokens（可选，如16k）、compressat（触发点，如…

2 分钟阅读