故障排查GitHub Issue
FastGPT 复杂工作流持续加载的历史问题报告
FastGPT 复杂工作流持续加载的历史问题报告 适用场景与历史记录 原议题标题描述复杂工作流似乎持续加载，报告者填写的私有部署版本为 4.19.3，正文包含截图。 原始讨论提交于 2025-06-18，本页按该记录说明症状或需求的适用范围。 已有证据与适用范围 4.19.3 属于原作者自报信息，准确版本仍…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT缺失ReRankModels配置导致初始化失败问题
解决FastGPT缺失ReRankModels配置导致初始化失败问题 现象 FastGPT部署后出现拉取初始化数据失败的问题，该问题可出现于公有云版本或私有部署版本中。 可能原因 配置文件中缺少ReRankModels配置项，系统未对该配置项做判空处理，导致初始化流程无法正常执行。 排查步骤 1. 查看当前…
故障排查GitHub Issue
解决FastGPT混合检索模式下知识库分类命中偏差问题
解决FastGPT混合检索模式下知识库分类命中偏差问题 现象 知识库内一般命令为1-20条，较重命令为21-41条，严重命令为42-50条。使用FastGPT混合检索模式时，提问"一般命令有哪些"，预期返回1-20条一般命令内容，实际返回严重或较重违规的答案。单独使用语义检索可检索到"一般XX"相关内容，但…
故障排查GitHub Issue
FastGPT移动端拍照提问响应慢的排查与解决方法
FastGPT移动端拍照提问响应慢的排查与解决方法 现象 移动端访问FastGPT时，使用手机拍照提问功能，响应速度过慢。 可能原因 可能的原因包含两类，一是二次开发过程中对上传的拍照图片进行了压缩处理，引发额外资源开销；二是当前部署环境的网络带宽不足，无法快速传输图片与请求数据。 排查步骤 1. 确认当前…
故障排查GitHub Issue
FastGPT v4.9.1 模型账号可见范围：历史限制与诊断
FastGPT v4.9.1 曾有按账号配置模型公有、私有及可见范围的需求，维护者当时答复该能力受限。模型候选列表和应用访问授权应分别验证，并记录所用版本的实际行为。
故障排查GitHub Issue
解决FastGPT配置模型后无法显示思考过程及API识别异常的问题
解决FastGPT配置模型后无法显示思考过程及API识别异常的问题 现象 升级至4.8.21版本后，使用OneAPI集成的密钥，在模型配置中选择OpenAI或阿里云提供商，配置阿里云百炼DeepSeek R1的API时，即使开启UI端"支持输出思考"选项，且在配置文件中手动添加"reasoning": tr…
故障排查GitHub Issue
解决FastGPT模型配置繁琐与预制配置文件缺失问题
解决FastGPT模型配置繁琐与预制配置文件缺失问题 现象 使用FastGPT时，需频繁更换和调整模型，花费大量时间。缺少预制的各模型配置文件，模型配置过程繁琐且混乱，增加了模型调试的成本。 可能原因 当前FastGPT未提供预制的模型配置文件，需手动配置每个模型的参数，且无统一的实时更新的模型参数参考来源…
故障排查GitHub Issue
FastGPT模型配置从文件修改改为页面配置的解决方案
FastGPT模型配置从文件修改改为页面配置的解决方案 现象 使用FastGPT新增模型时，需编辑config.json配置文件写入相关内容，完成后需重启Docker容器才能生效，流程繁琐，对上线应用的部署不够友好。 可能原因 当前FastGPT的模型配置采用静态配置文件的管理方式，无法在不重启服务的前提下…
故障排查GitHub Issue
解决FastGPT手动配置模型参数步骤繁琐的问题
解决FastGPT手动配置模型参数步骤繁琐的问题 现象 当前FastGPT的模型配置需手工通过config.json文件完成，无法快速同步公共模型参数模板，配置步骤繁琐，增加了部署和维护的工作量。 可能原因 FastGPT暂未集成公共模型参数同步功能，仅支持通过手动编辑config.json文件完成模型配置…
故障排查GitHub Issue
解决FastGPT自定义大模型及向量模型配置疑问
解决FastGPT自定义大模型及向量模型配置疑问 现象 用户尝试接入本地baichuan2-13b-chat模型，同时对ChatGLM2-6B的配置存在疑问，不清楚ChatModels与VectorModels的配置对应关系，以及是否必须使用M3E作为向量模型。 可能原因 未明确区分对话模型与向量模型的配置…
故障排查GitHub Issue
解决FastGPT中重复模型ID导致配置被覆盖的问题
解决FastGPT中重复模型ID导致配置被覆盖的问题 现象 新建FastGPT模型配置时，若待新建配置的ID与已存在的模型配置ID重复，即使二者URL不同，已存在的模型配置会被新配置覆盖。 可能原因 当前FastGPT模型配置逻辑以模型ID作为唯一主键，当存在重复ID时，会触发覆盖原有配置的逻辑。 排查步骤…
故障排查GitHub Issue
解决FastGPT部署后模型配置与初始化异常问题
解决FastGPT部署后模型配置与初始化异常问题 现象 使用Docker Compose拉取FastGPT 4.8.20-fix2版本并清空MongoDB数据库所有集合后，出现模型相关异常。使用Sealos部署FastGPT时，出现配置相关异常，页面提示配置文件存在问题。 可能原因 1. 未为知识库启用至少…