---
search:
  exclude: true
---
# リリースプロセス / 変更履歴

本プロジェクトは、`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](https://platform.openai.com/docs/guides/realtime-sip) を扱えるようにするサポートを追加しました
- Python 3.14 互換性のために、`Runner#run_sync` の内部ロジックを大幅に改訂しました

### 0.4.0

このバージョンでは、[openai](https://pypi.org/project/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()`][agents.mcp.server.MCPServer] に 2 つの新しい params が追加されました: `run_context` と `agent` です。`MCPServer` をサブクラス化しているクラスには、これらの params を追加する必要があります。