tool_calls 结构校验失败
函数调用返回结构不合法导致的报错,含空数组、缺 id、arguments 不是 JSON 字符串。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
tool_calls函数调用json
30 秒结论
工具调用的返回结构不符合规范。常见是 arguments 传了对象而不是 JSON 字符串。
报错原文对照
{"error":{"message":"Invalid tool_calls: arguments must be a JSON string"}}
原因排序
| 概率 | 原因 |
|---|---|
| 40% | 配置问题(Key / Base URL / 变量名) |
| 30% | 服务方状态(限流 / 过载 / 故障) |
| 20% | 请求内容(参数 / 结构 / 长度) |
| 10% | 网络链路(DNS / 代理 / 证书) |
修法
- 确认 arguments 是字符串
- tool_calls 空数组要传 null 而不是 []
- 检查 id 是否唯一
责任判定表
| 现象 | 责任方 |
|---|---|
| 换请求内容仍然报 | 配置或服务方 |
| 换站点/换网络就好 | 那一侧的问题 |
| 只有特定条件触发 | 你的请求 |
你在这个站点上遇到过这个问题?
认领站点后可补充证据、申请公开核验;认证不改榜单排序,只对应可复核的检测与复测。
认领 / 申请认证