注册代理会将其变成 Agent Registry 中可发现的组件。通过发布代理的技能,您可以帮助组织中的其他开发者和编排器代理找到并重用您的工作成果,从而加快整体 AI 开发速度。
代理注册表与 Agent2Agent (A2A) 协议及其规范无缝集成。A2A 是一种开放标准,可让代理声明其功能和身份。代理注册表支持 A2A 规范的版本 0.3 和 1.0。如需了解详情,请参阅智能体卡片架构。
根据代理运行时,代理注册表支持两种主要的注册机制:自动注册和手动注册。
本文档可帮助您选择适合代理运行时环境的注册机制。
自动注册
受支持的 Google Cloud 运行时会通过默认方式或选择性部署步骤向代理注册表注册代理。
以下 Google Cloud 运行时支持自动注册:
- Gemini Enterprise Agent Platform 上的 Agent Runtime:使用 SDK 部署的代理无需额外配置即可注册。
- 内置 Google 智能体:Google 直接提供的智能体(例如 Google Workspace 和 Gemini Enterprise 智能体)无需任何配置即可发现。
- Google Kubernetes Engine:部署到 Google Kubernetes Engine (GKE) 的容器化代理在包含特定的代理注册表功能类型注解时会进行注册。
在注册期间捕获的代理的元数据和技能取决于代理的协议:
- 实现 A2A 协议的代理:如果您的代理实现了 A2A 协议,代理注册服务会自动从代理的代理卡片中提取代理的技能,并填充注册服务。
- 未实现 A2A 协议的代理:代理注册表会注册代理,但无法自动捕获推理网址和技能等元数据。如需提供此信息以使代理可被发现,请使用手动注册。
如需了解支持自动注册的 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 端点。
如需了解如何手动注册代理,请参阅使用手动注册。