跳至主要内容
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 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 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版API带system-prompt时知识库失效问题

解决FastGPT私有部署版API带system-prompt时知识库失效问题 现象 使用FastGPT私有部署V4.8.5版本时，调用API接口携带system-prompt参数后，知识库不会触发搜索操作。将system-prompt参数设置为空值时，知识库依然无法进行搜索。删除system-prompt…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.8.21-fix版本团队云端ObjectId转换报错问题

解决FastGPT 4.8.21-fix版本团队云端ObjectId转换报错问题 现象 升级到FastGPT 4.8.21-fix私有部署版本后，点击工作流的【团队云端】选项，页面弹出报错，报错信息为message: 'Cast to ObjectId failed for value "undefined…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中团队插件二级目录显示异常问题

解决FastGPT私有部署中团队插件二级目录显示异常问题 现象 用户使用docker镜像ghcr.io/labring/fastgpt:v4.8.5私有部署FastGPT，在工作流中选择团队插件时可正常看到根目录文件夹。点击根目录文件夹后，二级目录仍显示根目录文件夹，未展示预期的插件列表。两张对应截图分别展…

2 分钟阅读