Codelab: Cloud Run Day 2025 — Семинар 1

1. Введение

Вы создадите агента, который сможет отвечать на любые запросы о новостях, и развернёте его в Cloud Run. Новости могут быть на любую тему, относящуюся только к одному региону — Бангалору. Вот некоторые из запросов:

  • Можете ли вы рассказать мне о последних новостях из Бангалора?
  • Расскажите мне о последних новостях, связанных с дорожным движением в Бангалоре.

Вы можете развернуть агенты в Cloud Run. Мы создадим простой агент, использующий модель и локальный инструмент, а затем развернем его.

Чему вы научитесь

  • Как настроить проект Google Cloud для Cloud Run.
  • Как создать простого ИИ-агента с помощью Google ADK.
  • Как определить и использовать локальные инструменты в агенте.
  • Как упаковать агент с помощью Docker.
  • Как развернуть агент как службу в Google Cloud Run.
  • Как взаимодействовать с развернутым агентом через веб-интерфейс.

Что вам понадобится

  • Аккаунт Gmail
  • Браузер Chrome

2. Настройка

  1. Выполните все инструкции по настройке здесь.
  2. Перейдите в каталог 1-го семинара:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Развертывание агента в Cloud Run

Подготовив все файлы в редакторе Cloud Shell, выполните следующие команды в терминале Cloud Shell, чтобы развернуть службу в Cloud Run:

gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"

(Подтвердите развертывание, введя «Y» при появлении соответствующего запроса.)

4. Протестируйте агента

После успешного развертывания Cloud Shell выведет URL-адрес развернутой службы Cloud Run.

Скриншот вывода URL-адреса сервиса Cloud Run

Открыв ссылку, вы сможете напрямую взаимодействовать со своим агентом, используя веб-интерфейс ADK:

Скриншот веб-интерфейса ADK

5. Уборка

Чтобы избежать будущих расходов, удалите созданную вами службу Cloud Run.

gcloud run services delete news-assistant-agent --$REGION $GOOGLE_CLOUD_LOCATION  --quiet

6. Поздравляем!

Вы успешно создали и развернули новостной агент на базе ИИ в Google Cloud Run!