谷歌今日宣佈為 Gemini API 引入事件驅動 Webhooks,這是一種基於推送的通知系統,旨在簡化長時間執行任務的開發流程。隨著 Gemini 向智慧體工作流和高吞吐量處理方向發展——例如深度研究、長影片生成或透過 Batch API 處理數千個提示——操作可能耗時數分鐘甚至數小時。此前,開發者必須透過持續輪詢(如重複呼叫 GET 操作)來檢查任務是否完成。現在,Gemini API 可以在任務完成時立即向伺服器推送即時的 HTTP POST 負載。
該實現嚴格遵循 Standard Webhooks 規範,確保可靠性和安全性。每個請求都使用 webhook-signature、webhook-id 和 webhook-timestamp 頭進行簽名,保證冪等性並防止重放攻擊。谷歌還保證“至少一次”交付,並在 24 小時內自動重試。
開發者可以在專案級別全域性配置 Webhooks(透過 HMAC 保護),也可以按請求動態覆蓋以路由特定任務(透過 JWKS 保護)。例如,使用 Python SDK 可以為批次任務動態配置 Webhook。該功能目前對所有 Gemini API 開發者開放,谷歌提供了詳細的文件和 Cookbook 幫助快速上手。
透過採用事件驅動架構,開發者可以構建更復雜、更高效的智慧體應用。Webhooks 減少了不必要的網路流量和延遲,讓開發者能夠專注於業務邏輯而非基礎設施輪詢。無論是處理大規模資料處理、長時間推理任務,還是即時監控,這一新功能都顯著提升了開發體驗。
谷歌表示,未來將繼續擴充套件 Webhooks 的功能,包括更多事件型別和更精細的控制選項。開發者可以立即開始使用,並在官方文件中瞭解更多資訊。