Triển khai Google-ADK Agent lên Cloud Run

1. Giới thiệu

Bạn sẽ tạo một tác nhân có thể trả lời mọi truy vấn về tin tức và triển khai tác nhân đó trong Cloud Run. Tin tức có thể về bất kỳ chủ đề nào chỉ liên quan đến một địa điểm là "Bengaluru". Một số truy vấn có thể là:

  • Bạn có thể cho tôi biết một số tin tức mới nhất từ Bengaluru không?
  • Hãy cho tôi biết một số tin tức gần đây liên quan đến giao thông ở Bengaluru.

Bạn có thể triển khai Tác nhân trên Cloud Run. Chúng ta sẽ tạo một tác nhân đơn giản sử dụng mô hình và một công cụ cục bộ, sau đó triển khai tác nhân đó.

Kiến thức bạn sẽ học được

  • Cách thiết lập một Dự án trên Google Cloud cho Cloud Run.
  • Cách tạo một tác nhân AI đơn giản bằng Google ADK.
  • Cách xác định và sử dụng các công cụ cục bộ trong tác nhân.
  • Cách đóng gói tác nhân bằng Docker.
  • Cách triển khai tác nhân dưới dạng một dịch vụ trên Google Cloud Run.
  • Cách tương tác với tác nhân đã triển khai thông qua giao diện người dùng web.

Những điều bạn cần

  • Tài khoản Gmail
  • Trình duyệt Chrome

2. Thiết lập

  1. Đảm bảo bạn có Dự án trên Google Cloud đã thiết lập thông tin thanh toán.
  2. Sao chép kho lưu trữ trên GitHub:
git clone https://github.com/abhishekr700/Cloud-Run-Day-Workshop-2025.git
  1. Chuyển đến thư mục cho hội thảo đầu tiên:
cd Cloud-Run-Day-Workshop-2025/workshop1

3. Triển khai Tác nhân lên Cloud Run

Sau khi bạn đã chuẩn bị sẵn tất cả các tệp trong trình chỉnh sửa Cloud Shell, hãy thực thi các lệnh sau trong thiết bị đầu cuối Cloud Shell để triển khai dịch vụ lên 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"

(Xác nhận quá trình triển khai bằng cách nhập "Y" khi/nếu được nhắc.)

4. Kiểm thử Tác nhân

Sau khi triển khai thành công, Cloud Shell sẽ xuất URL cho dịch vụ Cloud Run đã triển khai.

Ảnh chụp màn hình đầu ra URL dịch vụ Cloud Run

Khi mở đường liên kết, bạn có thể tương tác trực tiếp với tác nhân bằng giao diện người dùng web ADK:

Ảnh chụp màn hình giao diện người dùng web của ADK

5. Dọn dẹp

Để tránh phát sinh các khoản phí trong tương lai, hãy xoá dịch vụ Cloud Run mà bạn đã tạo.

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

6. Xin chúc mừng!

Bạn đã tạo và triển khai thành công một Tác nhân tin tức AI lên Google Cloud Run!