OpenAI Agents SDK（2026 更新）

• 1: OpenAI Agents SDK 2026（材料）
• 2: OpenAI Agents SDK 2026 讲解

1 - OpenAI Agents SDK 2026（材料）

主要出处：OpenAI，2026-04-15，openai-agents-python v0.14.0 release notes；同日 OpenAI 官方论坛的公告帖（标题即「The next evolution of the Agents SDK」）。官方博客页 openai.com/index/the-next-evolution-of-the-agents-sdk/ 对本机不可访问，本页按上述两处转述。

两层怎么分

公告的措辞是：演进后的 SDK 给模型一个强 harness——指令、工具、审批、追踪、交接、续跑记账，以及 Codex 式 agent 使用的那种模型行为；sandbox 提供 compute——文件、命令、包、产物与隔离。两层可以跑在同一台机器上，也可以分开跑，以获得更好的隔离、持久性与安全性。

公告给出的安全理由值得记：这种分离让凭证与编排留在模型生成代码运行的环境之外。

Manifest：把工作区变成可移植描述

新增 Manifest 抽象，用来描述 Agent 的工作区——暂存本地文件、克隆仓库、创建输出目录、挂载对象存储、挂 Git 仓库。官方说它让同一套流程更容易跨供应商与环境迁移。

权限

文档写明：可以定义 sandbox 用户、把文件权限附着到 Manifest 条目上、让面向模型的工具以指定用户运行；底层映射到标准 Unix 文件权限。给出的例子是：模型对 dataroom/ 只读，同时保留对 output/ 的写权限。

续跑

内置快照与再水化（snapshotting and rehydration）：SDK 可以在一个全新的沙箱里恢复会话，从上次保存的状态继续，而不是从头开始。

沙箱供应商

release notes 列出：本地与容器的 UnixLocalSandboxClient、DockerSandboxClient；托管侧为 Blaxel、Cloudflare、Daytona、E2B、Modal、Runloop、Vercel，另有 bring-your-own 选项。

时间线要分清

• 2026-04-15 发布的是 Python 版（v0.14.0）。TypeScript 侧的 sandbox 相关条目最早出现在 5 月的版本里，所以「当时只有 Python」成立，「TypeScript 计划中」这一说法只有二手来源。
• 这是2025 年 3 月那版的演进，不是新框架。2025 年的条目写的是编排与 tracing，这一版写的是执行环境。

2 - OpenAI Agents SDK 2026 讲解

当时解决了什么问题

2025 年的 Agents SDK 是一套编排积木：单/多 Agent、内置工具、tracing，进程是调用方的，跑在哪由开发者自己决定。到 2026 年，长时程任务把「跑在哪」变成了库必须回答的问题——一个跑几小时的 Agent 需要一份能存活的工作区、一套权限、以及容器没了之后能接着来的办法。

这一版的答案是把环境收进库的抽象里：Manifest 描述工作区长什么样，沙箱供应商是可换的实现，快照负责续跑。

三点值得单独记：

1. 沙箱变成可插拔依赖。同一个 Agent 可以今天跑在 Docker 里、明天跑在托管沙箱上——这是 2024-11 MCP 在工具层的思路，被搬到了执行环境层。
2. 权限映射到 Unix 文件权限。听起来朴素，但它是「Agent 能碰什么」第一次用操作系统里已有的语义表达，而不是自定义一套。
3. 凭证与编排不进模型代码的环境。与 Managed Agents 同一天前后的说法几乎一致，两家显然在解同一道题。

对后续 LLM 与 Agent 的影响

这条与 Managed Agents、Google AX 构成 2026 年上半年的同一件事：执行环境从开发者的选型变成运行时的抽象。

区别在于形态：Managed Agents 是托管服务，AX 是自托管运行时，Agents SDK 是库——托管、自托管、库三条路同时存在，且都收敛到「控制面与执行面分开」。这个三分布局本身就是 2026 年供给侧的实况，不该写成某一家的胜利。