OpenAI Agents SDK 0.25.0 发布:第三方会话适配器与 MCP v2 并发支持能力
OpenAI Agents SDK 0.25.0 发布,新增第三方会话适配器工具,支持 handoff 错误恢复与 MCP v2 并发 Streamable HTTP 请求;同时移除 sandbox 的 Runloop provider,并把会话压缩默认模型改为 gpt-6-luna。
Agents SDK 0.25.0 移除 Runloop provider 并新增会话适配器
0.25.0 是兼容性 minor 版本,移除 sandbox 的 Runloop provider,新增第三方会话适配器与 handoff 错误恢复。 官方发布评审给出了可发布的结论。
会话与 handoff
SDK 开始暴露第三方会话适配器所需的工具,方便把外部会话存储接进 Agents 运行流程。handoff 增加了可选的错误恢复,嵌套的审批决策也能在恢复后保留。官方原文称:“add opt-in handoff error recovery”。(来源:OpenAI Agents SDK 官方发布)
MCP v2 与并发请求
MCP v2 允许并发 Streamable HTTP 请求,同时 SDK 把 MCP 依赖的最低版本提高到 1.21.2。依赖旧版 MCP 的项目需要在升级前确认 OAuth 与 Pydantic 兼容性。
sandbox 与默认模型
sandbox 里的 Runloop provider 被移除,使用它的项目要改用其他 sandbox 后端。会话压缩默认模型改为 gpt-6-luna,Chat Completions 的工具请求默认按非推理模式处理。
外部会话存储接入与 handoff 错误恢复
已经用 Agents SDK 搭生产流程的团队需要关注 MCP 依赖与 sandbox 配置,新项目可以直接按 0.25.0 起步。 会话适配器与错误恢复降低了接入外部存储的成本。
外部会话存储更好接
第三方会话适配器工具暴露后,你可以把自建的会话表、缓存或托管存储接进 SDK,而不必改动 Agent 主流程。
长会话恢复更完整
handoff 错误恢复是可选能力,开启后任务移交失败可以按既定路径恢复。审批决策与嵌套 handoff 的边界也被一起修复。
升级前要检查 MCP 与 sandbox
MCP 最低版本与 sandbox provider 都有变化。仍在用 Runloop provider 或旧版 MCP 的项目,需要先完成迁移再升级。
新项目可直接用 0.25.0,旧项目先迁移 sandbox
新项目建议直接使用 0.25.0;已有项目先检查 MCP 依赖和 sandbox 配置,再决定升级时间。 官方把它定义为兼容的 minor 版本。
谁适合现在升级
需要第三方会话适配、handoff 恢复或 MCP v2 并发的项目收益最明显。只用基础 Agent 循环、依赖旧 sandbox 的项目可以稍后再升。
怎么升级
按 Python 包管理方式升级到 openai-agents 0.25.0,并把 MCP 依赖提升到 1.21.2 以上。升级后重点验证 handoff 恢复、并发 Streamable HTTP 请求与会话压缩。
回退与兼容
官方未披露回退步骤。从官方描述看,本次为兼容性 minor 版本,但 sandbox provider 的移除属于行为变化;生产环境建议先在分支验证。
常见问题
- OpenAI Agents SDK 0.25.0 新增了什么能力?
- 新增第三方会话适配器工具,加入可选的 handoff 错误恢复,并允许 MCP v2 并发 Streamable HTTP 请求。
- Agents SDK 0.25.0 移除了什么组件?
- sandbox 里的 Runloop provider 被移除;依赖该 provider 的项目需要先调整 sandbox 配置。
- Agents SDK 0.25.0 的会话压缩默认模型是什么?
- 会话压缩默认改用 gpt-6-luna,Chat Completions 的工具请求也默认走非推理模式。
- OpenAI Agents SDK 0.25.0 是破坏性升级吗?
- 官方发布评审把 0.25.0 定为兼容的 minor 版本,但 MCP 依赖最低版本提高到 1.21.2。
相关术语
- Agents SDK
- Agents SDK 是 OpenAI 提供的 Agent 开发库,负责模型调用、工具执行与会话状态。
- handoff
- handoff 是 Agent 之间移交任务与会话上下文的机制,本次加入可选的错误恢复。
- MCP
- MCP 是模型连接外部工具与数据源的协议,v2 支持 Streamable HTTP 传输。
- 会话压缩
- 会话压缩是把过长的对话历史摘要成较短上下文的过程,用于控制 token 占用。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- OpenAI Agents SDK v0.25.0 · OpenAI · 2026-11-18
「OpenAI Agents SDK v0.25.0」 —— OpenAI
文章目录