Gemini APIのDeep Researchを、旧エージェントの deep-research-pro-preview-12-2025 のまま使っている開発者向けの記事だ。Googleの変更履歴(2026年10月8日付)には、この旧エージェントは非推奨で、2026年10月23日に停止すると記載されている。変更履歴と廃止のページの本文は、当編集部として確認できていない。以下は、その記載として伝えられている範囲だ。やることは単純で、コードと設定ファイルから旧エージェントの名前を探し、用途に合わせて移行先を選び、agent の値を差し替えて動作を確かめる。同じ2026年10月23日には、OpenAIのAPIでも旧モデルが止まる。そちらは2026年10月18日の深掘り記事(OpenAIのAPIで2026年10月23日に止まる旧モデルと移行の手順を伝えた記事)で整理した。
何が止まるのか
変更履歴の記載によると、止まるのは Deep Research の旧エージェント deep-research-pro-preview-12-2025 だ。移行は、interactions.create のリクエストの agent パラメータを、この名前から新しいエージェントの名前に差し替える形で行う。変更履歴が示す移行の手順は、この名前の差し替えだ。ほかの引数やレスポンスの形が変わるかどうかは、当編集部として確認できていない。
ここで迷いやすいのが、移行先が1つではないことだ。次の節で、2つの違いを見ておく。
移行先は2つ
変更履歴は、移行先として次の2つのエージェントを挙げている。
| 移行先のエージェント | 向いている用途 |
|---|---|
| deep-research-preview-04-2026 | 速度と、クライアントの画面へのストリーミング |
| deep-research-max-preview-04-2026 | 網羅性を最大にしたいとき |
つまり、速度とクライアントの画面へのストリーミングを重んじるなら前者、網羅性を最大にしたいなら後者、という使い分けだ。
エージェントの名前の綴りは、Googleの変更履歴の記載に従っている。ただし、原文との一字一句の照合は、当編集部として済んでいない。使う前に、Googleのページで確かめてほしい。
手順1 — コードと設定ファイルから旧エージェントの名前を探す
まずは、プロジェクトの中に旧エージェントの名前が残っていないかを探す。コードの中だけでなく、設定ファイルや環境ごとの設定に書いてある場合もあるので、プロジェクト全体を対象にするとよい。
grep -rn "deep-research-pro" .
deep-research-pro まで入れて検索すると、末尾の綴りが違う書き方も一緒に拾える。ヒットしたら、どのファイルの何行目かを控えておく。
手順2 — 用途に合わせて移行先を選ぶ
ヒットした箇所ごとに、上の表を見て移行先を決める。同じプロジェクトの中でも、画面に流す処理は deep-research-preview-04-2026、網羅性を最大にしたい処理は deep-research-max-preview-04-2026、というように箇所ごとに分けて選んでもよい。
手順3 — agent の値を差し替えて動作を確かめる
選んだら、agent の値だけを差し替える。変更の前後は次のようになる。
変更前 agent: deep-research-pro-preview-12-2025
変更後 agent: deep-research-preview-04-2026
(または deep-research-max-preview-04-2026)
interactions.create のほかの引数や、レスポンスの形は、当編集部として確認できていない。差し替えたあとは、開発用の環境で1回呼び出して、呼び出しが通ることを確かめておく。停止のあとに旧エージェントを呼んだ場合にどうなるか(エラーの種類など)も、確認できていない。だから、停止の前に差し替えて確かめておくのが、いちばん安全だ。
手順4 — 廃止のページと変更履歴を見直す
最後に、Googleの廃止のページと変更履歴を、もう一度見ておく。2つのページは、同じ項目の書き方が少し違う。廃止のページは、記載の日付は最も早くて提供を終えうる日で、正確な日付は事前に通知するとページ全体に注記している。変更履歴は2026年10月23日に停止すると書いている。廃止のページにも同じ2026年10月23日が載っている。ただ、ページ全体の注記が、この項目にも個別にかかっているかは、確認できていない。
要するに、ページによって書き方が違う。どちらで読んでも、2026年10月23日より前に差し替えておけば、どちらの書き方にも間に合う。Googleからの事前の通知があった場合は、その日付を優先したい。同じ時期のGoogleの期限としては、Gemini 2.5の提供終了もあり、日付の食い違いを2026年10月8日のAIニュース記事(Gemini 2.5の提供終了日の食い違いを伝えた記事)で伝えた。
まとめ
- Googleの変更履歴(2026年10月8日付)に、Deep Research の旧エージェント deep-research-pro-preview-12-2025 は非推奨で、2026年10月23日に停止すると記載されている。変更履歴と廃止のページの本文は、当編集部として確認できていない
- 移行は、interactions.create のリクエストの agent パラメータを、新しいエージェントの名前に差し替える。移行先は deep-research-preview-04-2026(速度と、クライアントの画面へのストリーミング向け)と、deep-research-max-preview-04-2026(網羅性を最大にする向け)の2つ
- 手順は、(1) コードと設定ファイルから旧エージェントの名前を検索する、(2) 用途に合わせて移行先を選ぶ、(3) agent の値を差し替えて動作を確かめる、(4) 廃止のページと変更履歴を見直す、の流れ
- 変更履歴は2026年10月23日に停止すると書いている。廃止のページにも同じ2026年10月23日が載っているが、記載の日付は最も早くて提供を終えうる日で正確な日付は事前に通知するというページ全体の注記が、この項目にも個別にかかっているかは、確認できていない
- 停止のあとに旧エージェントを呼んだ場合の挙動は、確認できていない。エージェントの名前の綴りは、原文との一字一句の照合が済んでいないので、使う前にGoogleのページで確かめたい