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

常见原因

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

// 但只提供了一个 ToolMessage
chatHistory.push({
  role: "tool",
  content: toolResponse,
  tool_call_id: responseMessage.tool_calls[0].id
});

await modelWithTools.invoke(chatHistory); // 失败并显示 INVALID_TOOL_RESULTS

故障排除

要解决此错误:
  • 计数匹配对:确保在前面的 AIMessage 中,每个工具调用都存在一个对应的 ToolMessage
  • 验证 ID:确认每个 ToolMessage.tool_call_id 与实际的工具调用标识符匹配