Error in Agent node: 400 Item ‘msg_xxxxx’ of type ‘message’ was provided without its required ‘reasoning’ item: ‘rs_xxxx’
快速结论：该报错通常在 Flowise V2.0 Agent 节点中，使用 GPT-5.4 模型并启用 reasoning（推理）功能，同时调用自定义工具时触发。优先排查 reasoning 消息是否在工具调用过程中丢失，并检查是否有可用的 patch 修复。
问题场景
用户在 Flowise 中创建一个 V2.0 Agent 节点，使用 gpt-5.4 模型（应为 GPT-5.4），启用 reasoning 功能（Reasoning Effort 设置为 low，Reasoning Summary 设置为 auto），并分配了一个自定义工具。当 Agent 尝试调用该工具时，返回 400 错误，报错信息指出某个 ‘message’ 类型的 item（msg_xxxxx）缺少必需的 ‘reasoning’ item（rs_xxxx）。
报错原文
Error in Agent node: 400 Item 'msg_xxxxx' of type 'message' was provided without its required 'reasoning' item: 'rs_xxxx'原因分析
根据 Issue 评论分析，这是一个已知的 bug，reasoning 消息在工具调用过程中可能丢失（”the reasoning message just got lost somehow”）。具体来说，当 Agent 的 reasoning 响应中包含了需要传递给工具调用的消息时，Flowise 在处理过程中丢失了必需的 ‘reasoning’ item，导致 API 返回 400 错误。有用户实现了 octo-patch 的修复后问题得到解决，但该修复可能引入新问题：打开执行痕迹时，部分消息无法正常显示，因为消息格式被打乱。
环境排查
- Flowise 版本：Issue 中未提供，建议确认当前使用的 Flowise 版本（可能是较新的开发版或稳定版）。
- 模型版本：gpt-5.4（或 GPT-5.4），需确认模型是否支持 reasoning 功能及工具调用。
- Agent 节点配置：确认 V2.0 Agent 中的 Reasoning Effort 和 Reasoning Summary 设置。
- 自定义工具：确认自定义工具的配置是否正确，是否与 reasoning 功能兼容。
解决步骤
- 确认是否为间歇性问题：根据 Issue 评论，该错误并非每次都会触发。可以多次重试相同配置，观察错误是否稳定复现。
- 尝试 octo-patch 修复（可优先尝试）：有用户报告实现了 octo-patch 的修复后问题解决。需要搜索或应用该 patch。注意：该修复可能带来副作用，即执行痕迹中部分消息显示异常。
- 等待或联系 Flowise 官方修复：由于 octo-patch 的修复并非完美，且 Issue 已关闭但未提供官方修复方案，建议关注后续 Flowise 版本更新，或向官方报告此问题。
- 临时规避方案（可能原因）：尝试调整 reasoning 相关设置（如将 Reasoning Effort 改为 medium 或 high，或关闭 Reasoning Summary），看是否能绕过该问题。
验证方法
重新运行同一 Agent 流程，触发工具调用。如果不再出现 400 错误且 Agent 正常响应，说明问题已解决。如果使用了 octo-patch 修复，建议检查执行痕迹页面，确认所有消息都能正常显示。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
