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

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

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

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

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

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

阅读 API 指南 查看官方文档

按任务找到答案

共 4244 篇

故障排查GitHub Issue

解决FastGPT调用模型分段回复时出现JSON解析错误的问题

解决FastGPT调用模型分段回复时出现JSON解析错误的问题 现象 用户使用FastGPT 4.8.1版本，通过OneAPI接入glm4-9b-chat模型。当AI回复内容存在分段时，接口会报错“Unexpected end of JSON input”。后台日志显示两条关键信息：一是Could not…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT API调用时SSE连接60秒内过早关闭的问题

解决FastGPT API调用时SSE连接60秒内过早关闭的问题 现象 通过API接口调用FastGPT的对话流水时，FastGPT运行日志会重复输出sse error: Premature close报错，且可观察到SSE连接在60秒后自动断开。单条报错详情包含明确的错误栈信息：Error: Premat…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT启动时加载系统模型报错的问题

解决FastGPT启动时加载系统模型报错的问题 现象 私有部署FastGPT 4.13.2版本，搭配fastgpt-plugin V0.2.4时，项目启动时抛出报错：Load systen model error, please check fastgpt-plugin TypeError: fetch f…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT开启stream:true后流式输出多出data:前缀的问题

解决FastGPT开启stream:true后流式输出多出data:前缀的问题 现象 当在FastGPT中配置stream: true启用流式输出时，返回的每条内容会额外带有event: answer和data: 前缀，例如示例中的event: answer\ndata: {"id":"","object"…

2 分钟阅读
故障排查GitHub Issue

排查FastGPT工具挂载子应用的返回内容与流输出问题

排查FastGPT工具挂载子应用的返回内容与流输出问题 现象 1. 关闭子应用“返回AI内容”开关时，无论是否开启“禁用流输出”，主应用都无法接收任何反馈。 2. 开启“返回AI内容”、关闭“禁用流输出”时，调试界面与免登陆窗口显示逻辑不一致，用户看到的子应用回复会短暂显示后消失。 3. API流式响应中，…

2 分钟阅读
故障排查GitHub Issue

FastGPT二级路由配置时知识库图片展示异常的排错指南

FastGPT二级路由配置时知识库图片展示异常的排错指南 现象 配置二级路由（即设置环境变量NEXTPUBLICBASEURL为非空值，如/test）的私有部署版本V4.12.0中，上传含图片的Word文档至知识库后，在应用对话界面检索知识库内容时，图片无法正常展示。经观察，图片地址拼接存在异常，无法生成正…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT调用子测试工具返回LLM_model_response_empty报错问题

解决FastGPT调用子测试工具返回LLMmodelresponseempty报错问题 现象 用户在FastGPT私有部署v4.9.0版本中，先在测试1模块通过提示词让大模型提取性别，再在测试2模块的工具调用环节调用测试1模块，此时系统返回报错信息{"message": "chat:LLMmodelresp…

2 分钟阅读
故障排查GitHub Issue

FastGPT版本升级后子工作流全局变量无法传递到父工作流的排查解决方法

FastGPT版本升级后子工作流全局变量无法传递到父工作流的排查解决方法 现象 用户在FastGPT v4.9.1版本中可正常实现子工作流全局变量传递到父工作流的功能：创建父工作流并设置全局变量SN，引入子工作流节点并将父工作流的全局变量SN传递给子工作流，子工作流用于设置目标变量。首次问答结束后变量可保存…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用猜你想问API返回403错误的问题

解决FastGPT调用猜你想问API返回403错误的问题 现象 私有部署版本v4.8.9的FastGPT，调用猜你想问API时返回403错误。用户已确认应用内猜你想问功能已开启且完成发布，使用Postman发起请求时，Headers已填写并反复核对过参数内容。 可能原因 结合报错场景与已知信息，可能的触发因…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT不支持/v1/completions接口的集成问题

解决FastGPT不支持/v1/completions接口的集成问题 现象 使用LangChain或其他固定调用OpenAI标准/v1/completions接口的第三方工具时，对接FastGPT会出现集成失败的问题。当发起POST请求至http://localhost:3000/api/v1/comple…

3 分钟阅读
故障排查GitHub Issue

解决群晖部署FastGPT修改host网络后的启动报错问题

解决群晖部署FastGPT修改host网络后的启动报错问题 现象 用户在群晖Container Manager部署FastGPT，仅修改Docker Compose的网络模式为host。FastGPT启动失败，日志报错： MongoDB容器日志持续出现类似报错： 可能原因 1. 容器使用host网络模式后，…

3 分钟阅读