快速入门：注册代理

注册智能体后，智能体将从孤立的 组件转变为 Agent Registry 中可被发现的集成 AI 生态系统的一部分。通过发布智能体的技能，您可以 让组织中的其他开发者和编排器智能体找到并重复使用 您的工作，从而加快整体 AI 开发速度。

本快速入门介绍如何使用 Google Cloud 控制台在 Agent Registry 中手动注册模拟智能体。如需详细了解 Agent Registry 中的智能体 注册机制，请参阅 注册智能体。

准备工作

在开始之前，请先设置 Agent Registry。您需要 项目 ID 才能执行这些任务。

启用 Agent Registry API：

控制台

启用 API 所需的角色

如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已通过所有者角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

启用 API

gcloud

在项目中启用 Agent Registry API：

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

将 PROJECT_ID 替换为 您的项目 ID。

所需角色

如需获得在 Agent Registry 中注册智能体所需的权限，请让您的管理员为您授予项目的Agent Registry API Editor (roles/agentregistry.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

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

注册模拟智能体

如需试用 Agent Registry，您可以手动注册模拟智能体，方法是粘贴示例 Agent2Agent (A2A) 智能体卡片。

请按照以下步骤注册智能体：

  1. 在 Google Cloud 控制台中，前往 Agent Registry：

    前往 Agent Registry

    如果系统提示，请点击启用 以启用 Agent Registry API。

  2. 在项目选择器中，选择您 设置 Agent Registry的 Google Cloud 项目。

  3. 选择智能体 标签页。

  4. 点击添加智能体 。

  5. 在智能体详情 面板中，输入以下详细信息：

    • 类型：选择 A2A。
    • 区域：选择 global（全球）。

  6. 选择粘贴 JSON 标签页。

  7. 复制并粘贴以下示例智能体卡片内容：

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. 点击保存 。

Agent Registry 会处理智能体卡片并注册智能体。

验证注册

如需确认模拟智能体已成功注册，请执行以下操作：

  1. 在智能体 标签页上，在列表中找到模拟智能体。
  2. 点击智能体的名称以查看其详细信息。
  3. 验证 BookFlight 和 SearchHotels 技能是否显示在概览 标签页上。

清理

为避免在项目中留下模拟资源，请删除已注册的智能体：

  1. 在智能体 标签页上，在列表中找到模拟智能体。
  2. 在模拟智能体的操作 列中，点击 更多选项 菜单，然后选择删除。
  3. 在确认对话框中，输入 DELETE 以确认操作。
  4. 点击删除 。

后续步骤