·6 分鐘閱讀
Gemini 2.5 遷移,先別只改模型名稱

應用還能正常回覆,不代表模型遷移已經準備好。對接了工具、記憶和多輪對話的 Agent,換模型時最容易漏掉的,往往不是模型名稱,而是藏在共用設定與對話歷史裡的假設。
Google 在 2026 年 11 月 2 日的公告中說明,Gemini 2.5 Pro 與 Flash 將於 12 月 1 日開始自動路由至指定的新模型。對維護既有應用的團隊而言,這段時間適合用來主動驗證遷移,避免等到流量切換後才發現格式或行為差異。時程以 Gemini 官方更新紀錄為準。
先確認用的是哪個模型
官方列出的路徑並不相同:gemini-2.5-pro 對應 gemini-3.8-flash;gemini-2.5-flash 對應 gemini-3.5-flash-lite。名稱相近的 gemini-2.5-flash-lite 不在這次相同的棄用安排中。相關範圍與存取條件,請對照官方棄用說明。
先從正式環境設定、佇列工作、備援路由及測試腳本找出實際模型 ID。不要只搜尋前端選單顯示的名稱;如果應用透過統一閘道,還要核對別名最後對應到哪個上游模型。這一步的產出應是一份「哪個功能使用哪個模型」的清單,讓後續測試能對上真實流量。
自動路由也不等於行為完全相容。官方提供的是請求去向安排;你的提示詞、解析器和工具流程,仍要由應用端驗證。若是經由第三方平台呼叫,也應另外確認平台的支援範圍與計費規則,不直接套用上游的假設。
把請求設定當成遷移的一部分
先檢查共用的 generation 設定,再看各功能自行附加的欄位。這些設定很容易在封裝層被自動帶入,單看業務程式可能看不出來。
目前的官方遷移文件要求處理舊採樣參數、預填的 model 回合,以及思考設定的變更。以 Gemini 3.8 Flash 為例,應將 thinking_budget 的設定方式改為 thinking_level,並依支援值選擇,不能直接沿用舊數字。具體規則見 3.8 Flash 遷移清單與參數變更說明。
實務上可以保留一份經過遮罩的請求樣本,逐欄比對送到上游的實際 payload。若介面報參數錯誤,先找出是哪一層加上的欄位,再修正那一層。只在提示詞裡要求「照舊回覆」,無法解決請求結構不相容。
讓測試走完一次工具往返
純文字問答通過後,至少再選一個會真的使用工具的流程,例如查詢庫存、讀取訂單或搜尋文件。驗證範圍要包含模型提出工具呼叫、應用執行工具、回傳結果,以及模型根據結果完成回答。只有第一個回合成功,還不能證明 Agent 可用。
工具結果應能對回原始呼叫,對話狀態也要完整保留。官方在 3.8 遷移清單中另列工具呼叫與思考簽章的檢查;不同 API 的欄位要求要分開處理,不能把 Interactions 的做法直接搬到 generateContent。
建議保留三種測試:一次成功的工具往返、工具回傳空結果,以及工具執行失敗。觀察應用是否能結束任務、交代限制,或進入有上限的重試。測試時使用沙盒工具或唯讀資料,避免驗證過程真的建立訂單或觸發付款。
以任務結果評估,不只看一個 HTTP 200
建立一組來自真實使用情境的測試案例,固定輸入與驗收條件,再比較遷移前後的結果。結構化輸出看欄位與型別是否符合要求;文件摘要看關鍵資訊是否遺漏;工具任務看是否調用了正確工具並完成收尾。若只用「請介紹自己」做驗證,通常找不到業務流程裡的問題。
同時記錄任務成功率、完成時間、工具呼叫次數、重試次數及 token 用量。某個請求回覆更快,整個任務卻需要更多輪才能完成,使用者體驗未必變好。費用也應以「完成一次任務的總成本」評估,並按實際供應商當時的價格計算;本文沒有提供模型效能或成本的實測結論。
上線之前,先定義什麼情況必須停下來
先讓內部測試或少量可控流量使用新設定,再逐步擴大。遷移窗口內若舊路徑仍可用,可以把它作為暫時回復選項,但不要把舊模型永久可用當成前提。切換前應確認替代路徑確實可用,而不是只在設定檔裡寫了一個備援名稱。
建議事先訂出停止擴量的條件,例如結構化輸出失敗率高於團隊門檻、工具流程無法收尾,或延遲與單次任務成本超出預算。保留輸入類型與錯誤類別,方便分辨是模型差異、參數問題,還是應用解析器的限制。
這些是應用端的遷移建議,不是 Google 對所有工作負載的效能保證。是否切換,應由你的驗收案例與服務目標決定。
常見問題
12 月 1 日之前,什麼都不用做嗎?
不建議把自動路由當成完整遷移方案。應趁窗口期主動驗證新模型設定和關鍵流程,並在切換前確認官方公告是否有更新。若應用有第三方閘道,也要另外查驗其安排。
新的模型名稱不同,代表功能可以直接對等替換嗎?
不能只憑名稱判斷。先按官方對應關係建立測試路徑,再用自己的案例檢查輸出品質、工具流程和執行成本;不符合需求時,再評估其他受支援模型。
遷移完成的最低驗收條件是什麼?
關鍵功能在新路徑上能完整執行,輸出可被應用正確處理,失敗時有可控的處置方式,而且延遲和費用符合團隊設定的門檻。這比「模型有回話」更接近可上線的標準。
來源與核驗範圍
本文於 2026 年 11 月 3 日核對官方更新紀錄、棄用說明及兩份遷移文件。日期、模型對應與 API 變動來自所列官方文件;盤點、測試與分批切換方法為編輯整理的工程建議。未連線呼叫模型 API,亦未進行效能、費用或第三方平台相容性實測。