OpenAI Agents Python SDK v0.22.1 enhances tools, guardrails, and voice features
The OpenAI Agents Python SDK v0.22.1 introduces new features like support for image results in web search tools, customizable output guardrail messages, and server-wide guardrails for MCP tools. It also adds configurable Unix-local environment isolation and exposes streamed transcription options. These updates improve agent capabilities, control, and operational flexibility within the SDK, benefiting developers building intelligent agents. This release also includes a significant number of bug fixes across core components, chat completions, sandbox, and session management, enhancing overall stability.
- →document v0.22.0 behavior changes by @seratch in https://github.com/openai/openai-agents-python/pull/4522
- →fix wording in handoff example prompts by @Chair403 in https://github.com/openai/openai-agents-python/pull/4520
- →preserve English heading anchors in translated pages by @saime428 in https://github.com/openai/openai-agents-python/pull/4580
- →refresh tracing integration links by @seratch in https://github.com/openai/openai-agents-python/pull/4634
- →clarify capability visibility and authorization by @seratch in https://github.com/openai/openai-agents-python/pull/4642
Maintenance (26) ›
- docs document v0.22.0 behavior changes by @seratch in https://github.com/openai/openai-agents-python/pull/4522
- docs fix wording in handoff example prompts by @Chair403 in https://github.com/openai/openai-agents-python/pull/4520
- docs preserve English heading anchors in translated pages by @saime428 in https://github.com/openai/openai-agents-python/pull/4580
- docs refresh tracing integration links by @seratch in https://github.com/openai/openai-agents-python/pull/4634
- docs clarify capability visibility and authorization by @seratch in https://github.com/openai/openai-agents-python/pull/4642
- docs clarify database driver installation for SQLAlchemy sessions by @rioyu123 in https://github.com/openai/openai-agents-python/pull/4743
- docs skip reference pages on Windows by @sylvesterkaczmarek in https://github.com/openai/openai-agents-python/pull/4761
- docs clarify requested state consistency guarantees by @rksharma-owg in https://github.com/openai/openai-agents-python/pull/4903
- docs make the encrypted session quick start self-contained by @rioyu123 in https://github.com/openai/openai-agents-python/pull/4909
- fix freeze the public voice API contract by @seratch in https://github.com/openai/openai-agents-python/pull/4578
- fix enforce public type alias contract coverage by @seratch in https://github.com/openai/openai-agents-python/pull/4595
- fix route verification changes and require confirmed docs-only pushes by @seratch in https://github.com/openai/openai-agents-python/pull/4880
- fix propagate the serial test runner's exit code on Windows by @MohammedAlkindi in https://github.com/openai/openai-agents-python/pull/4771
- fix harden PyPI publishing and require manual release tags by @seratch in https://github.com/openai/openai-agents-python/pull/4726
- fix require complete policy for new public TypedDicts by @seratch in https://github.com/openai/openai-agents-python/pull/4900
- fix simplify verification and stabilize sandbox tests by @seratch in https://github.com/openai/openai-agents-python/pull/4916
- fix consolidate Docker-backed integration tests by @seratch in https://github.com/openai/openai-agents-python/pull/4667
chore(deps): bump actions/download-artifact from 4.3.0 to 8.0.1 by @dependabot[bot] in https://github.com/openai/openai-agents-python/pull/4802
chore(deps): bump actions/upload-artifact from 4.6.2 to 7.0.1 by @dependabot[bot] in https://github.com/openai/openai-agents-python/pull/4803
- chore run repository skill tests in dedicated CI by @seratch in https://github.com/openai/openai-agents-python/pull/4881
- refactor separate release contract verification responsibilities by @seratch in https://github.com/openai/openai-agents-python/pull/4878
- perf reduce async stability command startup overhead by @seratch in https://github.com/openai/openai-agents-python/pull/4874
- test make async progress and trace-worker tests deterministic by @seratch in https://github.com/openai/openai-agents-python/pull/4875
- test organize Realtime session tests by responsibility by @seratch in https://github.com/openai/openai-agents-python/pull/4879
- test(sandbox): skip unavailable Windows symlinks by @sylvesterkaczmarek in https://github.com/openai/openai-agents-python/pull/4853
- release 0.22.1 by @seratch in https://github.com/openai/openai-agents-python/pull/4576
https://github.com/openai/openai-agents-python/releases/tag/v0.22.1
Related releases
- Pydantic-AI v2.41.0 Adds Image Generation API, Deprecates `fallback_model` Pydantic AI Releases ·
- pydantic-ai v2.40.0 enhances real-time AI session control and agent events Pydantic AI Releases ·
- crewAI 1.15.20 Released with Platform Tool Fixes CrewAI Releases ·
- CrewAI 1.15.19 Introduces Clipper Integrations and Security Updates CrewAI Releases ·
- Pydantic-AI v2.39.0 Adds OpenAI GPT-6 Astra Support and Bug Fixes Pydantic AI Releases ·
- Pydantic-AI v2.38.1 Adds Gemini/Claude Models, vLLM Support, and Context Window Features Pydantic AI Releases ·