程式碼研究室：Cloud Run Day 2025 - Setup

1. 簡介

您將建立可回答任何新聞查詢的代理程式，並在 Cloud Run 中部署。新聞內容可與「班加羅爾」這個地點相關，主題不限。查詢範例：

  • 可以告訴我班加羅爾的最新消息嗎？
  • 請提供有關班加羅爾交通的最新消息。

您可以在 Cloud Run 部署代理程式。我們會建立使用模型和本機工具的簡單代理程式，然後部署該代理程式。

學習目標

  • 如何為 Cloud Run 設定 Google Cloud 專案。
  • 如何使用 Google ADK 建構簡單的 AI 代理。
  • 如何在代理程式中定義及使用本機工具。
  • 如何使用 Docker 封裝代理程式。
  • 如何將代理程式部署至 Google Cloud Run 做為服務。
  • 如何透過網頁 UI 與已部署的代理程式互動。

需要準備的事項

  • Gmail 帳戶
  • Chrome 瀏覽器

2. 設定 Google Cloud 環境

取得 Cloud 抵免額

請領取禮物抵免額，部署時會用到。請務必使用 Gmail 帳戶。

建立專案

  1. 在 Google Cloud 控制台的專案選取器頁面中，選取或建立 Google Cloud 專案。
  2. 確認 Cloud 專案已啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。
  3. 按一下這個連結，啟動 Cloud Shell。
  4. 如要設定有效帳戶，請在 Cloud Shell 執行下列指令：
gcloud config set account <ACCOUNT>

請注意，ACCOUNT 是您用來登入 Google Cloud 的 Gmail。

  1. 在 Cloud Shell 執行下列指令，檢查驗證狀態：
gcloud auth list
  1. 使用下列指令確認專案 ID：
gcloud config list project
  1. 設定專案 ID 變數。將 <YOUR_PROJECT_ID> 替換為上一個步驟中的 ID：
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
  1. 設定 Google API 金鑰：

使用 https://aistudio.google.com/app/apikey 產生 API 金鑰，然後將金鑰貼到這裡：

export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
  1. 啟用必要的 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 會輸出已部署 Cloud Run 服務的網址。

Cloud Run 服務網址輸出內容的螢幕截圖

開啟連結後，您可以使用 ADK 網頁版 UI 直接與代理互動：

ADK 網頁使用者介面的螢幕截圖

5. 清除

如要避免日後產生費用，請刪除您建立的 Cloud Run 服務。

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

6. 恭喜！

您已成功建構 AI 新聞代理程式，並部署至 Google Cloud Run！