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. Menyiapkan Lingkungan Google Cloud
Mendapatkan Kredit Cloud
Klaim kredit hadiah Anda, Anda akan memerlukannya untuk deployment. Pastikan untuk menggunakan akun Gmail Anda.
Membuat project
- Di Konsol Google Cloud, di halaman pemilih project, pilih atau buat project Google Cloud.
- Pastikan penagihan diaktifkan untuk project Cloud Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.
- Aktifkan Cloud Shell dengan mengklik link ini.
- Untuk menetapkan akun aktif, jalankan perintah berikut di Cloud Shell:
gcloud config set account <ACCOUNT>
Perhatikan bahwa ACCOUNT adalah Gmail Anda yang Anda gunakan untuk login ke Google Cloud.
- Periksa autentikasi Anda dengan menjalankan perintah berikut di Cloud Shell:
gcloud auth list
- Konfirmasi project ID menggunakan perintah berikut:
gcloud config list project
- Tetapkan variabel project ID. Ganti <YOUR_PROJECT_ID> dengan ID dari langkah sebelumnya:
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
- Setel kunci Google API:
Buat kunci API Anda menggunakan https://aistudio.google.com/app/apikey dan tempelkan kunci di sini:
export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
- Aktifkan API yang diperlukan:
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
(Proses ini mungkin memerlukan waktu beberapa menit.)
Meng-clone Contoh Kode untuk Workshop Hari Cloud Run
Untuk mengakses kode contoh semua workshop, clone seluruh repositori:
git clone https://github.com/shrutimantri/first-adk-agent5.git
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.
Saat membuka link, Anda dapat berinteraksi langsung dengan agen menggunakan 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 $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. Selamat!
Anda telah berhasil membangun dan men-deploy Agen Berita AI ke Google Cloud Run.