跳至主要内容
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 Agent Sandbox的出网控制与内容安全审查能力

配置FastGPT Agent Sandbox的出网控制与内容安全审查能力 现象 使用FastGPT的Agent通过Sandbox联网搜索、访问网页、调用第三方API或检索公开代码仓库时，第三方返回数据可能包含政治、色情、暴力等高风险内容。这类内容未经过滤，会直接显示在工具卡片、运行详情或流式界面中，还可能…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT安装第三方技能时的格式校验失败问题

解决FastGPT安装第三方技能时的格式校验失败问题 现象 用户在FastGPT中直接安装第三方技能时，前端会提示“不符合格式要求”。同时后台日志会记录对应错误信息：请求/api/core/ai/skill/save-deploy返回500状态码，请求耗时约10213ms，报错文本为Failed to pa…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT技能发布缓慢与发布报错问题

解决FastGPT技能发布缓慢与发布报错问题 现象 用户在FastGPT平台中执行技能（skill）发布操作时，同时遇到两个问题：一是发布过程耗时过长、进度缓慢，二是发布流程总会触发报错，且附带了两张报错相关的截图。 可能原因 因未提供具体报错文本与运行环境配置细节，可能的原因需按实际运行环境确认。 排查步…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT连续工具调用后tool_choice设为none的模型响应异常问题

解决FastGPT连续工具调用后toolchoice设为none的模型响应异常问题 现象 在FastGPT v4.15.2的工作流工具调用节点中，当连续工具调用次数超过5次后，系统会将下一次请求的toolchoice参数设为none。此时若上游兼容OpenAI接口的模型返回finishreason为tool…

3 分钟阅读
故障排查GitHub Issue

FastGPT 常见异常问题排查与解决指南

FastGPT 常见异常问题排查与解决指南 现象 暂未明确具体异常表现，需结合实际部署或运行场景确认。常见可观测的异常类型包括服务启动失败、接口请求返回异常、核心功能无法正常触发等，具体表现需按实际运行环境核实。 可能原因 可能原因需结合实际场景确认，常见排查方向包括配置文件参数配置错误、绑定的密钥无法正常…

2 分钟阅读
故障排查GitHub Issue

修复FastGPT上传文件后响应式布局切换导致文件列表消失问题

修复FastGPT上传文件后响应式布局切换导致文件列表消失问题 现象 在FastGPT的知识库或企业门户上传文件完成后，拖动页面、调整浏览器窗口宽度或触发PC/移动端响应式布局切换时，已上传成功的文件列表会直接消失。该问题在公有云版本和V4.14.9私有部署版本中均存在，且非偶发。上传相关接口（如/api/…

3 分钟阅读
故障排查GitHub Issue

解决FastGPT虚拟机中安装SSH因无sudo权限失败的问题

解决FastGPT虚拟机中安装SSH因无sudo权限失败的问题 现象 用户在FastGPT关联的虚拟机环境中尝试安装SSH时，操作直接失败，系统返回固定报错文本： 具体表现为无法正常执行sudo命令，无法完成系统包列表更新与SSH客户端的安装流程。 可能原因 根据报错信息，本次失败的核心原因是当前运行的虚拟…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT复杂工作流开发依赖手动面板操作的问题

解决FastGPT复杂工作流开发依赖手动面板操作的问题 现象 当前FastGPT复杂工作流开发依赖手动面板操作，开发循环为：设计或生成工作流JSON→手动导入更新工作流→手动运行全流程测试→检查运行时诊断→修改工作流JSON→重复流程。现有运行时诊断仅在聊天执行时可用，无官方API/CLI支持无头的工作流草…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT工作流返回异常结果的检索调试问题

解决FastGPT工作流返回异常结果的检索调试问题 现象 当FastGPT工作流返回不正确或不完整的答案时，用户难以定位失败发生的具体位置。知识库类应用的使用者通常需要获取以下信息来调试检索质量：已检索的文本块、重排序后选中的文本块、最终提供给大模型的来源信息。缺少这些信息时，检索质量调试只能依靠反复尝试。…

2 分钟阅读
故障排查GitHub Issue

FastGPT工作流中文本内容提取组件耗时过长问题排查与解决

FastGPT工作流中文本内容提取组件耗时过长问题排查与解决 现象 在FastGPT v4.13.0私有部署版本的工作流中，使用「文本内容提取」组件时，组件耗时较长。该组件配置为名称“文本内容提取#4”，使用模型qwen3-32b-v63q，提取要求为分析整个对话历史，提取所有用户问题，按时间顺序列出每次的…

2 分钟阅读
故障排查GitHub Issue

解决WSL中Ubuntu安装FastGPT后无法访问3000端口的问题

解决WSL中Ubuntu安装FastGPT后无法访问3000端口的问题 现象 用户在Windows 11的WSL环境中安装Ubuntu系统，通过官方bash一键命令完成FastGPT安装，Docker服务正常启动后，无法访问http://localhost:3000链接，且已关闭本地防火墙。 可能原因 1.…

2 分钟阅读