OpenAI Agents SDK v0.24.0-alpha.7は、alpha.6から移行するときに確認する項目が5つあるプレビュー版です。
確認するのは、書き込み方針の既定値、推論の強さの既定値、MCPの承認モード名、子エージェント用コールバックの引数、MCPの要求の型です。
2026年11月9日にGitHubのリリースノート(Agents SDK v0.24.0-alpha.7)を開いて確認した文面だけを根拠に、何を直すかを整理します。
alpha.7を使っていない人や、安定版だけを使っている人にとっての意味も、最後に分けて書きます。
この記事の読者向け・無料
ChatGPT・Gemini・Claude 仕事別の使い分け実践キット

中身
- ChatGPT・Gemini・Claude を仕事別に選ぶ表
- 目的→機能→入力の許可→比較の順番
- 有料プランを考える前の確認
- 下のボタンから LINE を友だち追加
- トークで「AIの使い分け」と送る
- ChatGPT・Gemini・Claude 仕事別の使い分け実践キットが自動で届きます
友だち追加は無料です。届いた後はいつでもブロックできます。
LINEで「AIの使い分け」を受け取るこの記事でわかること
- OpenAI Agents SDK alpha.7とは何か、安定版との違い
- alpha.6から移行するときに確認する5項目と、直す場所
- 書き込み方針 write_policy と推論の強さの既定値が変わる点
- 承認モード名 auto・approve の置き換え先
- alpha版を今使うべきかを決める手順
OpenAI Agents SDK alpha.7とは何か
OpenAI Agents SDK alpha.7とは、OpenAIがGitHubで公開しているAgents SDK(Python)の、バージョン0.24.0向けプレビュー版の7番目のリリースです。
リリースノートの題名は「Agents SDK v0.24.0-alpha.7」で、alpha.6からの移行手順が「Upgrading from 0.24.0-alpha.6」の節にまとまっています。
GitHubのリリース一覧では、alpha.7は2026年11月8日に公開され、プレリリース(prerelease)として扱われています。
安定版のv0.24.0は2026年10月15日に公開された別のリリースです。
v0.24.0のリリースノートの機能欄には「MCPのannotationsを変換後のツールに出す」「実行全体でのツール例外の整形に対応する」の2件が載っていて、今回の5項目は見当たりません。出典は v0.24.0のリリースノート です。
プレビュー版の配布方法は、alpha.6のリリースノートに「GitHub Releasesで配布していて、PyPIではない」と書かれています。出典は alpha.6のリリースノート です。
alpha.7で確認する5項目を一覧で見る

