快速入门：注册代理

在 Agent Registry 中注册智能体后，您可以将一个孤立的组件转变为 AI 生态系统中可被发现的一部分。通过发布智能体的 A2A 技能，您可以帮助组织中的其他开发者和编排器智能体找到并重复使用您的工作成果。

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

准备工作

  1. 设置 Agent Registry。
  2. 获取已启用 Agent Registry 的治理项目的项目 ID。

所需的角色

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

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

注册模拟智能体

如需试用智能体注册表，您可以粘贴示例 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 A2A 技能是否显示在概览标签页中。

清理

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

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

后续步骤