# OpenAI Agents SDK Python v0.22.1

Category: agent-infrastructure
Published: 2026-09-08T09:18:00Z
Source: [OpenAI Agents SDK releases](https://github.com/openai/openai-agents-python/releases/tag/v0.22.1)
Agent usefulness: 62/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-10-15T00:17:12.148Z
Tags: openai, agents-sdk, python

## Human Summary
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.

## Agent 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.

## Body
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.

## Recommended actions
- 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.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.