New Hot

OpenAI Agents SDK 0.25.0 发布:第三方会话适配器与 MCP v2 并发支持能力

OpenAI Agents SDKAgentSDK版本更新

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 的移除属于行为变化;生产环境建议先在分支验证。

相关阅读:CrewAI 1.15.41 发布:允许受信任的私有 URL 主机并修复 PyMuPDF 依赖等多个问题。

常见问题

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

搜索文章

输入关键词,快速查找标题和正文内容。