Codelab：Cloud Run Day 2025 - 设置

1. 简介

您将创建一个可以回答任何新闻查询的代理，并将其部署在 Cloud Run 中。新闻可以涉及与“班加罗尔”这一个地点相关的任何主题。部分查询可能如下所示：

  • 您能告诉我班加罗尔的一些最新资讯吗？
  • 给我播报一些与班加罗尔交通相关的最新新闻。

您可以在 Cloud Run 上部署代理。我们将创建一个使用模型和本地工具的简单代理，然后部署该代理。

学习内容

  • 如何为 Cloud Run 设置 Google Cloud 项目。
  • 如何使用 Google ADK 构建简单的 AI 代理。
  • 如何在智能体中定义和使用本地工具。
  • 如何使用 Docker 打包代理。
  • 如何在 Google Cloud Run 上将代理部署为服务。
  • 如何通过 Web 界面与已部署的代理互动。

所需条件

  • Gmail 账号
  • Chrome 浏览器

2. 设置 Google Cloud 环境

获取 Cloud 赠金

领取礼品卡赠金后，您需要在部署时使用该赠金。请务必使用您的 Gmail 账号。

创建项目

  1. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 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 网页界面直接与代理互动：

ADK 网页界面的屏幕截图

5. 清理

为避免日后产生费用，请删除您创建的 Cloud Run 服务。

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

6. 恭喜！

您已成功构建 AI 新闻代理并将其部署到 Google Cloud Run！