跳至主要内容
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中Markdown解析的HTML标签无法正常渲染的排错方法

FastGPT中Markdown解析的HTML标签无法正常渲染的排错方法 现象 在FastGPT v4.7.1私有部署版本的对话框中，用户尝试插入自定义HTML代码以嵌入外部网页，具体使用的iframe代码为<iframe height=850 width=90% src="http://mctool.wa…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传含可执行代码的MD文档导入失败的问题

解决FastGPT上传含可执行代码的MD文档导入失败的问题 现象 在FastGPT私有部署版本中，上传Markdown文档进行分段处理时，平台会执行文档内的JS代码，导致导入失败。具体存在两种测试场景：一是上传包含var name = "<img src=x onerror=alert(1)"; el.in…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.9.0版本Marker解析后图片异常与标签残留问题

解决FastGPT 4.9.0版本Marker解析后图片异常与标签残留问题 现象 部署FastGPT 4.9.0私有部署版本并配置Marker服务后，使用知识库增强解析功能时出现两个问题：一是图片无法正常展示，解析出的图片地址与正常格式不符；二是解析后的文档残留span标签。正常图片地址以/api/syst…

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