1. Введение
Вы создадите агента, который сможет отвечать на любые запросы о новостях, и развернёте его в Cloud Run. Новости могут быть на любую тему, относящуюся только к одному региону — Бангалору. Вот некоторые из запросов:
- Можете ли вы рассказать мне о последних новостях из Бангалора?
- Расскажите мне о последних новостях, связанных с дорожным движением в Бангалоре.
Вы можете развернуть агенты в Cloud Run. Мы создадим простой агент, использующий модель и локальный инструмент, а затем развернем его.
Чему вы научитесь
- Как настроить проект Google Cloud для Cloud Run.
- Как создать простого ИИ-агента с помощью Google ADK.
- Как определить и использовать локальные инструменты в агенте.
- Как упаковать агент с помощью Docker.
- Как развернуть агент как службу в Google Cloud Run.
- Как взаимодействовать с развернутым агентом через веб-интерфейс.
Что вам понадобится
- Аккаунт Gmail
- Браузер Chrome
2. Настройте облачную среду Google
Получение облачных кредитов
Получите подарочный кредит, он понадобится вам для развертывания. Используйте свой аккаунт Gmail.
Создать проект
- В консоли Google Cloud на странице выбора проекта выберите или создайте проект Google Cloud.
- Убедитесь, что для вашего облачного проекта включена функция выставления счетов. Узнайте, как проверить, включена ли функция выставления счетов для проекта .
- Активируйте Cloud Shell, перейдя по этой ссылке .
- Чтобы настроить активную учетную запись, выполните следующую команду в Cloud Shell:
gcloud config set account <ACCOUNT>
Обратите внимание, что ACCOUNT — это ваш адрес электронной почты Gmail, который вы использовали для входа в Google Cloud.
- Проверьте свою аутентификацию, выполнив следующую команду в Cloud Shell:
gcloud auth list
- Подтвердите идентификатор проекта с помощью следующей команды:
gcloud config list project
- Установите переменную идентификатора проекта. Замените <YOUR_PROJECT_ID> на идентификатор из предыдущего шага:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
- Установите ключ API Google:
Сгенерируйте свой ключ API с помощью https://aistudio.google.com/app/apikey и вставьте ключ сюда:
export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
- Включите необходимые API:
gcloud services enable cloudresourcemanager.googleapis.com \
servicenetworking.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
artifactregistry.googleapis.com \
aiplatform.googleapis.com \
compute.googleapis.com \
storage.googleapis.com
(Это может занять несколько минут.)
Примеры клонированного кода для семинаров Cloud Run Day
Чтобы получить доступ к примеру кода для всех семинаров, клонируйте весь репозиторий:
git clone https://github.com/shrutimantri/first-adk-agent5.git
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.
Открыв ссылку, вы сможете напрямую взаимодействовать со своим агентом, используя веб-интерфейс ADK:
5. Уборка
Чтобы избежать будущих расходов, удалите созданную вами службу Cloud Run.
gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. Поздравляем!
Вы успешно создали и развернули новостной агент на базе ИИ в Google Cloud Run!