OpenAI Agents SDK Python 0.25.0 会回滚失败交接的副作用吗?

作者:橙子时间:2026-11-18 08:38:20浏览:561

OpenAI Agents SDK Python 0.25.0 正式版移除内置 Runloop 提供方,并新增显式选择的 handoff 错误恢复,保留默认异常行为。

错误恢复可以给原代理返回反馈,但不会撤销回调已经产生的副作用。取消和部分后续钩子异常仍会传播。

OpenAI Agents SDK Python 品牌封面

错误恢复不会撤销回调副作用

该处理覆盖应用的交接调用回调异常,但不会回滚已经发生的回调副作用。取消、错误格式化函数本身的异常,以及交接成功后转移钩子或输入过滤器的异常仍会传播。该入口适用于 Runner,不覆盖 Realtime 会话。

OpenAI Agents SDK Python 本次官方发布内容

交接失败恢复需要显式设置

handoff 增加 failure_error_function,供 Runner 在调用失败时生成返回给原代理的错误反馈。默认值为空时,异常仍向外传播。显式配置处理函数后,原调用代理可以继续回应或尝试恢复,无需把失败当作已完成的代理交接。

会话与守卫结果也有保留修复

这个版本还修复了恢复时的嵌套交接记录边界、待处理异步调用和流式重试输入历史的保留。守卫触发后已完成的结果,以及失败或未完成响应中的用量记录,也有针对性的保留修复。

升级前需要核对 Runloop 依赖

OpenAI Agents SDK Python 0.25.0 正式版移除了内置 Runloop 沙箱提供方,包含实现、引用文档和示例。依赖该内置入口的应用需要在升级前评估自己的沙箱适配代码。SDK 其它沙箱提供方的适用条件仍由各自实现决定。

作者最新文章