Codelab: Cloud Run Day 2025 – warsztat 1

1. Wprowadzenie

Utworzysz agenta, który będzie odpowiadać na wszelkie pytania dotyczące wiadomości, i wdrożysz go w Cloud Run. Wiadomości mogą dotyczyć dowolnego tematu związanego tylko z jedną lokalizacją, czyli „Bengaluru”. Przykładowe zapytania:

  • Czy możesz podać mi najnowsze wiadomości z Bengaluru?
  • Podaj najnowsze wiadomości dotyczące ruchu w Bengaluru.

Agenty możesz wdrażać w Cloud Run. Utworzymy prostego agenta, który korzysta z modelu i lokalnego narzędzia, a następnie go wdrożymy.

Czego się nauczysz

  • Jak skonfigurować projekt Google Cloud na potrzeby Cloud Run.
  • Jak utworzyć prostego agenta AI za pomocą platformy Google ADK.
  • Definiowanie i używanie narzędzi lokalnych w agencie.
  • Jak spakować agenta za pomocą Dockera.
  • Jak wdrożyć agenta jako usługę w Google Cloud Run.
  • Jak wchodzić w interakcję z wdrożonym agentem za pomocą interfejsu internetowego.

Co będzie potrzebne

  • konto Gmail,
  • Przeglądarka Chrome

2. Konfiguracja

  1. Postępuj zgodnie z instrukcjami konfiguracji, które znajdziesz tutaj.
  2. Przejdź do katalogu pierwszych warsztatów:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Wdrażanie agenta w Cloud Run

Gdy wszystkie pliki będą gotowe w edytorze Cloud Shell, wykonaj w terminalu Cloud Shell te polecenia, aby wdrożyć usługę w 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"

(Potwierdź wdrożenie, wpisując „Y”, gdy pojawi się odpowiedni komunikat).

4. Testowanie agenta

Po pomyślnym wdrożeniu Cloud Shell wyświetli adres URL wdrożonej usługi Cloud Run.

Zrzut ekranu z wynikiem adresu URL usługi Cloud Run

Po otwarciu linku możesz bezpośrednio korzystać z agenta za pomocą interfejsu ADK w przeglądarce:

Zrzut ekranu interfejsu ADK Web

5. Czyszczenie

Aby uniknąć naliczania opłat w przyszłości, usuń utworzoną usługę Cloud Run.

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

6. Gratulacje!

Udało Ci się utworzyć i wdrożyć agenta AI News w Google Cloud Run.