Skip to main content
此错误在预构建的 createAgent 中，当 callModel 图节点接收到格式错误的消息列表时触发。具体来说，当存在带有 tool_calls（LLM 请求调用工具）的 AIMessages，但没有对应的 ToolMessage（工具调用的结果，需返回给 LLM）时，即被视为格式错误。 出现此错误可能有以下几种原因：
  1. 你在调用图时手动传递了格式错误的消息列表，例如 graph.invoke({messages: [new AIMessage({..., tool_calls: [...]})]})
  2. 图在从 tools 节点（即一组 ToolMessage）接收更新之前被中断，并且你使用了一个非 null 或非 ToolMessage 的输入来调用它， 例如 graph.invoke({messages: [new HumanMessage(...)]}, config)。 这种中断可能由以下方式之一触发：
    • 你在 createAgent 中手动设置了 interruptBefore: ['tools']
    • 某个工具抛出了未被 ToolNode ("tools") 处理的错误

​
故障排除

要解决此问题，你可以采取以下措施之一：
  1. 不要使用格式错误的消息列表来调用图
  2. 在发生中断（手动或由于错误）的情况下，你可以：
  • 提供与现有工具调用匹配的 ToolMessage 对象，并调用 graph.invoke({messages: [new ToolMessage(...)]})。 注意：这会将消息追加到历史记录中，并从 START 节点开始运行图。
    • 手动更新状态并从中断处恢复图：
      1. 使用 graph.getState(config) 从图状态获取最新的消息列表
      2. 修改消息列表，要么从 AIMessages 中移除未应答的工具调用
要么添加带有与未应答工具调用匹配的 toolCallIds 的 ToolMessage 对象 3. 使用修改后的消息列表调用 graph.updateState(config, {messages: ...}) 4. 恢复图，例如调用 graph.invoke(null, config)
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.