コンテンツにスキップ

リリースプロセス / 変更履歴

本プロジェクトは、0.Y.Z 形式のセマンティックバージョニングを少し改変したものに従っています。先頭の 0 は、この SDK が依然として急速に進化していることを示します。各コンポーネントは次のようにインクリメントします。

マイナー ( Y ) バージョン

ベータとしてマークされていない公開インターフェースに対する 破壊的変更 がある場合、マイナー バージョン Y を増やします。たとえば、0.0.x から 0.1.x への移行には破壊的変更が含まれる可能性があります。

破壊的変更を避けたい場合は、プロジェクトで 0.0.x バージョンにピン留めすることを推奨します。

パッチ ( Z ) バージョン

Z は非破壊的変更でインクリメントします。

  • Bug 修正
  • 新機能
  • 非公開インターフェースの変更
  • ベータ機能の更新

破壊的変更の変更履歴

0.10.0

このマイナー リリースは破壊的変更を 導入しません が、OpenAI Responses ユーザー向けの重要な新機能領域として、Responses API の websocket トランスポート対応が含まれます。

主なポイント:

  • OpenAI Responses モデル向けの websocket トランスポート対応を追加しました (オプトイン。既定のトランスポートは引き続き HTTP です)。
  • 複数ターンの実行にまたがって websocket 対応の共有プロバイダーと RunConfig を再利用するための responses_websocket_session() ヘルパー / ResponsesWebSocketSession を追加しました。
  • ストリーミング、ツール、承認、フォローアップ ターンを扱う websocket ストリーミングの新しい例 ( examples/basic/stream_ws.py ) を追加しました。

0.9.0

このバージョンでは、Python 3.9 のサポートが終了しました。このメジャー バージョンは 3 か月前に EOL に達しています。より新しいランタイム バージョンへアップグレードしてください。

加えて、Agent#as_tool() メソッドが返す値の型ヒントは、Tool から FunctionTool に絞り込まれました。この変更は通常は破壊的な問題を引き起こしませんが、より広い union 型に依存しているコードの場合は、適宜調整が必要になることがあります。

0.8.0

このバージョンでは、実行時の振る舞いの変更が 2 点あり、移行作業が必要になる可能性があります。

  • 同期 の Python callable をラップする関数ツールは、イベントループ スレッド上で実行するのではなく、asyncio.to_thread(...) を介してワーカー スレッド上で実行されるようになりました。ツールのロジックがスレッドローカル状態やスレッドアフィンなリソースに依存している場合は、async のツール実装へ移行するか、ツールコード内でスレッド アフィニティを明示してください。
  • ローカル MCP ツールの失敗ハンドリングが設定可能になり、既定の挙動では、実行全体を失敗させるのではなく、モデルから見えるエラー出力を返すことがあります。fail-fast のセマンティクスに依存している場合は、mcp_config={"failure_error_function": None} を設定してください。サーバーレベルの failure_error_function 値はエージェントレベルの設定を上書きするため、明示的なハンドラーを持つ各ローカル MCP サーバーで failure_error_function=None を設定してください。

0.7.0

このバージョンでは、既存アプリケーションに影響し得る振る舞いの変更がいくつかあります。

  • ネストされた ハンドオフ 履歴は オプトイン になりました (既定では無効)。v0.6.x の既定のネスト挙動に依存していた場合は、RunConfig(nest_handoff_history=True) を明示的に設定してください。
  • gpt-5.1 / gpt-5.2 の既定の reasoning.effort が "none" に変更されました (SDK 既定値として設定されていた従来の既定値 "low" から変更)。プロンプトや品質/コスト プロファイルが "low" に依存していた場合は、model_settings で明示的に設定してください。

0.6.0

このバージョンでは、既定の ハンドオフ 履歴は raw の ユーザー / assistant のターンを公開するのではなく、単一の assistant メッセージにパッケージされるようになり、下流の エージェント に簡潔で予測可能な要約を提供します。 - 既存の単一メッセージの ハンドオフ 文字起こしは、既定で <CONVERSATION HISTORY> ブロックの前に「For context, here is the conversation so far between the user and the previous agent:」から始まるようになり、下流の エージェント が明確にラベル付けされた要約を受け取れるようになりました

0.5.0

このバージョンでは目に見える破壊的変更は導入されませんが、新機能と、内部実装上のいくつかの重要な更新が含まれます。

  • RealtimeRunner が SIP protocol connections を扱えるようにするサポートを追加しました
  • Python 3.14 互換性のために、Runner#run_sync の内部ロジックを大幅に改訂しました

0.4.0

このバージョンでは、openai パッケージの v1.x はサポート対象外になりました。この SDK と併せて openai v2.x を使用してください。

0.3.0

このバージョンでは、Realtime API のサポートが gpt-realtime モデルおよびその API インターフェース ( GA バージョン ) に移行します。

0.2.0

このバージョンでは、従来は引数として Agent を受け取っていた一部箇所が、代わりに AgentBase を受け取るようになりました。たとえば、MCP サーバーの list_tools() 呼び出しです。これは純粋に型付け上の変更であり、引き続き Agent オブジェクトを受け取ります。更新するには、Agent を AgentBase に置き換えて型エラーを修正するだけです。

0.1.0

このバージョンでは、MCPServer.list_tools() に 2 つの新しい params が追加されました: run_context と agent です。MCPServer をサブクラス化しているクラスには、これらの params を追加する必要があります。