故障排查GitHub Issue
解决FastGPT私有部署版工作流知识库分支逻辑异常问题
解决FastGPT私有部署版工作流知识库分支逻辑异常问题 现象 用户在FastGPT私有部署v4.8.11版本的工作流中，配置了「知识库搜索节点→判断器节点→两个AI对话节点」的链路，意图实现：当知识库检索到匹配内容时，使用第一个AI对话节点返回结果；未检索到时，触发第二个联网搜索的AI对话节点。但实际执行…
FASTGPT / 技术中心
从部署到 API，
直接找到可执行答案。
面向开发与部署人员，按任务搜索 4244 篇技术内容，覆盖部署升级、知识库、工作流、集成与 API。
4244 篇内容11 个主题官方文档与公开 Issue
API 调用路径
01API 调用Request
02身份鉴权API Key
03应用编排App ID
04流式响应SSE
可追溯来源 · 可执行步骤 · 可验证结果
按任务找到答案
共 4244 篇
故障排查GitHub Issue
解决FastGPT高级编排循环工作流的模块上限与详情显示问题
解决FastGPT高级编排循环工作流的模块上限与详情显示问题 现象 在FastGPT高级编排工作流中使用循环节点时，若循环次数过多，工作流会因运行模块数过多被提前终止。例如示例中循环执行50次后流程即被终止。同时，查看循环内模块的运行详情时，仅会显示该模块第一次执行的输入和输出结果，选择模块时会选中所有相同…
故障排查GitHub Issue
解决FastGPT工作流循环进度任务提前停止的问题
解决FastGPT工作流循环进度任务提前停止的问题 现象 用户使用私有部署最新main分支版本的FastGPT，配置了包含循环逻辑的工作流，工作流大致流程为：流程开始后进入判断器，未达100%进度则请求后台进度数据、输出进度信息后回到判断器，达100%则直接输出最终结果。在对话使用该工作流时，进度未达到10…
故障排查GitHub Issue
解决FastGPT工作流循环调用无法正常跳出的问题
解决FastGPT工作流循环调用无法正常跳出的问题 现象 用户使用FastGPT 4.8私有部署版本，在工作流中配置循环取数据场景。自定义远程JS组件在无法获取结果时返回empty字符，用户通过提取到的数据 = empty作为循环跳出的判断条件。测试发现，非循环场景下该判断条件可正常触发分支，但循环场景会卡…
故障排查GitHub Issue
解决FastGPT工作流中高德MCP工具调用无正确结果的问题
解决FastGPT工作流中高德MCP工具调用无正确结果的问题 现象 用户在FastGPT私有部署v4.9.6版本中，创建简单工作流并配置高德MCP工具调用节点后，运行工作流提问如“杭州天气怎么样”，未返回工具调用的预期结果。单独调试该高德MCP服务时，功能可正常运行。本次使用的大模型为Qwen2.5-32B…
故障排查GitHub Issue
解决FastGPT工作流中用户新需求无法触发工具调用的问题
解决FastGPT工作流中用户新需求无法触发工具调用的问题 现象 用户在FastGPT私有部署V4.12.2版本中创建智能体，配置的工作流为“用户需求输入→调用知识库搜索工具→调用思考工具→调用生成Word文档工具输出下载链接”。首次处理用户需求时可正常按流程调用工具完成任务，但当一轮对话结束后用户输入新的…
故障排查GitHub Issue
FastGPT工作流内容未随更新实时刷新的排错方法
FastGPT工作流内容未随更新实时刷新的排错方法 现象 用户在FastGPT私有部署版V4.9.13中遇到内容更新不实时的问题：首先修改目标工作流中的描述内容，随后点击重新解析按钮完成解析操作，但最终查看工作流时，发现展示的描述仍为修改前的旧版本内容，未按照预期实时更新为最新修改的内容。用户还提供了三张相…
故障排查GitHub Issue
设置FastGPT多工具调用工作流仅保留最后一次工具输出结果
设置FastGPT多工具调用工作流仅保留最后一次工具输出结果 现象 用户配置包含3次工具调用的FastGPT搜索匹配工作流后，系统会将3次工具调用的全部输出展示在控制台。从用户提供的截图可见，控制台同时展示了三次工具调用的详细执行日志与输出内容，用户仅希望保留最后一次工具调用的输出作为最终返回结果。 可能原…
故障排查GitHub Issue
解决FastGPT工作流调用插件更新变量后全局变量丢失问题
解决FastGPT工作流调用插件更新变量后全局变量丢失问题 现象 在FastGPT公有云版本的工作流中，调用包含变量更新工具的自定义插件后，会出现工作流全局变量丢失的问题。具体表现为：聊天窗口展示的全局变量会消失，但指定回复节点和用户选择节点仍可正常输出全局变量的原有值；重新输入全局变量并点击确认后，此前更…
故障排查GitHub Issue
解决FastGPT工作流应用无法找到发布渠道的问题
解决FastGPT工作流应用无法找到发布渠道的问题 现象 用户在使用FastGPT工作流应用时，系统提示需发布该工作流应用，但无法找到对应的发布渠道，并上传了四张相关的报错页面截图。 可能原因 目前可确认的触发场景为系统提示需发布工作流应用但找不到发布入口，具体深层原因需结合实际部署环境与操作流程确认。 排…
故障排查GitHub Issue
解决FastGPT工作流应用回复上限设置不生效问题
解决FastGPT工作流应用回复上限设置不生效问题 现象 用户在FastGPT私有部署v4.8.22-alpha版本中，使用自定义API接入模型的工作流应用里，AI对话功能的回复上限设置无效。将回复上限设置为2、20、200、2000时，回复内容长度均无变化；在模型供应商页面设置该参数，同样无法生效，同时发…
故障排查GitHub Issue
解决FastGPT工作流知识库搜索节点重排混入历史对话问题
解决FastGPT工作流知识库搜索节点重排混入历史对话问题 现象 在FastGPT私有部署V4.11.1版本中，配置了知识库搜索节点且启用重排模型的工作流，会出现第二轮对话将第一轮对话的AI回答作为重排搜索输入内容的问题。例如知识库中存在预设问答对：Q=谢谢，A=不客气呢，有其他问题随时联系我哈～，搭建包含…