跳至主要内容
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私有部署后重启丢失嵌入知识库数据问题

解决FastGPT私有部署后重启丢失嵌入知识库数据问题 现象 用户使用docker compose部署私有部署版本FastGPT，前端显示版本为4.14.20，fastgpt-app镜像版本为4.14.22，使用seekdb相关的compose文件。创建知识库并添加文件后，seekdb内可查询到嵌入数据，执…

2 分钟阅读
故障排查GitHub Issue

配置FastGPT沙箱代理后无法预览文档的排错方法

配置FastGPT沙箱代理后无法预览文档的排错方法 现象 用户配置了AGENTSANDBOXPROXYURL环境变量为ws://192.168.0.11:1006，确认该WebSocket代理地址可通过浏览器正常访问，同时配置了AGENTSANDBOXPREVIEWPROXYURL为http://192.1…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT沙箱提供商适配与扩展相关的排查问题

解决FastGPT沙箱提供商适配与扩展相关的排查问题 现象 当前FastGPT仅支持sealosdevbox和opensandbox两种沙箱提供商，用户无法直接调用e2b或UCloud沙箱服务，在需要扩展沙箱提供商适配时，无对应的配置或代码路径可供使用。 可能原因 FastGPT内置的沙箱适配模块仅集成了s…

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