使用 Gemini API Webhooks 減少長時間運行任務的延遲與摩擦

谷歌今日宣佈為 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 的功能，包括更多事件類型和更精細的控制選項。開發者可以立即開始使用，並在官方文檔中瞭解更多信息。