注册代理

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

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

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

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

自动注册

受支持的 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) 的容器化智能体在包含特定的 Agent Registry 功能类型标签时会注册。
  • Cloud Run:部署到 Cloud Run 服务或作业的容器化智能体在部署时带有 特定功能类型标志时会注册。

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

  • 实现 Agent2Agent (A2A) 协议的智能体: A2A 是一种开放标准,可让 智能体声明其功能和身份。如果您的智能体实现了 此协议,Agent Registry 会自动从智能体的 A2A 技能 中提取其 智能体卡片,并 填充注册表。
  • 未实现 A2A protocol 的智能体:Agent Registry 会注册智能体,但无法自动捕获推理网址和 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 端点。

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

跨项目注册注意事项

如果您的组织使用具有 Agent Gateway的集中式治理架构, 您可以在中央治理 项目中部署 Agent-to-Anywhere 出站网关,并注册部署在多个分支或工作负载项目中的智能体。

由于自动注册仅发现本地项目中的资源,因此您必须在中央治理项目的注册表中手动注册远程智能体。通过跨项目注册,中央网关可以定位和管理智能体。如需了解相关说明,请参阅 注册来自其他项目的智能体

集成独立技能

借助 Agent Registry,您可以将智能体的独立 技能作为顶级资源进行管理和治理。 独立技能在注册表中注册为 Skill 资源, 管理员可以使用技能修订版本应用精细的访问权限政策并管理版本 历史记录。

在 Gemini Enterprise 中 构建和管理智能体时, 您可以引用这些已注册的技能来扩展智能体的功能。 如需了解如何注册和管理独立技能,请参阅 注册技能管理技能