跳至主要内容
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使用Marker识别PDF后部分图片无法正常显示的排错方法

FastGPT使用Marker识别PDF后部分图片无法正常显示的排错方法 现象 在私有部署V4.8.21版本的FastGPT中，使用Docker部署的Marker进行PDF知识库识别时，部分图片无法正常显示。异常图片的路径为类似"8Image0.Png"的本地文件名格式，正常显示的图片路径为"/api/sy…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT接入Marker PDF解析出现的replace属性报错问题

解决FastGPT接入Marker PDF解析出现的replace属性报错问题 现象 用户使用FastGPT v4.9.0私有部署版本，接入Marker PDF文档解析功能时，出现以下流程与报错： 1. 上传test.pdf成功，耗时17ms 2. 触发外部服务解析文件 3. 自定义文件解析完成，耗时998…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中Maximum call stack size exceeded报错问题

解决FastGPT中Maximum call stack size exceeded报错问题 现象 用户使用FastGPT时，运行日志或控制台会抛出RangeError类型报错，完整提示为：Maximum call stack size exceeded。从堆栈跟踪信息可见，错误反复触发于src/servi…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT调用大模型时max_token参数传入负数的问题

解决FastGPT调用大模型时maxtoken参数传入负数的问题 现象 用户在私有部署FastGPT中，使用m3e与qwen1.5 14b模型，配置最大token为1024。完成知识库添加并测试搜索功能正常后，调用机器人提问时，m3e相关参数运行正常，但向qwen1.5发送请求时，maxtoken参数被错误…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT配置上下文参数后响应Token显示异常问题

解决FastGPT配置上下文参数后响应Token显示异常问题 现象 用户使用FastGPT 4.8-preview版本，希望会话不记录上下文对话，将配置文件中的maxContext参数设置为3、0或1，同时将maxResponse参数保留为4000。但对话页面显示最大响应Tokens为200，导致AI生成的…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT工作流中MCP工具调用连接超时报错问题

解决FastGPT工作流中MCP工具调用连接超时报错问题 现象 在FastGPT 4.14.1私有部署版本的工作流中，使用“工具调用”节点连接MCP工具时，出现如下报错： 同时可以正常在MCP工具集中添加MCP工具。 可能原因 1. FastGPT容器与MCP服务器容器之间的网络无法正常连通 2. 配置的M…

4 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署添加MCP工具时的$schema字段报错问题

解决FastGPT私有部署添加MCP工具时的$schema字段报错问题 现象 在FastGPT v4.11.0私有部署版本中，用户尝试添加MCP工具时，点击保存按钮会弹出错误提示。该MCP工具可在其他客户端正常使用，但在FastGPT中保存失败，报错文本为：The dollar ($) prefixed f…

2 分钟阅读
故障排查GitHub Issue

解决x86架构下FastGPT MCP服务镜像构建失败的问题

解决x86架构下FastGPT MCP服务镜像构建失败的问题 现象 用户在x8664 CentOS环境中执行docker build命令构建FastGPT MCP服务镜像时失败，相同网络环境下ARM架构的Mac电脑可成功构建镜像。构建命令为docker build -f ./projects/mcpserv…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.12.2版本MCP工具调用参数缺失报错问题

解决FastGPT 4.12.2版本MCP工具调用参数缺失报错问题 现象 用户在docker部署的FastGPT环境中，从4.9.11版本升级至4.12.2后，或全新安装4.12.2版本时，执行以下操作后出现异常：创建HTTP插件，通过MCP服务选择HTTP插件的接口创建服务，再创建MCP工具集，在应用中添…

2 分钟阅读
故障排查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 分钟阅读