Codelab: Cloud Run Day 2025 - Workshop 1

1. Pengantar

Anda akan membuat agen yang dapat menjawab kueri apa pun tentang berita dan men-deploy-nya di Cloud Run. Berita tersebut dapat membahas topik apa pun yang hanya berkaitan dengan satu lokasi, yaitu 'Bengaluru'. Beberapa kuerinya dapat berupa:

  • Bisakah Anda memberi tahu saya beberapa berita terbaru dari Bengaluru?
  • Berikan saya beberapa berita terbaru terkait lalu lintas Bengaluru.

Anda dapat men-deploy Agen di Cloud Run. Kita akan membuat agen sederhana yang menggunakan model dan alat lokal, lalu men-deploy-nya.

Yang akan Anda pelajari

  • Cara menyiapkan Project Google Cloud untuk Cloud Run.
  • Cara membuat agen AI sederhana menggunakan ADK Google.
  • Cara menentukan dan menggunakan alat lokal dalam agen.
  • Cara mengemas agen menggunakan Docker.
  • Cara men-deploy agen sebagai layanan di Google Cloud Run.
  • Cara berinteraksi dengan agen yang di-deploy melalui UI web.

Yang Anda butuhkan

  • Akun Gmail
  • Browser Chrome

2. Penyiapan

  1. Selesaikan semua petunjuk penyiapan di sini
  2. Buka direktori untuk workshop ke-1:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Men-deploy Agen ke Cloud Run

Setelah semua file siap di editor Cloud Shell, jalankan perintah berikut di terminal Cloud Shell untuk men-deploy layanan ke 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"

(Konfirmasi deployment dengan mengetik 'Y' saat/jika diminta.)

4. Menguji Agen

Setelah deployment berhasil, Cloud Shell akan menampilkan URL untuk layanan Cloud Run yang di-deploy.

Screenshot output URL layanan Cloud Run

Saat membuka link, Anda dapat berinteraksi langsung dengan agen menggunakan UI web ADK:

Screenshot UI Web ADK

5. Pembersihan

Untuk menghindari biaya pada masa mendatang, hapus layanan Cloud Run yang telah Anda buat.

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

6. Selamat!

Anda telah berhasil membangun dan men-deploy Agen Berita AI ke Google Cloud Run.