快速入门：注册代理

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

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

准备工作

开始之前，请先设置代理注册表。您需要项目 ID 才能执行这些任务。

所需的角色

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

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

注册模拟代理

如需试用代理注册表，您可以粘贴示例 Agent2Agent (A2A) 代理卡片，手动注册模拟代理。

请按照以下步骤注册代理：

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

    前往 Agent Registry

  2. 在项目选择器中，选择设置代理注册表的 Google Cloud 项目。

  3. 选择代理标签页。

  4. 点击添加智能体。

  5. 在代理详情面板中，输入以下详细信息：

    • Display name：Mock Travel Agent
    • 说明：A mock agent that plans travel itineraries.
    • 位置：选择 global。
    • 代理类型：选择 A2A。

  6. 在代理规范部分中，选择粘贴 JSON 标签页。

  7. 复制并粘贴以下代理卡内容示例：

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. 点击保存。

Agent Registry 会处理代理卡片并注册代理。

验证注册

如需确认您的模拟代理已成功注册，请执行以下操作：

  1. 在代理标签页上，找到列表中的 Mock Travel Agent。
  2. 点击 Mock Travel Agent 以查看其详细信息。
  3. 验证 BookFlight 和 SearchHotels 技能是否显示在概览标签页上。

清理

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

  1. 在代理标签页上，找到列表中的 Mock Travel Agent。
  2. 点击模拟旅行代理旁边的 更多选项菜单，然后选择删除。
  3. 在确认对话框中点击删除。

后续步骤