一个 Bug 4 人踩坑2个月：Agent 工具调用为何总在边界出错

za7654 · reddit · 2026-08-12

作者复盘了近期约 50 起 Agent 框架的工具调用（tool-call）失败报告，发现一个典型案例：某框架在带有 toolcalls 的助手消息中写入了 content: ""（规范允许 null）。

这个微小的偏差导致了 4 个人在长达两个月内遇到了 3 种不同的报错信息，且彼此不知道是同一个根本原因。作者指出，这类问题极具隐蔽性：直接调用 OpenAI 或 Anthropic 等大厂 API 时通常能通过测试，但一旦遇到下游更严格的验证器就会在数周后崩溃，且报错位置往往指向错误的层级。这种“契约在一处断裂，却在另一处暴露”的模式在 Agent 开发中十分普遍。