程式碼研究室：2025 年 Cloud Run Day - 工作坊 1

1. 簡介

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

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

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

學習目標

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

需要準備的事項

  • Gmail 帳戶
  • Chrome 瀏覽器

2. 設定

  1. 按照這裡的設定說明操作
  2. 前往第一個工作坊的目錄：
cd Cloud-Run-Day-Workshop-2025/workshop1

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 網頁 UI 的螢幕截圖

5. 清除

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

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

6. 恭喜！

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