OpenAI Agents SDK Python v0.22.1
OpenAI Agents SDK Python v0.22.1 brings image results in web search tools, customizable guardrail messages, server-wide MCP guardrails, configurable Unix-local sandbox isolation, and numerous fixes across sessions, core execution, and voice streaming.
Why this signal matters
OpenAI released version 0.22.1 of the Agents SDK for Python. Key feature additions include support for image results in web search tools, customizable output guardrail blocked messages, server-wide guardrails for MCP tools, configurable Unix-local environment isolation and Docker container labeling in the sandbox, and exposed streaming transcription options for voice workflows. The release includes substantial bug fixes across several domains: - Core: Enforces fail-closed handling for empty tool arguments, preserves variadic tuple annotations/Field constraints, rejects kwargs key collisions with named tool parameters, fixes stream span drops, and closes model providers created by Runner. - Sessions: Hardens recovery for failed resumed writes, improves concurrent write handling during compaction, and prevents resuming runs where accepted terminal output failed to persist. - Voice & Realtime: Adds support for custom OpenAI TTS voice IDs, enforces redaction of STT prompts and TTS instructions in traces, and corrects cancellation and deadline behaviors in streamed audio. - Sandbox & MCP: Resolves unbounded event loop I/O for UnixLocal workspaces, handles PTY cleanup and cancellation, and prevents tool caching mutation by deep-copying cached MCP tools.
Actionable summary
OpenAI Agents SDK Python v0.22.1 introduces support for image results in web search, server-level MCP guardrails, and customizable output guardrail messages. Key core fixes enforce fail-closed behavior on empty tool arguments, resolve parameter collision/annotation handling, and improve session state recovery and compaction stability.
- Agent usefulness
- 62/100
- Confidence
- 96%
- Canonical data
- JSON + Markdown
What builders should check
- Upgrade openai-agents to v0.22.1 via standard package management.
- Verify tool definition signatures if utilizing kwargs, variadic tuples, or empty argument payloads to ensure compatibility with stricter validation.
- Review MCP tool definitions to leverage new server-wide guardrails where appropriate.
- Test session resumption paths to benefit from enhanced write failure and compaction recovery.