確認する5項目とは、リリースノートの「Upgrading from 0.24.0-alpha.6」に並ぶ5つの移行項目のことです。表の「公式の記載」列は、リリースノートの内容を日本語にしたものです。
| 項目 | 公式の記載(alpha.7のリリースノート) | 自分のコードで探す言葉 |
|---|---|---|
| 1. 書き込み方針 | 新しいEnvironmentの既定が write_policy=”strict” になる。以前のリモート方針を保つには “legacy” を指定する | Environment、write_policy |
| 2. 推論の強さ | 同梱のモデル一覧が持つ既定が、gpt-6-astra・gpt-6.1-sol・gpt-5.6-sol で low から medium に変わる | reasoning_effort、model_settings |
| 3. 承認モード名 | approval_mode=”auto” は “native”、”approve” は “preapproved” に置き換える。旧い値は拒否される | approval_mode |
| 4. 子ステップのコールバック | NativeAgents.before_step が、1つの ChildStepContext を受け取る形に変わる。ルートの before_step は従来のまま | NativeAgents、before_step |
| 5. MCPの要求の型 | ElicitationRequest が FormRequest と UrlRequest の和集合(union)になる | ElicitationRequest |
出典は alpha.7のリリースノート の「Upgrading from 0.24.0-alpha.6」です。
この5項目はalpha.6からの変更として書かれているため、alpha.5以前から上げる場合は、間のリリースノートも順に読む必要があります。
alpha.6のリリースノートには、alpha.5からの変更として別の「API changes」(Runnerの別名の削除、Turn.wait() の置き換えなど)が載っています。
書き込み方針 write_policy の既定値が変わる
write_policy とは、Environment(コードを動かす実行環境)が、どこまで書き込みを許すかを決める設定です。alpha.7では、新しく作るEnvironmentの既定が “strict” になります。
リリースノートによると、strict は対応するLinuxまたはmacOSの実行環境(executor)を必要とします。
作業ディレクトリには引き続き書き込めて、ほかのディレクトリに書き込ませたいときは writable_roots で指定します。
以前のリモート方針を保つには、write_policy=”legacy” を指定し、writable_roots は None のままにします。
Windowsの実行環境でもこの指定を使うと書かれています。
ローカル実行(Environment.local())は strict モードが必要です。
ここまでの出典は、表と同じalpha.7のリリースノートです。
旧い方針で保存したデータを復元するとき
リリースノートには、旧い方針で保存したチェックポイントやプロファイルを復元するときの注意もあります。
復元時は legacy を明示して選ぶ必要があり、開き直しただけでは方針は strict に上がりません。
strict が具体的に何を禁じるのかは、リリースノート本文だけでは分かりません。
既存のEnvironmentを開く前の確認手順
- 使っている実行環境が、Linux・macOS・Windowsのどれかを確認する
- Windowsの実行環境なら、write_policy=”legacy” を明示する
- 作業ディレクトリ以外へ書き込む処理があれば、writable_roots に書き出す先を足す
- 旧い方針で保存したチェックポイントを復元するなら、legacy を明示して開く
リリースノートは「既存のEnvironmentを開く前に、移行の手順を確認すること」を求めています。
推論の強さ reasoning_effort の既定値が low から medium になる
reasoning_effort とは、モデルがどれだけ考えてから答えるかを指定する設定で、SDKでは model_settings の中で指定します。alpha.7では、同梱のモデル一覧が持つ既定値が3つのモデルで low から medium に変わります。
対象のモデルIDは gpt-6-astra、gpt-6.1-sol、gpt-5.6-sol です。
以前の強さを保ちたいときは、model_settings={“reasoning_effort”: “low”} を明示します。
リリースノートは、これが同梱のメタデータ(モデル一覧)の説明であることも断っています。
明示した設定や、プロバイダー側のモデル情報が別の値を選ぶこともあります。出典は alpha.7のリリースノート です。
この変更は、SDKが持つ既定値の話です。APIで各モデルがどの強さを選べるかは、各モデルの公式ページが正本になります。
モデルごとの違いは、GPT-6.1 Solの記事やGPT-5.6 Solの記事で扱っています。
仮の例:応答時間を一定にしたい場合
次の表は、仮の例です。リリースノートの内容を、設定を書く場所に当てはめて示しています。
| 状況(仮の例) | alpha.7での扱い |
|---|---|
| gpt-6.1-sol を使い、reasoning_effort をコードで指定していない | 同梱の既定が medium になり、以前の low とは違う強さで動く場合がある |
| 応答の速さを以前に合わせたい | model_settings={“reasoning_effort”: “low”} を明示する |
| すでに reasoning_effort を明示している | 明示した設定が優先されるため、この項目の作業は要らない |
実践用の「ChatGPT・Gemini・Claude 仕事別の使い分け実践キット」を無料で配布しています。LINE で「AIの使い分け」と送ると届きます。LINEで受け取る
MCPの承認モード名 auto と approve を置き換える
approval_mode とは、MCP(外部ツールをつなぐ仕組み)のツール呼び出しを、人が承認してから実行するか、あらかじめ許可しておくかを決める設定です。alpha.7では、その値の名前が2つ変わります。
置き換えは、”auto” が “native”、”approve” が “preapproved” の2つです。
リリースノートは、旧い値は拒否され、新しい名前はそれぞれの承認の動きを保つと書いています。
- approval_mode=”auto” は approval_mode=”native” に置き換える(旧い値は拒否される)
- approval_mode=”approve” は approval_mode=”preapproved” に置き換える(旧い値は拒否される)
この approval_mode は、Agents SDKの設定名です。
Codex CLIの承認モードとは別のものなので、混同しないでください。
Codex CLI側の考え方は、Codex CLIの承認モードとサンドボックスの記事で扱っています。
コードを検索して直す手順
- プロジェクト全体で approval_mode を検索する
- 値が “auto” なら “native” に、”approve” なら “preapproved” に書き換える
- 書き換えたあと、承認を求める場面と求めない場面の両方で動作を確かめる
リリースノートは、新しい名前が旧い名前の承認の動きを保つと説明しています。
それでも、自分の環境での動きは実行して確かめるのが確実です。
コールバックとMCP要求の型を直す
残りの2項目は、コードの型や引数に関わる変更です。子エージェントの手順ごとに呼ばれる before_step と、MCPが利用者に入力を求める ElicitationRequest が対象です。
NativeAgents.before_step は、これまで子と手順番号を別々の引数で受け取っていました。
alpha.7からは、context・child・step_index を持つ1つの ChildStepContext を受け取ります。
ルート側の before_step は、従来の引数のままです。
ElicitationRequest は、FormRequest と UrlRequest のどちらかを表す型になりました。
フォームの入力には FormRequest.reply() または respond() を使います。
URLへの同意には、UrlRequest.reply_url_accept() または accept_url メソッドを使います。
alpha版を今使うべきかを決める手順

