跳至主要内容
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系统启用繁体中文菜单与帮助文档显示的方法

FastGPT系统启用繁体中文菜单与帮助文档显示的方法 现象 FastGPT系统当前仅支持英文与简体中文显示，无法将系统菜单、帮助文档切换为繁体中文格式，无法满足繁体中文的使用需求。 可能原因 系统内置的语言包仅包含英文与简体中文资源，未集成繁体中文的语言翻译内容，导致无法加载繁体中文的界面显示。 排查步骤…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT训练文档异常的重试配置与一键重试方案

解决FastGPT训练文档异常的重试配置与一键重试方案 现象 更新至FastGPT V4.9.4版本后，训练文档环节出现大量训练异常。用户反馈单个重试操作需手动点击，批量处理效率较低。 可能原因 训练异常多由调用渠道不稳定引发，手动单次重试操作效率较低，且默认重试配置灵活性不足。 排查步骤 1. 确认训练环…

1 分钟阅读
故障排查GitHub Issue

FastGPT常见功能异常与配置问题排查与解决指南

FastGPT常见功能异常与配置问题排查与解决指南 现象 记录FastGPT相关异常与需求：应用市场无分类功能，分享链接无法记录用户对话内容；关联多个知识库时，匹配结果仅优先返回首个匹配知识库内容；部署于外地服务器时，数据库时间比本地少几小时；无法使用非原生GPT-4 API，缺少代理配置项；应用缺少固定开…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT未配置OpenAI模型时出现的固定重复请求报错问题

解决FastGPT未配置OpenAI模型时出现的固定重复请求报错问题 现象 该问题属于私有部署版本的异常表现。系统未配置OpenAI模型时，会触发报错；且每次问答交互后，会固定发送OpenAI模型请求，无论系统是否配置该模型。 可能原因 需按实际环境确认。 排查步骤 1. 确认系统中OpenAI模型的配置状…

1 分钟阅读
故障排查GitHub Issue

FastGPT升级后数据迁移失败与数据恢复方法

FastGPT升级后数据迁移失败与数据恢复方法 现象 升级FastGPT后出现两类问题：一是已创建的知识库存在但内部内容丢失；二是执行4.8.1版本初始化命令时，日志输出特定报错信息，具体为：datasetcollections 中有数据，无法自动将 dataset.collections 迁移到 data…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT 4.4升级至4.41后部分知识库文件名不显示的问题

解决FastGPT 4.4升级至4.41后部分知识库文件名不显示的问题 现象 本地通过docker-compose部署FastGPT，将版本从4.4升级至4.4.1。先执行docker-compose pull命令拉取最新镜像，未运行升级脚本时，进入知识库页面无法查看已有的文件名。随后执行指定的升级脚本，执…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后知识库搜索无法匹配内容的问题

解决FastGPT升级后知识库搜索无法匹配内容的问题 现象 FastGPT私有部署版本4.8.3升级后，执行初始化脚本与脏数据清理操作，知识库搜索测试无法匹配任何内容。仅手动逐条更新单条数据集内容后，才可恢复正常搜索匹配功能。 可能原因 部署过程中使用了与当前向量数据库不匹配的docker-compose配…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后出现column team_id不存在的报错问题

解决FastGPT升级后出现column teamid不存在的报错问题 现象 升级FastGPT至4.6.8版本后，知识库和应用全部丢失。查看fastgpt容器日志，出现报错信息：'column "teamid" does not exist'。 可能原因 升级时跨越多个FastGPT版本，未按顺序执行各版…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后的数据库连接与模型渠道异常问题

解决FastGPT升级后的数据库连接与模型渠道异常问题 现象 FastGPT版本从4.0升级至4.2后，使用docker compose部署且未修改配置文件的场景下，访问知识库时出现connect ECONNREFUSED 127.0.0.1:5432报错。同时使用免费Token时，出现"当前分组 defa…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后流程调试时变量关联为空的报错问题

解决FastGPT升级后流程调试时变量关联为空的报错问题 现象 在FastGPT流程调试场景中，调试升级前创建的流程时，会触发控件报错提示，提示变量未正确关联，该问题影响多数旧版流程。 可能原因 经确认，该报错仅在使用数组类型变量的流程中出现，属于旧版流程数据结构与新版系统的兼容问题。 排查步骤 1. 定位…

1 分钟阅读
故障排查GitHub Issue

解决FastGPT升级后版本号显示异常与功能不匹配问题

解决FastGPT升级后版本号显示异常与功能不匹配问题 现象 用户升级FastGPT到4.8.14版本后，页面显示的版本号仍为13，分享链接对应的功能与版本描述的功能不匹配，怀疑升级步骤存在错误。 可能原因 升级操作未正确执行，导致实际运行的镜像版本未更新，或容器未加载新版本的系统配置文件。 排查步骤 1.…

2 分钟阅读
故障排查GitHub Issue

解决FastGPT上传文件无法读取或触发上传失败的问题

解决FastGPT上传文件无法读取或触发上传失败的问题 现象 用户反馈上传的文件未被系统读取。部分场景下，测试界面可正常上传文件，但对话界面无法触发上传；小文件（如几字节、500字节左右）可触发上传接口，大文件无法触发且无任何提示。升级到v4.8.22版本后，上传操作出现404异常。日志显示上传成功，但无文…

2 分钟阅读