Skip to main content
目前仅在 langchainjs（JavaScript/TypeScript）中使用。
此错误发生在工具调用操作期间，向模型传递不匹配、不足或过多的 ToolMessage 对象时。 该错误源于一个基本要求：带有 tool_calls 的助手消息之后，必须跟随响应每个 tool_call_id 的工具消息。 当模型返回带有工具调用的 AIMessage 时，你必须为每个工具调用提供恰好一个对应的 ToolMessage，且 tool_call_id 值需匹配。

​
常见原因

  • 响应不足：如果模型请求执行两个工具，但你只提供一个响应消息，模型会拒绝不完整的消息链
  • 重复响应：为同一个工具调用 ID 提供多个 ToolMessage 对象会导致拒绝，未匹配的 ID 也会导致同样问题
  • 孤立工具消息：发送 ToolMessage 而没有包含工具调用的前置 AIMessage 违反了协议要求
以下是一个有问题的模式示例： 
# 模型请求两个工具调用
response_message.tool_calls  # 返回 2 个调用

# 但只提供了一个 ToolMessage
chat_history.append(ToolMessage(
    content=str(tool_response),
    tool_call_id=tool_call.get("id")
))

model_with_tools.invoke(chat_history)

​
故障排除

要解决此错误：
  • 匹配计数：确保前置 AIMessage 中的每个工具调用都有一个对应的 ToolMessage
  • 验证 ID：确认每个 ToolMessage.tool_call_id 都匹配实际的工具调用标识符
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.