写 Agent 最头疼的就是工具调用老是失败。总结一下我遇到的高频坑：

1. 工具描述写得太含糊，模型不知道什么时候该调
2. 参数 schema 定义不规范，模型瞎填
3. 没有做错误重试，一次失败就中断
4. 上下文窗口塞太多历史，模型迷失
5. 工具返回结果太长，被截断

尤其是第 2 点，JSON schema 一定要写清楚 required 字段和类型。

大家还有什么坑？欢迎补充。