使用 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 的功能，包括更多事件类型和更精细的控制选项。开发者可以立即开始使用，并在官方文档中了解更多信息。