跳至主要内容
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私有部署MongoDB 4.4.29的MCP工具保存报错

解决FastGPT私有部署MongoDB 4.4.29的MCP工具保存报错 现象 用户在FastGPT v4.11.1私有部署版本中，添加包含$schema字段的MCP工具并保存时，会弹出红框报错。查看后端日志，报错文本为：The dollar ($) prefixed field '$schema' in…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT MCP服务器启动时找不到指定模块的问题

解决FastGPT MCP服务器启动时找不到指定模块的问题 现象 fastgpt-mcp-server 容器启动时抛出模块未找到错误，报错信息为： 容器使用 Node.js v20.14.0，最终以退出码 1 异常退出。 可能原因 1. MCP 服务器项目未执行构建流程，未生成 dist 目录及 index…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT MCP服务含流式AI组件时调用无响应问题

解决FastGPT MCP服务含流式AI组件时调用无响应问题 现象 在FastGPT 4.9.6私有部署版本中，通过工作台-MCP服务创建的两个MCP应用，一个用于SQL查询且不含AI流式输出组件，调用可正常执行；另一个用于数据渲染的工具包含AI流式输出组件，调用时无法获取响应。将该数据渲染工具的AI模型更…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中MCP工具集调用的400参数格式错误问题

解决FastGPT中MCP工具集调用的400参数格式错误问题 现象 在FastGPT私有部署4.13.2版本中，通过MCP地址新建MCP工具集后，在工作流中添加工具调用节点并调用模型时，会返回400报错。当MCP工具集的工具ID以数字开头时，会触发该问题，使用gemini-2.5-pro调用时也会出现相同的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT直接回复节点内Mermaid图表引用报错问题

解决FastGPT直接回复节点内Mermaid图表引用报错问题 现象 在FastGPT 4.9.5私有部署版本中，用户在直接回复节点内写入包含空mermaid代码块与脚注引用的内容后，发布测试工作流，点击节点内的引用序号时，网页下方出现Mermaid报错。 可能原因 该问题的可能原因与直接回复节点内的空Me…

2 分钟阅读
故障排查GitHub Issue

FastGPT部署Milvus后容器崩溃的排查与解决方法

FastGPT部署Milvus后容器崩溃的排查与解决方法 现象 用户在MacOS本地通过Docker部署FastGPT 4.8.4私有版本，初始使用PgVector向量库功能正常。更换为Milvus向量库后，所有容器可正常启动，且支持基础知识库搜索测试，但出现两类容器崩溃场景：1. 新导入超过3个单文件约5…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT对接Milvus时的初始化与数据插入异常问题

解决FastGPT对接Milvus时的初始化与数据插入异常问题 现象 用户在FastGPT中对接向量数据库时，初始化流程调用listDatabases接口在zilliz cloud环境下触发报错，且插入向量数据的代码逻辑未完整实现，无法正确提取生成的自增ID。从提供的代码片段可见，插入数据时未传入ID字段（…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署中Milvus容器周期性异常退出问题

解决FastGPT私有部署中Milvus容器周期性异常退出问题 现象 用户在CentOS7系统的4C16G、500G硬盘虚拟机中，通过docker-compose部署FastGPT v4.8.3版本，搭配Milvus向量数据库。系统正常运行2天后，编辑知识库或进入聊天应用时，出现报错14 UNAVAILAB…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署后找不到@node-rs/jieba模块的排错方案

FastGPT私有部署后找不到@node-rs/jieba模块的排错方案 现象 全新部署FastGPT私有部署版本（使用镜像ghcr.io/labring/fastgpt:v4.8-preview3）后，访问系统登陆界面点击登录，出现报错：Error: Cannot find module '@node-r…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.12.3私有部署版缺失messages参数报错排查

FastGPT 4.12.3私有部署版缺失messages参数报错排查 现象 用户在FastGPT 4.12.3私有部署版本中，执行「导入文本数据集选择PDF文档」的知识库导入操作后，出现训练异常。系统返回的完整报错信息为： 报错堆栈显示问题出现在后端服务的tJ.generate方法调用环节，涉及Next.…

2 分钟阅读