通过 Gemini API 中的 Webhook 减少长时间运行任务的摩擦和延迟

# 利用 Gemini API 中的 Webhooks 降低长时间运行任务的摩擦与延迟 来源：https://blog.google/innovation-and-ai/technology/developers-tools/event-driven-webhooks/ 我们正在让构建复杂、长时间运行的智能体（Agent）应用程序变得更加简便和高效，这得益于 Gemini API Webhooks 的支持。 Hussein Hassan Harrirou 工程团队，Gemini API Gemini API 您的浏览器不支持音频元素。 收听文章 本内容生成自 Google AI。生成式 AI 属于实验性功能。 [[duration]] 分钟 今天，我们宣布让构建复杂、长时间运行的智能体应用变得更加简便和高效。我们引入了基于事件的 Webhooks——一种基于推送的通知系统，从而消除了低效轮询的需求。 随着 Gemini 转向智能体工作流和高吞吐量处理——例如深度研究（Deep Research）、长视频生成或通过批量 API（Batch API）处理数千个提示——操作可能需要几分钟甚至几小时。在此之前，开发者必须依赖持续轮询（例如，重复调用 `GET` 操作）来检查任务是否完成。 现在，一旦任务完成，Gemini API 即可实时向您的服务器推送 HTTP POST 有效负载。 我们在设计时充分考虑了可靠性与安全性。我们的实现严格遵循 [标准 Webhooks](https://github.com/standard-webhooks/standard-webhooks) 规范。每个请求均使用 `webhook-signature`、`webhook-id` 和 `webhook-timestamp` 标头进行签名，以确保幂等性并防止重放攻击。我们还通过长达 24 小时的自动重试机制，保证“至少一次”交付。 ## 工作原理 您可以在项目级别全局配置 Webhooks（通过 HMAC 保护），也可以针对每个请求动态覆盖它们，以路由特定任务（通过 JWKS 保护）。 以下是一个使用 Python SDK 为批量任务动态配置 Webhook 的快速示例： ## 即刻开始 此功能现已面向所有使用 Gemini API 的开发者开放： - **阅读指南：** 查看 [Webhooks 文档](https://ai.google.dev/gemini-api/docs/webhooks)，探索完整的事件目录，并了解如何保护您的端点。 - **动手实践：** 我们准备了一份全面的 [Cookbook](https://github.com/google-gemini/cookbook/blob/main/quickstarts/Webhooks.ipynb)，帮助您构建端到端的 Webhook 集成。