Skip to content

Commit d00f542

Browse files
docs: update translated document pages (#2759)
1 parent 6fc73a4 commit d00f542

File tree

3 files changed

+108
-75
lines changed

3 files changed

+108
-75
lines changed

docs/ja/release.md

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -4,87 +4,98 @@ search:
44
---
55
# リリースプロセス / 変更履歴
66

7-
このプロジェクトは、`0.Y.Z` 形式を使ったセマンティックバージョニングの少し修正版に従います。先頭の `0` は、SDK が依然として急速に進化していることを示します。各要素は次のようにインクリメントします
7+
このプロジェクトは、`0.Y.Z` 形式を使用する、semantic versioning のやや変更された版に従います。先頭の `0` は、この SDK が依然として急速に進化していることを示します。各コンポーネントのインクリメントは以下のとおりです
88

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

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

1313
破壊的変更を望まない場合は、プロジェクトで `0.0.x` バージョンに固定することを推奨します。
1414

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

17-
破壊的でない変更については `Z` をインクリメントします
17+
非破壊的変更については `Z` を上げます
1818

19-
- バグ修正
20-
- 新機能
21-
- プライベートインターフェースへの変更
22-
- ベータ機能の更新
19+
- バグ修正
20+
- 新機能
21+
- プライベートインターフェースへの変更
22+
- beta 機能の更新
2323

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

26+
### 0.13.0
27+
28+
このマイナーリリースでは **破壊的変更** は導入されませんが、注目すべき Realtime のデフォルト更新、新しい MCP 機能、ランタイム安定性の修正が含まれます。
29+
30+
ハイライト:
31+
32+
- デフォルトの websocket Realtime モデルは `gpt-realtime-1.5` になり、新しい Realtime エージェントのセットアップでは追加設定なしで新しいモデルを使用します。
33+
- `MCPServer``list_resources()``list_resource_templates()``read_resource()` を公開し、`MCPServerStreamableHttp``session_id` を公開するようになったため、streamable HTTP セッションを再接続時やステートレスワーカー間で再開できます。
34+
- Chat Completions 統合は `should_replay_reasoning_content` による reasoning-content の再生を選択できるようになり、LiteLLM / DeepSeek などのアダプターでプロバイダー固有の reasoning / tool-call 継続性が向上しました。
35+
- `SQLAlchemySession` の同時初回書き込み、reasoning 削除後に assistant message ID が孤立した compaction リクエスト、`remove_all_tools()` が MCP / reasoning 項目を残してしまう問題、関数ツールのバッチエグゼキューターでの競合など、複数のランタイムおよびセッションの境界ケースを修正しました。
36+
2637
### 0.12.0
2738

28-
このマイナーリリースでは**破壊的変更** は導入されていません。主要な機能追加については [リリースノート](https://github.com/openai/openai-agents-python/releases/tag/v0.12.0) を確認してください。
39+
このマイナーリリースでは **破壊的変更** は導入されません。主要な機能追加については [リリースノート](https://github.com/openai/openai-agents-python/releases/tag/v0.12.0) を確認してください。
2940

3041
### 0.11.0
3142

32-
このマイナーリリースでは**破壊的変更** は導入されていません。主要な機能追加については [リリースノート](https://github.com/openai/openai-agents-python/releases/tag/v0.11.0) を確認してください。
43+
このマイナーリリースでは **破壊的変更** は導入されません。主要な機能追加については [リリースノート](https://github.com/openai/openai-agents-python/releases/tag/v0.11.0) を確認してください。
3344

3445
### 0.10.0
3546

36-
このマイナーリリースでは **破壊的変更** は導入されていませんが、OpenAI Responses ユーザー向けに重要な新機能領域が含まれています。具体的には Responses API の websocket トランスポートサポートです
47+
このマイナーリリースでは **破壊的変更** は導入されませんが、OpenAI Responses ユーザー向けに重要な新機能領域として、Responses API の websocket transport サポートが含まれます
3748

3849
ハイライト:
3950

40-
- OpenAI Responses モデル向けに websocket トランスポートサポートを追加しました(オプトイン。HTTP は引き続きデフォルトトランスポートです)。
41-
- マルチターン実行全体で websocket 対応プロバイダーと `RunConfig` を共有再利用するための `responses_websocket_session()` ヘルパー / `ResponsesWebSocketSession` を追加しました。
42-
- ストリーミング、ツール、承認、フォローアップターンをカバーする新しい websocket ストリーミング example`examples/basic/stream_ws.py`)を追加しました。
51+
- OpenAI Responses モデル向けに websocket transport サポートを追加しました(オプトイン。デフォルト transport は引き続き HTTP)。
52+
- 複数ターンの実行で共有の websocket 対応プロバイダーと `RunConfig` を再利用するための `responses_websocket_session()` ヘルパー / `ResponsesWebSocketSession` を追加しました。
53+
- ストリーミング、ツール、承認、フォローアップターンを扱う新しい websocket ストリーミング例`examples/basic/stream_ws.py`)を追加しました。
4354

4455
### 0.9.0
4556

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

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

5061
### 0.8.0
5162

52-
このバージョンでは、2 つのランタイム挙動変更により移行作業が必要になる可能性があります
63+
このバージョンでは、2 つのランタイム動作変更により移行作業が必要になる可能性があります
5364

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

5768
### 0.7.0
5869

59-
このバージョンでは、既存アプリケーションに影響する可能性があるいくつかの挙動変更がありました
70+
このバージョンでは、既存アプリケーションに影響しうるいくつかの動作変更があります
6071

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

6475
### 0.6.0
6576

66-
このバージョンでは、デフォルトのハンドオフ履歴は raw な user / assistant ターンを公開する代わりに、単一の assistant メッセージにまとめられるようになり、下流エージェントに簡潔で予測可能な要約を提供します
67-
- 既存の単一メッセージのハンドオフトランスクリプトは、デフォルトで `<CONVERSATION HISTORY>` ブロックの前に "For context, here is the conversation so far between the user and the previous agent:" で始まるようになり、下流エージェントが明確にラベル付けされた要約を受け取れるようになりました
77+
このバージョンでは、デフォルトのハンドオフ履歴は生のユーザー / assistant ターンを公開する代わりに、単一の assistant メッセージにまとめられるようになり、下流エージェントに簡潔で予測可能な要約を提供します
78+
- 既存の単一メッセージのハンドオフトランスクリプトは、デフォルトで `<CONVERSATION HISTORY>` ブロックの前に "For context, here is the conversation so far between the user and the previous agent:" で始まるようになり、下流エージェントが明確にラベル付けされた要約を得られます
6879

6980
### 0.5.0
7081

71-
このバージョンでは、目に見える破壊的変更は導入されていませんが、新機能と内部のいくつかの重要な更新が含まれています
82+
このバージョンでは、目に見える破壊的変更はありませんが、新機能と内部の重要な更新がいくつか含まれます
7283

73-
- `RealtimeRunner`[SIP protocol connections](https://platform.openai.com/docs/guides/realtime-sip) を処理できるサポートを追加しました
84+
- `RealtimeRunner`[SIP protocol connections](https://platform.openai.com/docs/guides/realtime-sip) を処理するサポートを追加しました
7485
- Python 3.14 互換性のために `Runner#run_sync` の内部ロジックを大幅に改訂しました
7586

7687
### 0.4.0
7788

78-
このバージョンでは、[openai](https://pypi.org/project/openai/) パッケージの v1.x はサポート対象外になりました。この SDK と併せて openai v2.x を使用してください。
89+
このバージョンでは、[openai](https://pypi.org/project/openai/) パッケージの v1.x はサポート対象外になりました。この SDK と合わせて openai v2.x を使用してください。
7990

8091
### 0.3.0
8192

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

8495
### 0.2.0
8596

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

8899
### 0.1.0
89100

90-
このバージョンでは、[`MCPServer.list_tools()`][agents.mcp.server.MCPServer]`run_context``agent` という 2 つの新しい params が追加されました。`MCPServer` をサブクラス化しているクラスには、これらの params を追加する必要があります
101+
このバージョンでは、[`MCPServer.list_tools()`][agents.mcp.server.MCPServer]2 つの新しいパラメーター `run_context``agent` が追加されました。`MCPServer` を継承するクラスには、これらのパラメーターを追加する必要があります

0 commit comments

Comments
 (0)