Codelab：Cloud Run Day 2025 - 工作坊 1

1. 简介

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

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

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

学习内容

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

所需条件

  • 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 网页界面直接与代理互动：

ADK Web 界面屏幕截图

5. 清理

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

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

6. 恭喜！

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