注册代理

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

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

根据 Agent Runtime,Agent Registry 支持两种主要的注册机制:自动注册手动注册

选择适合您的代理运行时环境的注册机制。

自动注册

受支持的 Google Cloud 运行时会通过默认方式或选择性部署步骤,在同一项目内向 Agent Registry 注册您的代理。自动注册在项目级层运行,不会自动发现部署在其他 Google Cloud项目中的代理。

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

  • Gemini Enterprise Agent Platform 上的 Agent Runtime:使用 SDK 部署的代理无需额外配置即可注册。如需了解详情,请参阅从 Agent Runtime 注册代理
  • 内置 Google 智能体:Google 直接提供的智能体(例如 Google Workspace 和 Gemini Enterprise 智能体)无需任何配置即可发现。如需了解详情,请参阅注册内置 Google 代理
  • Google Kubernetes Engine:部署到 Google Kubernetes Engine (GKE) 的容器化 AI 智能体在配置了 AI 智能体功能类型标签和智能体卡片注解后会进行注册。GKE 集群运行时控制器会执行自检扫描,并将元数据发布到 Agent Registry。如需了解详情,请参阅从 GKE 注册代理
  • Cloud Run:部署到 Cloud Run 服务或作业的容器化代理在部署时会使用功能和身份类型标志进行注册。Cloud Run 会自动向 Agent Registry 注册代理的名称、网址和类型 (AGENT)。如需了解详情,请参阅从 Cloud Run 注册代理

注册期间为代理编入索引的元数据和功能取决于代理是否实现了 Agent2Agent (A2A) 协议:

  • 实现 A2A 协议的代理:系统会查询代理的代理卡片 (/.well-known/agent-card.json),以自动将代理的已公布 A2A 技能和功能提取到注册目录中。
  • 未实现 A2A protocol(标准 REST 或 gRPC 端点)的代理:系统会注册代理的接口网址和传输绑定,但无法自动提取语义功能。如需将功能与非 A2A 端点相关联,您可以使用手动注册来描述这些功能,也可以将这些功能与 AI 应用中的独立技能和 MCP 服务器相关联。

如需了解支持自动注册的 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 Registry,您可以将代理的独立技能作为顶级资源进行管理和控制。独立技能在注册表中注册为 Skill 资源,管理员可以使用技能修订版本应用精细的访问权限政策并管理版本历史记录。

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