OpenAI Agents SDK 0.21.1：新增模型超时与沙箱隔离

OpenAI Agents SDK Python 0.21.1 发布

OpenAI 于 2026 年 8 月 16 日 22:28（UTC）在官方 GitHub 发布 Agents SDK Python v0.21.1，对应北京时间 8 月 17 日 06:28。这次更新没有发布新模型，重点是提高 Agent 长任务的超时控制、沙箱安全性和运行稳定性。

主要改动

• 模型调用超时：新增 ModelSettings.timeout，可为每一次模型调用尝试设置超时。超时后抛出 ModelTimeoutError，并接入现有重试策略。
  
• 按运行设置工作目录：新增 SandboxRunConfig.cwd，让同一个受信沙箱会话中的不同运行使用各自的相对路径基准，改善多任务并行时的路径管理。
  
• Docker 沙箱可关闭网络：DockerSandboxClientOptions 新增可选的 network_mode="none"，需要时可创建完全无网络的容器；恢复沙箱时也会保留该设置。
  
• Modal 资源限制：Modal 沙箱现在可配置 CPU 和内存请求或上限。
  
• 审批与稳定性修复：精确到单次工具调用的审批决定会优先于默认审批状态；同时修复 Realtime、SQLite Session、路径规范化和用量统计等问题。
  

适合哪些开发者

这次版本更适合运行代码执行、文件操作、长链路工具调用或多租户 Agent 的团队。模型调用超时能避免单次请求长期占用任务；运行级工作目录有助于降低不同任务之间的路径混淆；无网络 Docker 沙箱则适合不需要外网访问的受控代码执行场景。

实际影响与限制

• 超时作用于每一次模型调用尝试，不是整次 Agent Run 的总时限。
  
• 有状态请求不会在无法确认安全重放时自动重试，流式输出已经对用户可见后也不会盲目重放。
  
• SandboxRunConfig.cwd 只改变相对路径解析，不提供文件系统或计算资源隔离；需要强隔离时仍应使用独立沙箱会话。
  
• Docker 断网能力是可选项，未显式设置时仍保持原有网络行为。
  
• 升级前应在测试环境验证自定义重试、审批快照和沙箱恢复流程。
  

官方来源

正式 Release：OpenAI Agents SDK Python v0.21.1

模型调用超时说明：PR #4428

运行级工作目录说明：PR #4427

Docker 沙箱断网说明：PR #4452