Gemini API Webhooks: Event-Driven für langlaufende Agenten

Google führt Webhooks für die Gemini API ein und eliminiert ineffizientes Polling bei langlaufenden Aufgaben.

Kurzbeschreibung

Event-Driven Webhooks informieren Entwickler automatisch über abgeschlossene Tasks ohne manuelles Polling. Die Implementation folgt dem Standard Webhooks Spec mit HMAC-Signatur und garantierte Zustellung.

Abstract

Wenn Deep Research läuft, Videos generiert oder Batch-API Tausende Prompts verarbeitet, können Operationen Minuten oder Stunden dauern. Bisher mussten Entwickler kontinuierlich GET-Requests senden, um den Status zu prüfen – ineffizient und ressourcenintensiv.

Die neue Webhook-Funktion der Gemini API implementiert Push-Notifications. Sobald ein Task abgeschlossen ist, sendet die API einen HTTP POST an den konfigurierten Endpoint. Das Framework folgt strikt der Standard Webhooks Spezifikation: Jeder Request ist signiert mit webhook-signature, webhook-id und webhook-timestamp Headern. Das garantiert Idempotenz und verhindert Replay-Attacks.

Zustellung erfolgt “at-least-once” mit automatischen Retries für bis zu 24 Stunden. Webhooks können global auf Projektebene konfiguriert werden (gesichert via HMAC) oder dynamisch pro Request (gesichert via JWKS). Die Python SDK zeigt ein einfaches Beispiel für Batch-Tasks mit Webhook-Callback. Entwickler finden Dokumentation und ein interaktives Notebook im GitHub-Repository.

Link: Google AI Blog