OpenAI Agents SDK releases· openai-sdks[bot]·· 21 小时前
OpenAI Agents SDK v0.25.0 发布:移除 Beta Runloop 并调整 Pydantic 上下文检查点
v0.25.0
要点速览
OpenAI Agents SDK v0.25.0 发布,移除 Beta Runloop 并更改 Pydantic 上下文检查点方式,要求 Runloop 用户在切换前保留工作区数据,跨工作线程共享检查点需先升级读取器。新版本支持使用 RunState schema 1.22 继续嵌套智能体工具审批,Pydantic 检查点保留默认值和就地编辑,并需为进程本地资源使用自定义序列化器。
正文
0.25.0 (2026-11-17)
Key Changes
Version 0.25.0 removes the beta Runloop sandbox provider and changes how Pydantic run contexts are checkpointed. Runloop users should preserve their workspace data before switching providers. Applications that share checkpoints across workers should upgrade readers first.
Highlights:
- Migrate Runloop workloads to another supported sandbox provider, such as Modal, or remain on 0.24.0 while migrating. Provider-specific sessions and snapshots require a separate data migration.
- Resume nested agent-tool approvals with output guardrails using RunState schema
1.22. Pydantic checkpoints now preserve default values and in-place edits. Use a custom serializer for process-local resources. OpenAIResponsesCompactionSessionnow defaults togpt-6-luna. Setmodel="gpt-4.1"to keep the previous choice. Agent model settings also follow the selected model more closely. Native Chat Completions tool requests forgpt-6-solandgpt-6-lunadefault to non-reasoning mode when no effort is supplied.- Runner handoffs can opt into recovery with
failure_error_function. Omitting it preserves exception propagation. The demo REPL can now approve or reject individual tool calls. - MCP v2 Streamable HTTP supports concurrent requests. MCP v1 retains serialized requests. Failed and incomplete Responses calls now retain provider-reported token usage.
Features
- expose utilities for third-party session adapters (#5428) (16fdb20)
- sandbox: remove Runloop provider (#5369) (12ce34d)
Bug Fixes
- avoid loading workspace startup files during internal sandbox operations (#5406) (841dfdd)
- preserve nested ToolContext approval decisions across resume (#5633) (c200ae8)
- avoid repeatedly fingerprinting completed tool calls (#5421) (dda19f9)
- add opt-in handoff error recovery (#5418) (a6ed84f)
- align implicit settings with provider-selected models (#5425) (a88d291)
- align model defaults with TS SDK (#6064) (d5287b7)
- allow concurrent Streamable HTTP requests on MCP v2 (#5641) (2b90566)
- default GPT-6 Chat Completions tool requests to non-reasoning (#5420) (3396dca)
- deps-dev: bump aiohttp from 3.14.3 to 3.14.5 (#5403) (442d0ea)
- deps-dev: bump dapr from 1.18.3 to 1.19.0 (#5711) (25e7b2e)
- deps-dev: bump fastapi from 0.141.1 to 0.162.2 (#6053) (494c0c0)
- deps-dev: bump playwright from 1.50.0 to 1.63.0 (#5402) (0dc4cf1)
- deps-dev: bump pytest from 9.0.3 to 9.2.0 (#5710) (b0051a7)
- deps-dev: bump rich from 14.3.3 to 15.0.0 (#6055) (18d979b)
- deps-dev: bump ruff from 0.16.8 to 0.17.1 (#5439) (5bb6fb7)
- deps-dev: bump twilio from 9.11.1 to 9.12.0 (#5486) (465583d)
- deps-dev: bump websockets from 15.0.1 to 16.1.1 (#5484) (86bd298)
- deps: allow websockets 17 (#6044) (9d0f5e8)
- deps: bump actions/create-github-app-token from 3.2.0 to 3.3.0 (#5464) (b8df4ff)
- deps: bump actions/download-artifact from 8.0.1 to 8.0.2 (#5466) (eccd8c8)
- deps: bump actions/setup-python from 7.0.0 to 7.1.0 (#5465) (18d233b)
- deps: bump astral-sh/setup-uv from 10.2.0 to 10.3.2 (#5463) (1ed8268)
- deps: bump certifi from 2026.10.19 to 2026.10.23 (#5709) (976f2f1)
- deps: bump daytona from 0.155.0 to 0.226.1 (#5487) (d4f07df)
- deps: bump httpx2 from 2.12.0 to 2.14.0 (#5438) (0c55458)
- deps: bump mcp from 2.0.0 to 2.2.0 (#5393) (97c8288)
- deps: bump mcp from 2.0.0 to 2.3.0 (#5404) (e2de6a8)
- deps: bump openai from 3.29.0 to 3.48.0 (#6054) (a4a4fa4)
- deps: bump opentelemetry-api from 1.40.0 to 1.45.1 (#5410) (2964f77)
- deps: bump opentelemetry-api from 1.45.1 to 1.45.2 (#5983) (cdc8d58)
- deps: bump pydantic from 2.14.2 to 2.14.3 (#6052) (4bb2637)
- deps: bump starlette from 1.6.0 to 1.7.0 (#5708) (82483dd)
- deps: bump the codeql group with 2 updates (#5462) (775707e)
- deps: require certifi 2026.10.19 or later (#5429) (6295010)
- deps: require pymongo 4.18.3 or later (#5445) (57027de)
- deps: update fastapi requirement from >=0.142.2 to >=0.143.0 in /examples/realtime/twilio_sip (#5399) (6bfa5ff)
- deps: update fastapi requirement from >=0.143.0 to >=0.150.0 in /examples/realtime/twilio_sip (#5435) (56df6b4)
- deps: update fastapi requirement from >=0.150.0 to >=0.162.0 in /examples/realtime/twilio_sip (#5482) (803fbf2)
- deps: update fastapi requirement from >=0.162.0 to >=0.162.2 in /examples/realtime/twilio_sip (#6051) (9a3bce3)
- deps: update httpx2 requirement from >=2.13.1 to >=2.15.1 in /examples/realtime/twilio (#5432) (4134643)
- deps: update httpx2 requirement from >=2.13.1 to >=2.15.1 in /examples/realtime/twilio_sip (#5436) (a91f0bf)
- deps: update httpx2 requirement from >=2.15.1 to >=2.16.0 in /examples/realtime/twilio (#5478) (16c3a3f)
- deps: update httpx2 requirement from >=2.15.1 to >=2.16.0 in /examples/realtime/twilio_sip (#5483) (39a123b)
- deps: update openai requirement from <4,>=3.26.0 to >=3.29.0,<4 in /examples/realtime/twilio_sip (#5398) (0e54e4b)
- deps: update openai requirement from <4,>=3.29.0 to >=3.35.1,<4 in /examples/realtime/twilio_sip (#5434) (2350082)
- deps: update openai requirement from <4,>=3.35.1 to >=3.39.0,<4 in /examples/realtime/twilio_sip (#5480) (13dbaa3)
- deps: update openai requirement from <4,>=3.39.0 to >=3.42.1,<4 in /examples/realtime/twilio_sip (#5707) (6e590a0)
- deps: update openai requirement from <4,>=3.42.1 to >=3.48.0,<4 in /examples/realtime/twilio_sip (#6050) (5e0f944)
- deps: update python-multipart requirement from >=0.0.32 to >=0.0.33 in /examples/realtime/twilio (#5706) (64fbde5)
- deps: update starlette requirement from >=1.7.0 to >=1.9.0 in /examples/realtime/twilio (#5433) (26c762a)
- deps: update starlette requirement from >=1.7.0 to >=1.9.0 in /examples/realtime/twilio_sip (#5437) (b6966fa)
- deps: update starlette requirement from >=1.9.0 to >=1.10.0 in /examples/realtime/twilio (#5479) (f137418)
- deps: update starlette requirement from >=1.9.0 to >=1.10.0 in /examples/realtime/twilio_sip (#5481) (814de8b)
- deps: update twilio requirement from <10,>=9.11.2 to >=9.12.0,<10 in /examples/realtime/twilio (#5397) (452c5bd)
- deps: update twilio requirement from <10,>=9.12.0 to >=9.13.0,<10 in /examples/realtime/twilio (#6049) (e27451c)
- flatten restored handoff history summaries (#6041) (7635b81)
- improve missing stream completion diagnostics (#5457) (e355d69)
- limit the Daytona extra to the supported 0.x SDK (#6065) (fd78fa0)
- preserve append order in SQLAlchemy sessions (#5645) (89a3ea4)
- preserve empty structured shell results (#5423) (963d032)
- Preserve nested handoff record boundaries (b040da5)
- preserve pending async calls in committed sessions (#6039) (f48003a)
- preserve pending input history across streamed retries (#6042) (9e05bd5)
- preserve Pydantic run context snapshots (#5444) (bc4c6e1)
- preserve structured tool input in agent lifecycle hooks (#6037) (e3538bd)
- preserve usage from failed and incomplete Responses calls (#6046) (6e6707c)
- preserve wire aliases when reading Conversations session history (#6047) (5789c7c)
- preserve wire aliases when replaying Responses items (#5638) (71bab8c)
- raise MCP minimum to 1.21.2 for Pydantic and OAuth compatibility (#5384) (970db99)
- realtime: honor explicit interruption with automatic VAD (#5427) (addc737)
- remove retry advice from the default tool error message (#5632) (fa7f312)
- remove unused EFS installer from sandbox mount example (#6038) (0777ee6)
- replay ID-less assistant output in Chat Completions sessions (#5419) (28c29bc)
- report completed input guardrails when a tripwire fires (#5634) (2cc15af)
- report completed output guardrails when a tripwire fires (#6040) (4bab6ea)
- report missing function approval owners during RunState restore (#5630) (788fb99)
- require patched MCP dependency versions (#5431) (b235388)
- Responses tool choice for functions named after hosted tools (#5639) (3ac005f)
- Restore checkpointed assistant text in Chat Completions (8ffdf21)
- resume nested approval checkpoints with output guardrails (#5629) (3599632)
- retain tool guardrail results after approval and resume (#5643) (3a0c89c)
- sessions: bounded session replay and isolate the Cloudflare mount test (#5637) (4920e5b)
- skip streamed model attempts after an input guardrail trips (#5644) (8ea4333)
- stop native tool queues during function failure cleanup (#5446) (cd26bbb)
- tool approval handling in the demo REPL (#6045) (d4d835e)
- trace offered tools on Chat Completions generation spans (#5635) (bb36fae)
- use gpt-6-luna for session compaction by default (#5646) (1fc77bb)
来源: OpenAI Agents SDK releases · github.com