跳至主要内容
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上传文档触发502报错后服务卡死的问题

解决FastGPT上传文档触发502报错后服务卡死的问题 现象 部署于腾讯云2核2G轻量服务器的FastGPT，上传文档过程中可能出现502报错，报错恢复后服务卡死，仅能通过重启操作恢复服务运行，附带相关报错截图。 可能原因 暂未明确具体根因，仅已知复现场景为腾讯云2核2G轻量服务器，上传文档时触发502报…

2 分钟阅读
故障排查GitHub Issue

FastGPT 上传异常问题的排查与解决方法

FastGPT 上传异常问题的排查与解决方法 现象 出现上传相关的报错提示，无法正常完成文件或图片的上传操作，相关报错已通过两张截图展示。 可能原因 需按实际部署环境确认，可能涉及上传权限配置、文件格式/大小限制、网络传输异常或密钥使用异常等情况。 排查步骤 1. 查看提供的两张报错截图，记录具体的报错文本…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传文件返回200但响应含403报错的问题

解决FastGPT上传文件返回200但响应含403报错的问题 现象 用户在使用FastGPT私有部署版本上传文件时，遇到以下问题：HTTP请求返回状态码为200，但调用response.json()解析响应内容后，得到403报错。已反复确认所使用的API Key无误。 可能原因 1. 上传文件功能的权限未按…

2 分钟阅读
故障排查GitHub Issue

FastGPT对话窗口上传文件报错问题排查指南

FastGPT对话窗口上传文件报错问题排查指南 现象 FastGPT V4.8.14私有部署版本中，在已开启上传文件功能的对话窗口上传任意小于10kb的文件时均会触发报错。除文件上传功能外，其他应用功能运行正常。部署使用的8802端口无异常，未被其他服务占用。问题附带两张报错截图，具体报错文本可参考issu…

2 分钟阅读
故障排查GitHub Issue

FastGPT私有部署版上传文件后无法总结文档的排错方法

FastGPT私有部署版上传文件后无法总结文档的排错方法 现象 FastGPT私有部署版本v4.8.17中，执行创建新对话、上传本地文档、请求模型总结文档的操作后，无法正常总结上传的文档内容，未解析到文档。查看文档的访问链接格式为http://192.168.110.213:3000/api/common/…

2 分钟阅读
故障排查GitHub Issue

FastGPT上传知识库报错问题的排查与解决方法

FastGPT上传知识库报错问题的排查与解决方法 现象 用户反馈上传知识库时触发报错，未提供具体报错文本，仅通过截图展示报错界面，且已确认自身使用的密钥可正常使用。 可能原因 1. 上传的知识库文件格式不符合平台支持的规范； 2. 上传过程中出现网络波动或连接中断，导致数据传输异常； 3. 系统运行环境的可…

2 分钟阅读
故障排查GitHub Issue

查找FastGPT中已上传并处理的原始文件的存储位置

查找FastGPT中已上传并处理的原始文件的存储位置 现象 用户在FastGPT 4.8.14私有部署环境中，上传文件并完成处理后，无法在前端页面找到对应原始文件的存储目录，无法下载已上传的原始文件。 可能原因 FastGPT 4.8.14私有部署版本的前端界面未直接展示原始上传文件的存储路径，文件存储路径…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT分组上游负载饱和insufficient_quota报错问题

解决FastGPT分组上游负载饱和insufficientquota报错问题 现象 调用FastGPT时出现报错，报错文本为insufficientquota 当前分组上游负载已饱和，请稍后再试，附带请求ID为2025022112482585670542332302066。 可能原因 当前FastGPT分组…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.9.0-fix2私有部署url数据集创建报错问题

解决FastGPT 4.9.0-fix2私有部署url数据集创建报错问题 现象 在FastGPT私有部署4.9.0-fix2版本中，使用url链接创建数据集时，提交创建操作会触发报错cannot fetch internal url。该数据集创建功能在v4.8版本可正常使用。 可能原因 当前公开的issue…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT中URL文件类型判断不准确的问题

解决FastGPT中URL文件类型判断不准确的问题 现象 FastGPT v4.9.1-fix2私有部署版本中，解析URL文件时存在缺陷，系统通过URL地址截断的方式判断文件类型，导致带有访问权限控制的文件无法正确解析。即使实际URL可正常访问对应文件，解析结果仍缺少正确的文件类型信息。 可能原因 系统在处…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT高级编排中提取URL自定义参数的问题

解决FastGPT高级编排中提取URL自定义参数的问题 现象 用户在FastGPT免登录分享链接（如http://test.com/chat/share?shareId=aaa&chatId=bbb&userId=10086&key=[REDACTEDCREDENTIAL] 可能原因 现有FastGPT版本…

2 分钟阅读
故障排查官方文档

FastGPT user account_psw_error错误码说明

FastGPT user accountpswerror错误码说明 这个错误是什么 该错误属于FastGPT user模块，枚举名为accountpswerror，状态文本为accountpswerror，对应错误码为503002，提示文案对应国际化键common:codeerror.accounterro…

2 分钟阅读