注册代理会将其转换为 Agent Registry 中的可发现组件。通过发布智能体的 A2A 技能,您可以帮助组织中的其他开发者和编排器智能体找到并重用您的工作,从而加快整体 AI 开发速度。
智能体注册表可与 Agent2Agent (A2A) 协议及其规范无缝集成。A2A 是一种开放标准,可让智能体声明其功能和身份。代理注册表支持 A2A 规范的版本 0.3 和 1.0。如需了解详情,请参阅智能体卡片架构。
根据代理运行时,代理注册表支持两种主要的注册机制:自动注册和手动注册。
本文档可帮助您选择适合代理运行时环境的注册机制。
自动注册
受支持的 Google Cloud 运行时会默认或通过选择性部署步骤在同一项目内向 Agent Registry 注册您的代理。自动注册在项目级层运行,不会自动发现部署在其他 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 技能取决于代理的协议:
- 实现 Agent2Agent (A2A) 协议的代理:A2A 是一种开放标准,可让代理声明其功能和身份。如果您的代理实现了此协议,代理注册表会自动从代理的代理卡片中提取代理的 A2A 技能,并填充注册表。
- 未实现 A2A 协议的代理:代理注册表会注册代理,但无法自动捕获推理网址和 A2A 技能等元数据。如需提供此信息以使代理可被发现,请使用手动注册。
如需了解支持自动注册的 Google Cloud 运行时,请参阅使用自动注册。
手动注册
对于托管在外部平台、本地、不支持自动发现的 Google Cloud运行时或不同Google Cloud 项目中的代理,您必须使用手动注册。
如需手动注册代理,您可以使用 Agent Registry API、Google Cloud CLI 或 Terraform 创建一个 Service 资源,用于定义代理的端点和配置。此可写入的 Service 资源还包含代理的特定详细信息。创建 Service 后,注册表会生成一个只读 Agent 资源,您可以使用该资源进行发现。
您可以手动注册两种类型的代理:
- 符合 A2A 标准的代理:实现 A2A 规范 (
A2A_AGENT_CARD) 的代理。注册中心会扫描其代理卡片 (agent-card.json) 端点,以编入其 A2A 技能的索引。 - 标准 REST 代理:未实现 A2A 规范 (
NO_SPEC) 的远程代理,例如标准 REST API 端点。
如需了解如何手动注册代理,请参阅使用手动注册。
跨项目注册注意事项
如果您的组织使用具有智能体网关的集中式治理架构,则可以在中央治理项目中部署“智能体到任意位置”的出站网关,并注册部署在多个 Spoke 或工作负载项目中的智能体。
由于自动注册仅发现本地项目中的资源,因此您必须在中央治理项目的注册表中手动注册远程代理。通过跨项目注册,中央网关可以定位和管理代理。如需查看相关说明,请参阅注册其他项目中的代理。
集成独立技能
借助代理注册表,您可以将代理的独立技能作为顶级资源进行管理和控制。独立技能在注册表中注册为 Skill 资源,管理员可以使用技能修订版本应用精细的访问权限政策并管理版本历史记录。
在 Gemini Enterprise 中构建和管理智能体时,您可以引用这些已注册的技能来扩展智能体的功能。 如需了解如何注册和管理独立技能,请参阅注册技能和管理技能。