alpha版を使うかどうかは、安定版で足りるかと、移行の作業を引き受けられるかで決まります。リリースノートに書かれた事実から、判断の順番を整理します。
- 今使っているのが安定版かalphaかを確認する(pip で入れた版が 0.24.0a の形ならalpha)
- 安定版で足りているなら、alpha.7の5項目を急いで直す必要はない
- alphaを使っているなら、alpha.6のリリースノートの「API changes」も含めて、使っている版から順に読む
- 5項目の検索語(write_policy、reasoning_effort、approval_mode、before_step、ElicitationRequest)で、自分のコードを探す
- 見つかった箇所を直してから、小さな実行で動きを確かめる
手順1の「0.24.0a」という表記は、alpha.6のリリースノートに「0.24.0-alpha.6 または同等のPythonパッケージ表記 0.24.0a6」と書かれていることに基づきます。出典は alpha.6のリリースノート です。
alpha.7のリリースノートには、ほかにも新機能(独自のセッション保存、音声、ホスト型ツールなど)が書かれています。この記事では、移行で直す必要のある5項目に絞りました。
よくある質問(FAQ)
- Q1. alpha.7は安定版ですか。
- いいえ。GitHubではプレリリースとして公開されています。安定版は、2026年10月15日公開のv0.24.0です。出典は v0.24.0のリリースノート です。
- Q2. approval_mode に旧い値を残すとどうなりますか。
- リリースノートでは、旧い値の “auto” と “approve” は拒否されると書かれています。”native” と “preapproved” に置き換えてください。
- Q3. 推論の強さを以前の low のままにするにはどうしますか。
- model_settings={“reasoning_effort”: “low”} を明示します。リリースノートが示している方法です。
- Q4. Windowsの実行環境ではwrite_policyをどうしますか。
- strict は対応するLinuxまたはmacOSの実行環境を必要とします。Windowsの実行環境でも以前のリモート方針を保つには、write_policy=”legacy” を指定し、writable_roots は None のままにします。
- Q5. 保存したCodexのログインをSDKで使えますか。
- alpha.7のリリースノートには、NativeProvider(auth=CodexLogin()) で保存済みのCodexログインをHTTP経由で使える「実験的な機能」が載っています。この機能は変更または削除される可能性があると明記されています。
- Q6. ホスト型ツールはどんな条件で使えますか。
- リリースノートによると、FileSearch・CodeInterpreter・ImageGeneration のホスト型ツールは、APIキーのプロバイダーと、対応する標準のResponsesモデルが必要です。Responses LiteとCodexログインでは使えません。Responses APIの基本は、Responses APIとChat Completionsの違いの記事で扱っています。
読み終わったら、手元に残す
ChatGPT・Gemini・Claude 仕事別の使い分け実践キット
中身
- ChatGPT・Gemini・Claude を仕事別に選ぶ表
- 目的→機能→入力の許可→比較の順番
- 有料プランを考える前の確認
LINE を友だち追加して「AIの使い分け」と送ると、無料で届きます。
LINEで「AIの使い分け」を受け取るまとめ
alpha.7でalpha.6から移るときの確認は5項目です。
対象は write_policy、reasoning_effort、approval_mode、before_step、ElicitationRequest です。
書き込み方針と推論の強さは、既定値が変わるため、何も書いていないコードの動きが変わる場合があります。
承認モード名は、旧い値が拒否されるため、そのままでは動きません。
安定版のv0.24.0を使っているなら、この5項目をすぐ直す必要はありません。
alphaを使っているなら、検索語で自分のコードを探し、小さな実行で確かめてから進めてください。
この記事の内容は2026年11月9日時点で確認したリリースノートに基づきます。
alphaは変更が早いため、使う前に最新のリリース一覧を開いて確かめてください。
読み終えたら、次はSNS運用に使ってみる
この記事のAIの使い方を、Instagramでの発信や運用に活かしたい方へ。インスタ大学の一般教材の受け取り方を、公式LINEで案内しています。
LINEでインスタ大学の受取案内を見るあわせて読みたい・姉妹メディア

