Вебхуки: уведомления о готовых задачах

О чём урок

LLC. Предварительная версия: Поддержка Webhooks в Gemini API в настоящее время находится на стадии предварительного просмотра. Webhooks позволяют Gemini API отправлять уведомления в реальном времени на ваш сервер, когда завершаются асинхронные или длительные операции (LROs). Это устраняет необходимость постоянного опроса API для получения обновлений статуса, уменьшая задержку и накладные расходы. Webhooks доступны для таких операций, как задания Batch, Interactions и генерация видео. Вместо многократного опроса GET /operations для проверки завершения задания вы можете настроить Webhooks Gemini API для отправки HTTP POST запроса на ваш URL-адрес прослушивателя немедленно после срабатывания события. Gemini API поддерживает два способа настройки webhooks: Static webhooks: Эндпоинты уровня проекта. Подходят для глобальных интеграций (например, уведомления Slack, синхронизация базы данных и т. д.). Dynamic webhooks: Переопределения на уровне запроса, передающие webhook URL в конфигурационной полезной нагрузке вызова конкретного задания. Идеально подходят для маршрутизации конкретных заданий на выделенные эндпоинты. Установите SDK из PyPI. Чтобы запустить следующий cell, ваш API key должен быть сохранен в Colab Secret с именем GEMINI_API_KEY. Если у вас еще нет API key или вы не знаете, как создать Colab Secret, см. Authentication для пошагового руководства. Инициализируйте клиент с вашим API key: В этом примере используется функция Google Cloud Run, которая позволяет легко развернуть бессерверную функцию, которую вы можете использовать в качестве нашего эндпоинта webhook. Перейдите по ссылке https://console.cloud.google.com/run/ Нажмите NodeJS под "Write a function" Введите имя, например "gemini-webhook-receiver", и выберите "Allow public access" в разделе Authentication Нажмите "Deploy". Если вы развертываете функцию Cloud Run впервые, вам может потребоваться включить API, такие как Cloud Build, по запросу.

План урока

1. Как это работает
2. Установка SDK
3. Настройка вашего API key
4. Инициализация клиента SDK
5. Шаг 1: Создание эндпоинта webhook
6. Шаг 2: Создание webhook и добавление секрета в функцию Cloud Run
7. Список
8. Получить/Проверить/Удалить/Обновить