callModel 图节点收到格式错误的消息列表时,预构建的 @[createAgent][create_agent] 会引发此错误。具体来说,当存在带有 tool_calls(LLM 请求调用工具)但没有相应 @[ToolMessage](要返回给 LLM 的工具调用结果)的 AIMessage 时,它是格式错误的。 您看到此错误可能有几个原因:
  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 中删除未回答的工具调用
或添加 toolCallId 与未回答的工具调用匹配的 ToolMessage 对象 3. 使用修改后的消息列表调用 graph.updateState(config, {messages: ...}) 4. 恢复图,例如调用 graph.invoke(null, config)
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.