Google Gemini Interactions API 破壞性結構變更今日成為預設(outputs→steps),舊版 6/8 移除 L1
信心度: 高
重點: Google Gemini Interactions API 的請求/回應結構破壞性變更於 2026-05-26 起成為預設值。此變更於 5/6 公告:回應欄位由 outputs 改為 steps,輸出格式設定 response_format 一併調整;舊版(legacy)結構將於 2026-06-08 完全移除。Google 同步提供遷移指南。任何已整合 Gemini Interactions API 的應用都必須在 6/8 前更新解析與請求程式碼,否則服務將中斷。
影響: 使用 Gemini Interactions API 的開發者今天起若未指定 legacy 模式,將收到新結構回應;且必須在 6/8 前完成遷移,否則之後服務直接壞掉。這是一次需立即排程的破壞性 API 變更。
詳細分析
取捨考量
優點:
- 新結構(steps)語意更清晰,利於多步驟代理流程
- 官方提供遷移指南,路徑明確
缺點:
- 破壞性變更,未遷移者 6/8 後中斷
- 需重寫回應解析與 response_format 設定
- 遷移時間窗短(公告到移除約一個月)
快速體驗(5-15 分鐘)
- 搜尋程式碼中對 Interactions API 回應 outputs 欄位的解析
- 改為讀取 steps 並更新 response_format 設定
- 依官方遷移指南回歸測試,務必在 2026-06-08 前完成
建議
立即盤點所有使用 Gemini Interactions API 的服務並排程遷移,切勿拖到 6/8 移除日;遷移後對關鍵流程做回歸測試確認輸出結構正確。