> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# INVALID_TOOL_RESULTS

<Note>
  目前仅在 `langchainjs`（JavaScript/TypeScript）中使用。
</Note>

此错误发生在工具调用操作期间，向模型传递不匹配、不足或过多的 [`ToolMessage`](https://reference.langchain.com/javascript/langchain-core/messages/ToolMessage) 对象时。

该错误源于一个基本要求：包含 `tool_calls` 的助手消息之后，必须跟随响应每个 `tool_call_id` 的工具消息。

当模型返回包含工具调用的 [`AIMessage`](https://reference.langchain.com/javascript/langchain-core/messages/AIMessage) 时，你必须为每个工具调用提供恰好一个对应的 [`ToolMessage`](https://reference.langchain.com/javascript/langchain-core/messages/ToolMessage)，且其 `tool_call_id` 值必须匹配。

## 常见原因

* **响应不足**：如果模型请求执行两个工具，但你只提供了一个响应消息，模型会拒绝不完整的消息链
* **重复响应**：为同一个工具调用 ID 提供多个 [`ToolMessage`](https://reference.langchain.com/javascript/langchain-core/messages/ToolMessage) 对象会导致拒绝，ID 不匹配同样会导致拒绝
* **孤立的工具消息**：发送一个 [`ToolMessage`](https://reference.langchain.com/javascript/langchain-core/messages/ToolMessage)，但其前面没有包含工具调用的 [`AIMessage`](https://reference.langchain.com/javascript/langchain-core/messages/AIMessage)，这违反了协议要求

以下是一个有问题的模式示例：

```javascript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
// 模型请求两个工具调用
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`](https://reference.langchain.com/javascript/langchain-core/messages/AIMessage) 中，每个工具调用都存在一个对应的 [`ToolMessage`](https://reference.langchain.com/javascript/langchain-core/messages/ToolMessage)
* **验证 ID**：确认每个 `ToolMessage.tool_call_id` 与实际的工具调用标识符匹配

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/langchain/errors/INVALID_TOOL_RESULTS.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>