Anthropic API:代码执行工具新版本揭示90秒限制,网络工具新增response_inclusion参数
Anthropic发布了三项API工具的小幅但实用的改进。代码执行工具现在在工具描述中明确标注了每个单元格90秒的执行限制,而web_search和web_fetch则新增了response_inclusion参数,可降低代理管道中的令牌成本。
本文由人工智能基于一手来源生成。
Anthropic于2026年6月11日发布了三项API工具的小幅但具有技术价值的升级,这些工具在代理式(agentic)管道中被广泛使用。本次变更旨在解决生产环境中出现的两个问题:代码执行时意外超时,以及长时多步会话中令牌成本过高。
代码执行工具:Claude现在知晓90秒限制
代码执行工具的新版本标识为**code_execution_20260521。核心变化看似简单:API接口中的工具描述现在明确指出每个单元格的执行限制为90秒**。
为何这在实践中重要?
在此前的版本中,该限制客观存在,但Claude在工具上下文中并不掌握这一正式信息。后果是:当代理启动耗时较长的计算——例如遍历大型数据集、复杂数值模拟或机器学习评估——单元格会直接超时,代理收到错误却没有明确原因。
有了新版本,Claude从获取工具描述的那一刻起就掌握了限制信息,可将其用于规划:将任务拆分为能在时间窗口内完成的更小片段,评估是否需要采用不同的处理方式,或主动提醒用户该计算耗时超出了单次处理的范围。
无需beta header。该变更可立即在所有使用新版工具的生产环境中使用。
新增response_inclusion参数有何作用?为何节省令牌?
web_search_20260318和web_fetch_20260318——网络搜索和URL内容获取工具的新版本——引入了共同参数**response_inclusion**。
工作机制
在典型的代理管道中,代理调用web_search,获取结果,分析后继续下一步。在标准模式下,已消耗的结果块(consumed result blocks)仍保留在API响应中,并被计入返回给客户端的令牌数。在包含大量网络调用的长时会话中,这会累积成可观的成本。
response_inclusion参数允许开发者将这些已消耗的块从API响应中排除——Claude已经读取并使用了这些信息;没有理由再返回并作为输出令牌计费。
适用人群?
该变更对以下场景尤为有用:
- 在单次会话中执行数十次网络搜索和内容获取的研究代理
- 将网络获取与内部知识库相结合的RAG(检索增强生成)管道
- 定期检查网络来源并生成综合摘要的监控代理
节省幅度取决于结果大小和步骤数量,但在包含大量网络调用的长时代理会话中,差异可能相当可观。
此处同样无需beta header。两个工具均可立即用于生产环境。
背景:小改动,实际效果
这三项更新并未引入新能力——Claude此前已能搜索网络和执行代码。这些是工程层面的修复,解决的是开发者在生产环境中反映的具体痛点:因超时导致的意外错误,以及代理循环中不必要的高令牌成本。
这两项变更的结合——更好的代码执行限制感知能力,以及降低的网络调用开销——直接面向那些构建长时间运行、自主代理式环境的开发者。在这类环境中,每一个不必要的令牌和每一个本可预见的错误都意味着真实的成本。
常见问题
- code_execution_20260521版本有何新变化?对代理系统有何帮助?
- 代码执行工具现在在工具描述中明确披露了每个单元格90秒的执行限制。Claude由此可以自主安排长时间计算——例如将其拆分为更小的片段——而不会超出限制并导致错误。
- web_search和web_fetch工具的新response_inclusion参数有何作用?
- response_inclusion允许将已消耗的结果块从API响应中排除。在长时代理会话中,这可以直接减少返回和计费的令牌数量,而不会丢失代理下一步所需的相关信息。
- 使用这些新版API工具是否需要beta header?
- 不需要。三个版本——code_execution_20260521、web_search_20260318和web_fetch_20260318——均无需beta header,可立即在生产环境中使用。
📬 AI 新闻直达您的邮箱
按您的方式定制每日摘要——自选主题、来源和频率,一键退订。