OpenAI、エージェントSDK「openai-agents-python」v0.21.0 — プロバイダー非依存の決定論的テストAPIとOpenAI Python v3対応

OpenAIが開発するマルチエージェントワークフロー向けPythonフレームワーク「openai-agents-python」は2026年8月15日、v0.21.0をリリースした。今回のマイナーリリースは「既知の破壊的変更を含まない」とされ、バージョン番号の引き上げは新設されたプロバイダー非依存のテストAPIと、OpenAI Python SDK v3（openai>=3.0.0,<4）への互換更新が理由と説明されている。テスト容易性と実行基盤の堅牢化を中心に、多数の修正が含まれる。

プロバイダー非依存の決定論的テストAPI

v0.21.0の目玉は、テスト用の新モジュール群だ。agents.testing、agents.realtime.testing、agents.voice.testing が追加され、プロバイダーへの実リクエストを送らずに、エージェント・サンドボックス・Realtime・音声ワークフローのテストを決定論的に実行できるようになった。

• agents.testing：スクリプト化されたモデルを使うテストユーティリティ（scripted model test utilities）を提供
• agents.realtime.testing：Realtime APIのワークフローを実リクエストなしでテスト
• agents.voice.testing：音声ワークフローを決定論的にテスト
• サンドボックスについては、スクリプト化されたセッションタイプ（scripted sandbox session type）も公開された
• 公開APIコントラクトの固定（freeze）も同時に行われ、将来のSDKリリース間でテストAPIの挙動が変わらないように配慮されている

OpenAI Python v3／HTTPX2への互換更新

OpenAIプロバイダーの依存バージョンが openai>=3.0.0,<4 に更新され、HTTPX2を前提としたリクエスト・レスポンス・トランスポート・例外処理に対応した。openaiパッケージのv3系への移行が進む中、SDK側の互換性を先取りする形だ。

• OpenAI Python SDK v3（openai>=3.0.0,<4）に対応
• HTTPX2を考慮したリクエスト・レスポンス・トランスポート・例外処理を実装
• 変換済みツール（converted tools）とResponses APIの並列ツール呼び出しの整合を修正

実行基盤の堅牢化とエッジケースの修正

テストAPIに加えて、長時間実行するエージェントの信頼性に関わる修正も多数含まれる。割り込み（interruption）時の状態スナップショットの分離、再帰的なエージェントツール承認の再開、最大ターン到達時のセッション処理、ストリーミング終了時のクリーンアップなどが強化された。

• RunStateの割り込みスナップショットを分離し、チェックポイント時のツール決定を隔離
• 再帰的なエージェントツール承認を再開可能にし、最大ターン到達時のセッション意味論を修正
• ストリーム終了が致命的失敗で終わった場合にモデルストリームを確実にクローズ
• 出力型バリデーションエラーからツール出力値をredactし、機微情報の漏えいを防止
• MCP：ツールキャッシュを呼び出し元に渡さないようにし、ライフサイクル状態スナップショットを保護、リトライのバックオフ上限を設定可能に
• サンドボックス：Runloopの既存シークレット参照に対応し、view_imageの追加パス権限を尊重
• 音声：無効なチャンネル数・フレームレート・不完全なマルチチャンネルフレーム・非有限のオーディオレートを拒否する検証を強化

なお、本記事の内容はGitHubの公式リリースノート（v0.21.0、2026年8月15日付）に基づく。リポジトリはMITライセンスで公開されており、スター数は約2.8万。リリースにはこの他にも多数のバグ修正とドキュメント更新が含まれる。

出典: openai/openai-agents-python v0.21.0 Release Notes（2026-08-15確認）、openai/openai-agents-python（GitHub）（2026-08-15確認）。