注册代理

注册一个 智能体 后,该智能体将成为 Agent Registry 中的可发现组件 。通过发布智能体的 技能, 您可以帮助组织中的其他开发者和编排器智能体查找和 重复使用您的工作,从而加快整体 AI 开发速度。

Agent Registry 与 Agent2Agent (A2A) 协议及其 规范无缝集成。A2A 是一种开放标准,可让智能体声明其功能和身份。Agent Registry 支持 A2A 规范的 0.31.0 版本。如需了解详情,请参阅 智能体卡片架构

根据您的智能体运行时,Agent Registry 支持两种主要的 注册机制:自动注册手动注册

本文档可帮助您选择适合您的智能体运行时的注册机制。

自动注册

受支持的 Google Cloud 运行时会向 Agent Registry 默认或通过选择性部署步骤注册您的智能体。

以下运行时支持自动注册: Google Cloud

  • Gemini Enterprise Agent Platform 上的 Agent Runtime:使用 SDK 部署的智能体 无需额外配置即可注册。
  • 内置 Google 智能体:Google 直接提供的智能体(例如 Google Workspace 和 Gemini Enterprise 智能体)无需任何配置即可被发现 。
  • Google Kubernetes Engine:部署到 Google Kubernetes Engine (GKE) 的容器化智能体在包含特定的 Agent Registry 功能类型标签时会进行注册。

在注册期间捕获的智能体的元数据和技能取决于智能体的协议:

  • 实现 A2A 协议的智能体:如果您的智能体实现了 A2A 协议,Agent Registry 会自动从 智能体的 智能体卡片 中提取智能体的技能,并 填充注册表。
  • 未实现 A2A 协议的智能体:Agent Registry 会注册 智能体,但无法自动捕获推理网址 和技能等元数据。如需提供此信息以使您的智能体可被发现,请使用 手动注册

如需了解支持自动注册的 Google Cloud 运行时, 请参阅使用自动注册

手动注册

对于托管在外部平台、本地或在 Google Cloud 不支持自动发现的运行时上的智能体,您必须使用手动 注册。

如需手动注册智能体,您可以使用 Agent Registry API、Google Cloud CLI 或 Terraform 创建 Service 资源,以定义智能体的端点和配置。此可写 Service 资源还包含智能体的具体详细信息。创建 Service 后,注册表会生成一个 只读 Agent 资源,您可以使用该资源进行 发现

您可以手动注册两种类型的智能体:

  • 符合 A2A 标准的智能体:实现 A2A 规范 (A2A_AGENT_CARD) 的智能体。注册表会扫描其 智能体卡片 (agent-card.json) 端点,以对其技能编制索引。
  • 标准 REST 智能体:未实现 A2A 规范 (NO_SPEC) 的远程智能体,例如标准 REST API 端点。

如需了解如何手动注册智能体,请参阅使用手动注册