## 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](https://github.com/openai/openai-agents-python/releases/tag/v0.21.1) 模型调用超时说明：[PR #4428](https://github.com/openai/openai-agents-python/pull/4428) 运行级工作目录说明：[PR #4427](https://github.com/openai/openai-agents-python/pull/4427) Docker 沙箱断网说明：[PR #4452](https://github.com/openai/openai-agents-python/pull/4452)