借助 Agent Registry，您可以注册、发现和连接模块化智能体组件，以便开发者和编排器智能体在整个组织中查找和重复使用 AI 功能。了解 Agent Registry 如何通过自动和手动注册来表示组件，有助于您发现功能并使用绑定和身份验证提供方连接这些功能。
AI 生态
您可以注册、发现和治理四种类型的模块化智能体组件，以集成您的 AI 生态系统：
- 智能体：自主 AI 参与者，可进行规划、推理、调用工具以及与其他智能体协作。
- MCP 服务器：实现 Model Context Protocol (MCP) 以公开标准化工具和数据资源的程序。
- 端点：代理访问的目标网址，通常是 REST API。
- 技能：独立的指令和可选脚本包，或内嵌的 A2A 技能，用于扩展智能体的功能。
Agent Registry 中的智能体组件表示
在 Agent Registry 中，您可以通过自动或手动注册来注册智能体组件。Agent Registry 如何表示组件取决于其组件类型和注册模型。
智能体、MCP 服务器和端点
无论智能体、MCP 服务器或端点如何注册，Agent Registry 都会将其表示为具有标准资源名称的只读 Agent、McpServer 或 Endpoint 发现资源。智能体组件的使用方（例如编排器智能体、客户端应用和开发者）可以使用发现资源来列出、搜索和查看注册表中的所有可用组件。
Agent Registry 如何创建和更新这些发现资源取决于组件的注册方式：
- 自动注册：智能体注册表直接从支持的运行时中提取元数据，并自动创建和更新相应的
Agent或McpServer发现资源。自动注册的组件在 Agent Registry 中没有Service资源。相反，当您在运行时更新或删除底层部署或工作负载时，智能体注册表会同步更改。 - 手动注册：当您手动注册或更新组件时，Agent Registry 会创建或更新两个资源：
- 可写
Service资源，由其自己的资源名称标识。您可以使用此资源来更新或取消注册组件。修改或删除Service资源只会更改其在 Agent Registry 中的条目，而不会修改或删除底层部署。 - 一种只读发现资源，用于表示智能体组件的类型，该资源会根据
Service资源的元数据自动创建和更新：Agent资源：编排器代理、客户端应用和开发者读取的只读发现资源，用于查找和调用代理。McpServer资源：只读发现资源，用于公开 MCP 服务器的标准化工具和数据资源。Endpoint资源：智能体访问的外部网址和 REST API 的只读发现资源。
- 可写
如需详细了解 Service 资源规范标志如何映射到只读资源集合，请参阅服务资源和发现资源。
独立技能
与智能体、MCP 服务器和端点不同，独立技能不使用单独的 Service 资源和只读发现资源。相反，Agent Registry 使用顶级 Skill 资源来表示每项技能，以便进行管理和发现，同时使用子级 SkillRevision 资源来表示不可变的版本化快照，并使用 Publisher 资源来限定所有权范围：
- 自动注册：Google 管理的 skill 会自动作为
Skill和SkillRevision资源在所有项目中提供。 - 手动注册：注册或更新私有独立技能时，您需要创建或更新
Skill资源，并直接在 Agent Registry 中上传不可变的SkillRevision资源。消费者使用相同的Skill和SkillRevision资源列出、搜索和检索技能。
注册模型
Agent Registry 支持两种注册智能体组件的模型：
| 特征 | 自动注册 | 手动注册 |
|---|---|---|
| 范围 | 部署的组件仅限于单个项目。内置 Google 智能体、Google 和 Google Cloud 远程 MCP 服务器以及 Google 管理的 skill 可跨项目使用。 | 范围限定为单个项目或跨多个项目集中管理。 |
| 配置 | Gemini Enterprise Agent Platform 上的 Agent Runtime、内置 Google 智能体、Google 和 Google Cloud 远程 MCP 服务器以及 Google 管理的 skill 会自动注册。Google Kubernetes Engine (GKE) 和 Cloud Run 工作负载需要选择启用的部署标签或标志。 | 需要在 Agent Registry 中创建 Service 或 Skill 资源。 |
| 运行时 | Agent Runtime、GKE、Cloud Run 和 Google 管理的运行时。 | Compute Engine、GKE、Cloud Run、本地系统和外部云平台。 |
| 目标组件 | 智能体、MCP 服务器和 Google 管理的独立技能。 | 自定义或外部智能体、MCP 服务器、端点和私有独立技能。 |
| 元数据更新 | 从运行时环境或智能体卡片端点自动同步。 | 需要通过修改 Service 资源或在 Agent Registry 中上传新的 SkillRevision 资源来进行手动更新。 |
自动注册
自动注册功能会从受支持的 Google Cloud 运行时中提取代理、MCP 服务器和 Google 管理的独立技能，而无需您在 Agent Registry 中手动创建资源。部署到 Agent Runtime 的智能体、来自 Google Workspace 和 Gemini Enterprise 的内置 Google 智能体、Google 和Google Cloud 远程 MCP 服务器，以及 Google 管理的独立技能都会自动注册。对于 GKE 部署和 Cloud Run 工作负载，您可以在部署代理或 MCP 服务器时添加功能类型标签或标志，以启用自动注册。
在自动注册期间，Agent Registry 会将组件的端点、注册表标识符、运行时引用以及通告的 A2A 技能或 MCP 工具提取到 Agent Registry 中的发现资源中。
如需详细了解如何配置自动注册，请参阅为智能体使用自动注册和注册 MCP 服务器。
手动注册
通过手动注册，您可以直接在 Agent Registry 中创建资源，从而注册远程或自定义智能体、MCP 服务器、端点和私有独立技能。您可以手动注册托管在 Compute Engine、GKE、Cloud Run、本地基础架构或外部云平台上的代理、MCP 服务器或 REST API 端点，包括未实现 A2A protocol 的代理。通过手动注册，您还可以将部署在不同 Google Cloud 项目中的远程组件注册到中央治理项目的注册表中，以便进行集中发现和治理。
如需手动注册智能体、MCP 服务器或端点，您需要在 Agent Registry 中创建 Service 资源，并指定组件的接口网址、协议绑定以及 --agent-spec-type、--mcp-server-spec-type 或 --endpoint-spec-type 规范标志。如需手动注册独立技能，您需要创建一个包含 ZIP 归档文件载荷的 Skill 资源。
如需详细了解如何配置手动注册，请参阅为代理使用手动注册、注册端点和注册技能。
发现类型
在 Google Cloud中，Agent Registry 中的发现与基础架构管理工具中的发现不同：
- 使用发现：Agent Registry 专注于查找编排器可在运行时调用的已注册智能体、MCP 工具、端点和技能。开发者和智能体可以使用自然语言搜索、标签或注册表标识符查询 Agent Registry，以找到完成工作流所需的功能。
- 基础设施发现：App Hub 等服务专注于检测 Google Cloud 项目中的物理计算资源，例如虚拟机、GKE 服务和 Cloud Run 部署。App Hub 会将这些计算资产整理到应用和环境中，以便进行基础设施运行状况、资源监控和可靠性跟踪。
基础设施发现功能会跟踪工作负载的运行位置，而 Agent Registry 中的使用情况发现功能则会识别智能体或工具提供的功能。
组件关系
如需编写多代理工作流并管理出站凭据，您可以使用绑定和身份验证提供方在组件之间创建显式关系。
绑定
绑定使用源代理和目标资源的注册表标识符 (URN) 定义它们之间的定向连接：
- 智能体到智能体绑定：建立委托路径，让编排器智能体调用专业子智能体。
- 智能体到 MCP 服务器绑定：将智能体连接到 MCP 服务器，将智能体与服务器发布的工具和数据资源相关联。
- 智能体到端点绑定：将智能体连接到已注册的外部端点，例如 REST API。
绑定可让您了解多智能体拓扑，帮助团队审核哪些智能体与下游功能进行交互。如需了解如何创建和管理绑定，请参阅管理绑定。
身份验证提供方
当智能体与外部工具、MCP 服务器或 API 交互时，通常需要专用凭证。身份验证提供方是 Agent Identity 身份验证管理器中的一种配置，可代表智能体存储、获取和管理凭证，例如 OAuth 令牌或 API 密钥。
通过将绑定与身份验证提供方相关联，您可以让智能体向外部目标进行身份验证，而无需在提示模板或智能体源代码中嵌入 Secret。如需了解详情，请参阅向工具和资源进行身份验证。