并行调用与工具结果治理
并行工具调用适合彼此独立的读操作，写操作与有依赖的调用要串行。工具返回值是 Agent 上下文的头号杀手：一次查询返回几万 token 会直接把窗口吃光，解法是裁剪、分页、用句柄（handle）代替原文，需要时再取。
也叫：并行工具调用 · 结果裁剪 · 句柄 · handle · 工具返回值
工具返回值：Agent 上下文的头号杀手出自 T3-2
工程上最容易被低估的一点：上下文很贵而磁盘很便宜，但很多工具是照着"给人看"的 API 设计的。传统程序可以流式扫描一万条记录逐条判断，模型必须把这一万条全部读进上下文——相当于为了找一个联系人，从头到尾读完整本通讯录。
Anthropic 在工具设计的工程实践中给出的默认约束值得记住：Claude Code 默认把单次工具返回截断在 25,000 token 上限。这不是模型限制，是产品侧主动设的护栏。你自己的 Agent 也应该有一个这样的数字。
以上节选自T3-2 Function Calling 机制与工具设计——模型其实没有调用任何函数，读全文能看到前后语境。