此错误在预构建的Documentation Index
Fetch the complete documentation index at: https://nvd-54.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
create_agent 中,当 call_model 图节点收到格式错误的消息列表时抛出。具体来说,当存在带有 tool_calls(大语言模型(LLM)请求调用工具)的 AIMessages,但没有对应的 ToolMessage(工具调用结果返回给大语言模型(LLM))时,消息列表被视为格式错误。
你看到此错误可能有以下几个原因:
- 你在调用图时手动传入了格式错误的消息列表,例如
graph.invoke({'messages': [AIMessage(..., tool_calls=[...])]}) - 图在收到
tools节点的更新(即ToolMessage列表)之前被中断了, 然后你使用非 None 或非 ToolMessage 的输入调用了它, 例如graph.invoke({'messages': [HumanMessage(...)]}, config)。 此中断可能由以下方式之一触发:- 你在
create_agent中手动设置了interrupt_before = ['tools'] - 其中一个工具抛出了未被
ToolNode("tools")处理的错误
- 你在
故障排除
要解决此问题,你可以执行以下操作之一:- 不要使用格式错误的消息列表调用图
- 在中断的情况下(手动中断或因错误中断),你可以:
- 提供与现有工具调用匹配的
ToolMessage对象,并调用graph.invoke({'messages': [ToolMessage(...)]})。 注意:这会将消息追加到历史记录中,并从 START 节点开始运行图。- 手动更新状态并从中断处恢复图:
- 使用
graph.get_state(config)从图状态中获取最新消息列表 - 修改消息列表,删除 AIMessages 中未回答的工具调用
- 使用
- 手动更新状态并从中断处恢复图:
tool_call_ids 与未回答的工具调用匹配的 ToolMessage 对象 3. 使用修改后的消息列表调用 graph.update_state(config, {'messages': ...}) 4. 恢复图,例如调用 graph.invoke(None, config)
将这些文档连接到 Claude、VSCode 等工具,通过 MCP 获取实时答案。

