使用智能体开发套件在 Agent Runtime 上开发和部署智能体

使用智能体开发套件在 Agent Runtime 上开发和部署智能体

借助 Agent Runtime，您可以托管使用智能体开发套件 (ADK) 开发的智能体。本文档介绍了如何使用 ADK 创建、部署和测试智能体。

本快速入门将引导您完成以下步骤：

• 设置 Google Cloud 项目。
• 安装 Agent Platform SDK for Python 和 ADK。
• 开发货币兑换代理。
• 将代理部署到 Agent Runtime。
• 测试已部署的智能体。

您还可以使用以下 ADK 替代快速入门指南：

• ADK 快速入门：ADK 快速入门完全在您的机器上运行，并假定您使用的是本地 IDE 和终端访问权限。
• Agent Starter Pack：一组可用于生产环境的生成式 AI 智能体模板，专为 Agent Platform 而打造。

如需了解使用除智能体开发套件以外的其他受支持框架的快速入门指南，请参阅在 Agent Runtime 上开发和部署代理。

准备工作

注意：您需要拥有 serviceusage.services.enable 权限才能启用 API。如果您没有此权限，请让您的管理员为您授予 Service Usage Admin (roles/serviceusage.serviceUsageAdmin) 角色。

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请 创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

如需获得使用 Agent Runtime 所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

• Agent Platform User (roles/aiplatform.user)
• Storage Admin (roles/storage.admin)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

安装并初始化 Agent Platform SDK for Python

1. 运行以下命令以安装 Agent Platform SDK for Python 和其他所需的软件包：

   pip install --upgrade --quiet google-cloud-aiplatform[agent_engines,adk]>=1.112

2. 以用户身份进行身份验证

   本地 Shell

   运行以下命令：

   gcloud auth application-default login

   Colab

   运行以下代码：

   from google.colab import auth
   
   auth.authenticate_user(project_id="PROJECT_ID")
   

   Cloud Shell

   您无需执行任何操作。

3. 运行以下代码以导入 Agent Platform 并初始化 SDK：

   Google Cloud 项目

   import vertexai
   
   client = vertexai.Client(
       project="PROJECT_ID",               # Your project ID.
       location="LOCATION",                # Your cloud region.
   )
   

   其中：

   • PROJECT_ID 是您将在其中开发和部署代理的 Google Cloud 项目 ID

   • LOCATION 是支持的区域之一。

开发代理

1. 为代理开发货币兑换工具：

   def get_exchange_rate(
       currency_from: str = "USD",
       currency_to: str = "EUR",
       currency_date: str = "latest",
   ):
       """Retrieves the exchange rate between two currencies on a specified date."""
       import requests
   
       response = requests.get(
           f"https://api.frankfurter.app/{currency_date}",
           params={"from": currency_from, "to": currency_to},
       )
       return response.json()
   

2. 实例化代理：

   from google.adk.agents import Agent
   from vertexai import agent_engines
   
   agent = Agent(
       model="gemini-2.0-flash",
       name='currency_exchange_agent',
       tools=[get_exchange_rate],
   )
   
   app = agent_engines.AdkApp(agent=agent)
   

3. 在本地测试代理：

   注意：在本地测试 ADK 智能体时，会使用内存中的会话。

   async for event in app.async_stream_query(
       user_id="USER_ID",
       message="What is the exchange rate from US dollars to SEK today?",
   ):
       print(event)
   

   其中，USER_ID 是用户定义的 ID，字符数限制为 128。

部署代理

通过在 Agent Platform 中创建 reasoningEngine 资源来部署代理：

注意： 将 ADK 智能体部署到 Agent Platform 会自动生成受管理的会话资源。您可以在清理部分中删除受管理的会话资源以及智能体。

remote_agent = client.agent_engines.create(
    agent=app,
    config={
        "requirements": ["google-cloud-aiplatform[agent_engines,adk]"],
        "staging_bucket": "STAGING_BUCKET",
        "identity_type": types.IdentityType.AGENT_IDENTITY,
    }
)

其中，STAGING_BUCKET 是以 gs:// 为前缀的 Cloud Storage 存储桶。

使用代理

通过发送查询来测试部署的智能体：

async for event in remote_agent.async_stream_query(
    user_id="USER_ID",
    message="What is the exchange rate from US dollars to SEK today?",
):
    print(event)

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

remote_agent.delete(force=True)

后续步骤

指南

Agent Platform 运行时设置

设置环境以使用 Agent Platform Runtime。

指南

部署代理

了解根据您的开发需求，在 Agent Platform Runtime 上部署代理的五种方式。

指南

管理已部署的智能体

了解如何管理已部署到 Agent Platform 托管运行时的代理。

指南

使用代理

使用 Agent Platform Runtime 运行代理。

资源

获取支持

查找 Google Agent Platform 的相关资源和支持。