故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT工作流中用户新需求无法触发工具调用的问题

用户在FastGPT私有部署V4.12.2版本中创建智能体,配置的工作流为“用户需求输入→调用知识库搜索工具→调用思考工具→调用生成Word文档工具输出下载链接”。

现象

用户在FastGPT私有部署V4.12.2版本中创建智能体,配置的工作流为“用户需求输入→调用知识库搜索工具→调用思考工具→调用生成Word文档工具输出下载链接”。首次处理用户需求时可正常按流程调用工具完成任务,但当一轮对话结束后用户输入新的独立需求时,智能体不再触发工具调用流程,且在提示词中添加引导重新执行流程的内容后,问题仍未解决。

可能原因

目前无明确的官方归因,结合FastGPT工作流的通用运行逻辑,潜在的影响方向包括会话上下文未正确重置、工具调用触发条件绑定了初始会话状态,具体原因需结合实际部署环境与智能体配置确认。

排查步骤

  1. 登录FastGPT管理后台,进入对应智能体的配置页面,检查会话上下文相关配置,确认上下文保留的轮次、时长或内容范围。
  2. 查看工作流的触发节点设置,确认是否存在仅在首次会话启动时执行的绑定条件。
  3. 新建一个独立测试会话,输入新的用户需求,观察智能体是否能正常触发工具调用流程。
  4. 重新核对提示词内容,确认是否明确要求智能体在处理新的用户需求时,重置当前流程逻辑并重新执行工作流步骤。

解决与验证

如果排查后发现是会话上下文未重置的问题,可在智能体配置中调整上下文保留规则,限制仅保留当前会话的交互内容,或在每次新需求发起前手动清空历史上下文。如果是工作流触发条件配置错误,需修改触发节点的条件,确保每次用户输入新需求时都能触发完整的工具调用流程。修改提示词或配置后,需重新发布智能体使其生效。验证时,发起两次独立的用户需求,观察每次都能正常调用知识库搜索、思考工具与生成Word文档工具,完成完整工作流。

来源:FastGPT GitHub issue