create_agent invalid-tool-call repair emits a tool_result with no matching tool_use, so Anthropic threads fail with a 400 after any invalid

问题场景

用户在使用 LangChain 的 create_agent 构建 Anthropic 系列（langchain-anthropic）Agent 时，一旦工具调用出现无效调用（例如模型返回被截断的 JSON 参数），之后的模型调用就会报 400。因为修复逻辑 _patch_invalid_tool_calls 会为无效调用补一条合成的 ToolMessage，但不会同步修改原 AIMessage；而 Anthropic 序列化器只根据 tool_calls 生成 tool_use，会完全丢弃 invalid_tool_calls，于是这条合成的 ToolMessage 就变成了没有匹配 tool_use 的孤儿 tool_result。由于修复结果会被写回 state，一次无效调用就会让该线程之后每次请求都失败。

报错原文

patched sequence: ['HumanMessage', 'AIMessage', 'ToolMessage', 'HumanMessage']
tool_use ids in payload:    []
tool_result ids in payload: ['toolu_01ABC']
orphaned tool_result ids:   ['toolu_01ABC']
The Anthropic Messages API rejects this payload with a 400

anthropic.BadRequestError: Error code: 400 - invalid_request_error:
...

原因分析

根本原因在 libs/langchain_v1/langchain/agents/factory.py 的 _patch_invalid_tool_calls：它为每个未应答的 invalid_tool_call 追加一条合成的错误 ToolMessage，但保留原 AIMessage 不变。不同 provider 的序列化器对该字段的处理不一致：langchain-openai 会为无效调用生成 tool_calls 条目，而 langchain-anthropic 只从 tool_calls 构建 tool_use 块，直接丢弃 invalid_tool_calls。于是合成的 ToolMessage 序列化出的 tool_result 在 payload 中找不到父级 tool_use，被 Anthropic Messages API 以 400 拒绝。

环境排查

• 确认 langchain 版本（Issue 复现为 1.4.2）以及 langchain-anthropic 版本（Issue 复现为 1.7.4）。
• 确认是否使用 create_agent 并接入了 langchain-anthropic 的模型（Issue 复现使用 ChatAnthropic）。
• 确认历史消息中是否存在 invalid_tool_calls（AIMessage 层）。
• 确认该线程是否已经被“修复结果写回 state”，即一次无效调用后是否持续失败。

解决步骤

1. 先用 Issue 提供的复现脚本确认问题：构造一条带 invalid_tool_calls 的 AIMessage，调用 _patch_invalid_tool_calls，再调用 ChatAnthropic._get_request_payload，检查返回 payload 中 tool_result 的 tool_use_id 是否能在 tool_use 的 id 列表中找到。
2. 若确认存在孤儿 tool_result，可优先尝试修复方向：在 _patch_invalid_tool_calls 中，把每个带 id 的 invalid tool call 提升为同一 AIMessage 上的常规 tool_call。做法是用 model_copy(update={"tool_calls": [...], "invalid_tool_calls": [...]}) 重写消息，保留 content、usage metadata 和 response metadata；参数优先按 JSON 重新解析，失败或结果非 dict 时回退为 {}。
3. 无 id 的 invalid tool call 不提升（现有逻辑本就不为其生成 ToolMessage），避免生成 provider 不接受的 id-less tool_call。
4. 已经被旧修复损坏的持久化线程，同样走上述提升逻辑，使修复后的消息与 state 不同并回写，从而在下次模型调用时自愈。
5. OpenAI 风格 provider 不受影响，其 id 原本就会序列化，现在只是改走常规 tool_calls 路径。
6. 跟踪对应 PR（#40854）是否合并；若尚未合并，注意该方案属于“可优先尝试”，不是发行版已验证的一步修复。

验证方法

重新运行 Issue 中的复现脚本，确认输出的 orphaned tool_result ids 为空列表，即 payload 中每个 tool_result.tool_use_id 都能找到匹配的 tool_use.id，并且结构断言不再为 ["toolu_01ABC"]。若使用 PR 中的回归测试，可运行 pytest tests/unit_tests/agents/test_invalid_tool_calls.py，其中包含“每个 tool_result id 都有父级 tool_call”的不变量测试以及持久化损坏线程自愈测试。

参考来源

langchain-ai/langchain #40853

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。