故障排查GitHub Issue
解决FastGPT工作流调用时LLM模型返回空的报错问题
解决FastGPT工作流调用时LLM模型返回空的报错问题 现象 Docker本地部署的FastGPT 4.9.0版本，使用官方docker-compose-pgvector.yml无改动配置，模型渠道测试均成功。在工作流模型使用聊天功能时，系统提示报错workflow error [{\"message\"…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT编排工作流节点报错无日志排查难的问题
解决FastGPT编排工作流节点报错无日志排查难的问题 现象 编排包含20余个节点的工作流应用，调试阶段运行正常无报错。生产环境中，正常对话可生成对话日志，但单个节点出错时无日志可查，无法观测节点运行状态，无可视化日志，排查问题难度较高。 可能原因 现有信息未明确具体原因，需结合实际部署环境、配置项、运行环…
故障排查GitHub Issue
FastGPT工作流多入度节点执行异常的排查方法
FastGPT工作流多入度节点执行异常的排查方法 现象 在FastGPT工作流配置中，带有多个入度线条的节点，例如用户提到的步骤3节点，有时会出现不执行的情况。该问题仅在节点存在多个输入来源线条时出现，未明确出现的频率与触发场景。 可能原因 用户对多入度节点的执行触发条件存在疑问，不清楚该类节点是否需要所有…
故障排查GitHub Issue
解决FastGPT工作流嵌套调用时用户选择插件异常问题
解决FastGPT工作流嵌套调用时用户选择插件异常问题 现象 FastGPT v4.8.10-alpha私有部署版本中，在A工作流内调用B工作流时，B工作流内的用户选择插件无法正常运行。 可能原因 暂未明确具体触发因素，需结合实际部署环境与运行日志排查。 排查步骤 1. 确认当前FastGPT部署版本为v4…
故障排查GitHub Issue
解决FastGPT工作流节点异常终止问题
解决FastGPT工作流节点异常终止问题 现象 导入FastGPT工作流配置文件aaaaa.json后，输入任意内容启动流程，依次选择【自定义检查】→【ping测试】，流程在下一个节点异常终止，对应截图红色框标注的节点为异常终止位置。 可能原因 1. 导入的workflow配置文件存在节点配置或流转逻辑错误…
故障排查GitHub Issue
解决FastGPT工作流固定节点异常终止的排错方法
解决FastGPT工作流固定节点异常终止的排错方法 现象 工作流运行至固定节点时异常终止，后续流程未执行。使用复现工作流时，输入WO2002并点击Confirm按钮后，右上角的回复节点未触发，流程直接终止。可通过导入WO.json工作流文件复现该问题。 可能原因 当前未获取到明确报错文本，相关因素需按实际环…
故障排查GitHub Issue
FastGPT进入流程编排页面崩溃问题排查指南
FastGPT进入流程编排页面崩溃问题排查指南 现象 使用FastGPT时，进入流程编排页面出现崩溃。此前可正常使用该项目，近期重新使用时触发该问题，设备配置相对较低，同时伴随GPU占用率升高的表现。 可能原因 未明确具体触发原因。结合现象中的GPU占用率升高表现，可能与本地系统资源调度、页面渲染逻辑或本地…
故障排查GitHub Issue
FastGPT私有部署工作流插件输入输出不显示排查
FastGPT私有部署工作流插件输入输出不显示排查 现象 FastGPT私有部署版本v4.8.15、v4.8.16中，新建配置了输入与输出项的空白插件后，将该插件添加至新建空白工作流时，插件的输入与输出项无法正常显示。此前版本创建的插件可正常显示输入输出项。 可能原因 该异常可能与v4.8.15至v4.8.…
故障排查GitHub Issue
解决FastGPT私有部署V4.11.1版本工作流插件列表接口无反应问题
解决FastGPT私有部署V4.11.1版本工作流插件列表接口无反应问题 现象 在FastGPT私有部署V4.11.1版本的使用过程中，在工作流文件内搜索已创建的插件时，对应的list接口无反应，无有效返回内容，相关问题附带了日志截图。 可能原因 未检索到可依据的明确预设原因，需结合实际部署环境、接口请求日…
故障排查GitHub Issue
解决FastGPT工作流运行后需手动终止才能发起下次会话的问题
解决FastGPT工作流运行后需手动终止才能发起下次会话的问题 现象 在FastGPT私有部署版本v4.12.2-fix3的环境中，点击工作流的运行预览功能测试工作流时，首次发起聊天会话后，必须手动点击终止按钮，才可进行下次会话。将私有部署版本回滚至v4.11.1后，该问题不再出现。 可能原因 目前无公开的…
故障排查GitHub Issue
解决FastGPT v4.8.9-alpha工作流发布状态显示颠倒的排查与修复方案
解决FastGPT v4.8.9-alpha工作流发布状态显示颠倒的排查与修复方案 现象 FastGPT v4.8.9-alpha版本的工作流管理页面中，发布状态显示存在颠倒问题。点击已发布按钮后，页面显示为未发布状态；点击未发布按钮后，页面显示为已发布状态，与实际操作结果不符。 可能原因 当前无明确已知的…
故障排查GitHub Issue
FastGPT知识库检索在工作流中无返回内容的排错指南
FastGPT知识库检索在工作流中无返回内容的排错指南 现象 在FastGPT知识库搜索测试页面可正常检索内容，使用相同配置与相同问题时，工作流内的知识库检索无法返回内容。本次反馈使用的私有部署版本为v4.8.10 fix2。 可能原因 无明确关联的已知原因，需结合实际部署环境、运行日志与配置信息排查。针对…