跳至主要内容
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修改OpenAPI导入HTTP插件路由名称丢失编排的问题

解决FastGPT修改OpenAPI导入HTTP插件路由名称丢失编排的问题 现象 在私有部署V4.8-preview2版本的FastGPT中，用户执行以下操作后会出现编排丢失问题：新建HTTP插件，填写任意名称并填入OpenAPI Schema后点击创建，成功生成包含具体action的插件文件夹；进入插件文…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署OpenAPI启动栈溢出报错问题

解决FastGPT私有部署OpenAPI启动栈溢出报错问题 现象 用户在私有部署FastGPT-4.8.8-fix2版本时，OpenAPI服务无法启动，报错包含runtime/cgo: pthreadcreate failed: Operation not permitted、SIGABRT: abort。…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT OpenAPI聊天接口流式返回首包缺少assistant角色问题

解决FastGPT OpenAPI聊天接口流式返回首包缺少assistant角色问题 现象 使用FastGPT的OpenAPI聊天接口，以stream=true参数请求Chat/Completions接口时，流式返回的首包JSON的delta字段内未包含role: "assistant"。该问题会导致飞书智…

2 分钟阅读
故障排查GitHub Issue

FastGPT使用OpenRouter Key时语音播报失败的排查方法

FastGPT使用OpenRouter Key时语音播报失败的排查方法 现象 用户使用OpenRouter的Key可正常输出文本内容，但无法使用FastGPT内置的语音播报功能，仅浏览器自带播报功能可用。同时浏览器控制台出现404报错，返回的HTML内容包含/next/static/相关的前端静态资源路径片…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT高级编排文本加工节点504/500报错问题

解决FastGPT高级编排文本加工节点504/500报错问题 现象 使用FastGPT高级编排的“文本加工”节点时触发报错，报错日志显示Axios请求错误，状态码包含504（Gateway Time-out）与500。完整报错信息包含AxiosError: Request failed with statu…

2 分钟阅读
故障排查GitHub Issue

FastGPT外链用户点击反馈功能显示无权限报错的排错方法

FastGPT外链用户点击反馈功能显示无权限报错的排错方法 现象 使用私有部署版本的FastGPT外链时，用户点击反馈功能会触发无权限相关报错提示，而点赞功能可以正常使用。 可能原因 由于点赞功能可正常使用，说明基础外链访问权限配置正常，问题集中在反馈功能的专属权限或配置上。具体原因需结合实际部署环境确认，…

2 分钟阅读
故障排查GitHub Issue

FastGPT 4.8.9私有部署启动后访问报错找不到package.json

FastGPT 4.8.9私有部署启动后访问报错找不到package.json 现象 用户在私有部署FastGPT 4.8.9版本时，执行pnpm start -p 8002启动服务，控制台输出Next.js 14.2.5的启动信息，包含警告⚠ "next start" does not work with…

3 分钟阅读
故障排查GitHub Issue

FastGPT打包后出现模型配置报错与菜单崩溃问题排查

FastGPT打包后出现模型配置报错与菜单崩溃问题排查 现象 用户以相同方式打包4.8.20与4.8.20-fix版本均正常，但打包4.8.20-fix2（更改内容与4.8.20一致）后出现三类问题：1. 可用模型列表为空；2. 模型配置触发报错；3. 点击知识库菜单、流程菜单后程序崩溃。启动日志包含报错：…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT部分chatId调用对话接口返回异常的问题

解决FastGPT部分chatId调用对话接口返回异常的问题 现象 在FastGPT知识库进行问答时，通过对话API接口调用不同chatId，会出现两种结果：部分请求正常返回数据，部分请求返回报错。其中一次异常请求参数为{"chatId": "65e17726a816262fbba1b824", "appI…

2 分钟阅读
故障排查GitHub Issue

FastGPT v4.9.3版本PDF增强解析Internal Server Error排错方案

FastGPT v4.9.3版本PDF增强解析Internal Server Error排错方案 现象 使用FastGPT私有部署v4.9.3版本时，在对PDF文档执行增强解析并上传的操作中，页面返回Internal Server Error错误，无法正常完成PDF文档的增强解析上传流程。 可能原因 暂未明…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT私有部署版PDF增强处理长时间卡住问题

解决FastGPT私有部署版PDF增强处理长时间卡住问题 现象 选择任意PDF进行增强处理时，任务持续卡住超过1小时未完成数据训练。部署FastGPT的服务器CPU、内存使用率处于正常范围，数据库负载也无异常，FastGPT控制台日志未显示报错信息。用户上传了两张任务界面截图，但未在描述中补充具体的界面文字…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中PDF识别后HTML表格无法正确预览渲染的问题

解决FastGPT中PDF识别后HTML表格无法正确预览渲染的问题 现象 使用改进后的MinerU处理PDF文件后，识别得到的HTML格式表格无法在FastGPT中正确预览渲染，该问题在复杂表格的PDF场景中出现。 可能原因 目前暂未明确具体技术原因，仅已知该问题出现在复杂表格PDF经识别转换为HTML表格…

2 分钟阅读