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

このプロジェクトは、`0.Y.Z` 形式を用いた、セマンティックバージョニングを少し修正したものに従います。先頭の `0` は、SDK がまだ急速に進化していることを示します。各コンポーネントは次のとおりインクリメントします。

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

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

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

## パッチ (`Z`) バージョン

非破壊的変更については `Z` をインクリメントします。

- バグ修正
- 新機能
- 非公開インターフェースの変更
- ベータ機能の更新

## 破壊的変更の変更履歴

### 0.9.0

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

また、`Agent#as_tool()` メソッドから返される値の型ヒントが、`Tool` から `FunctionTool` に絞り込まれました。この変更は通常、破壊的な問題を引き起こしませんが、より広いユニオン型に依存しているコードがある場合は、手元でいくつか調整が必要になる可能性があります。

### 0.8.0

このバージョンでは、2 つのランタイム挙動の変更により、移行作業が必要になる場合があります。

- **同期** の Python callable をラップする関数ツールは、イベントループ スレッド上で実行する代わりに、`asyncio.to_thread(...)` によってワーカー スレッド上で実行されるようになりました。ツールのロジックがスレッドローカルな状態やスレッドに依存するリソースに依拠している場合は、async ツール実装へ移行するか、ツールコード内でスレッド アフィニティを明示してください。
- ローカル MCP ツールの失敗時ハンドリングが設定可能になり、デフォルト挙動では、実行全体を失敗させる代わりにモデルから見えるエラー出力を返す場合があります。フェイルファストのセマンティクスに依存している場合は、`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 の user/assistant ターンを露出するのではなく、1 つの assistant メッセージにまとめられるようになり、後続のエージェントに対して簡潔で予測可能な要約を提供します。
- 既存の 1 メッセージのハンドオフ文字起こしは、デフォルトで `<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 つの新しいパラメーター `run_context` と `agent` が追加されました。`MCPServer` をサブクラス化しているクラスには、これらのパラメーターを追加する必要があります。