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 控制台的项目选择器页面上，选择或创建一个 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 Web 界面直接与智能体进行交互：

ADK 网页界面的屏幕截图

5. 清理

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

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

6. 恭喜！

您已成功在 Google Cloud Run 上构建并部署了 AI 新闻智能体！