Agent Registry 使用标准化术语来描述 AI 生态系统中的组件、资源和治理机制。了解这些基础概念有助于您在 Agent Registry 中注册、发现、连接和治理智能体、MCP 服务器、端点和技能。
A2A 技能
与技能进行比较。
在智能体的agent-card.json
智能体卡片中以内嵌方式列出的功能说明。A2A 技能描述了智能体可以执行的任务及其通信接口，以便其他智能体知道何时以及如何向其委托工作。
Agent Registry 支持 Agent2Agent (A2A) 规范的版本 0.3 和 1.0。如需与独立技能进行比较，请参阅独立技能与 A2A 技能之间的区别。
代理
AI 生态系统中的自主执行者，可进行规划、推理、调用工具以及与其他智能体协作。智能体由其智能体标识符以及它所拥有的每个 A2A 技能或独立技能定义。在 Agent Registry 中，已注册的智能体表示为只读 Agent 发现资源。
智能体主体
分配给代理的唯一 Identity and Access Management (IAM) 身份，使其能够持有权限、访问下游资源并生成审核日志。它采用可验证的 Google Cloud 服务账号或 Workload Identity（例如 SPIFFE ID）的形式，直接绑定到智能体的计算运行时。
主账号字符串包含运行时引用路径，并支持三个范围：引擎实例、项目级主账号集和组织级主账号集。
如需了解完整的语法和访问权限控制指南，请参阅智能体主体。
智能体组件
AI 生态系统中的模块化功能实体，您可以通过 Agent Registry 注册、发现和治理这些实体。注册表将智能体组件分为四种主要类型：智能体、MCP 服务器、端点和技能。
如需了解详情，请参阅组件生命周期和发现。
智能体工作流
一系列步骤，其中 AI 智能体独立确定工具使用、推理和执行路径以完成任务。
身份验证提供方
Agent Identity 身份验证管理器中的一种配置，用于存储、获取和管理凭证（例如 API 密钥或 OAuth 令牌），以便将智能体连接到外部工具和下游服务。
如需详细了解如何将代理绑定到身份验证提供方，请参阅组件关系。
绑定
源智能体与目标资源（例如其他智能体、MCP 服务器或端点）之间的定向连接。绑定会在组件之间建立明确的委托路径，并将智能体与身份验证提供方相关联，以实现委托权限。
如需了解详情，请参阅绑定。
数据资源
由 MCP 服务器公开的特定数据上下文或数据集，智能体可以访问这些数据来作为其回答的依据或指导其操作。
发现
使用自然语言搜索、标记或注册表标识符查询 Agent Registry 以查找已注册的代理、MCP 工具、端点或技能的过程。
Agent Registry 中的发现功能侧重于使用发现，即识别编排器智能体在运行时可以调用的功能和组件。如需了解详情，请参阅发现类型。
端点
代理访问的目标网址，通常是 REST API。在智能体注册表中，已注册的端点表示为只读 Endpoint 发现资源，可让您集中管理智能体可以访问的外部服务。
治理项目
Google Cloud 项目，您可以在其中启用 Agent Registry API，以集中编目、发现和治理智能体组件。如需详细了解单项目和跨项目配置，请参阅为中央注册表定义治理项目。
治理范围
注册和管理 Agent Registry 资源的地理和架构边界。
Agent Registry 使用一个中央 Google Cloud 治理项目，您可以在其中启用 Agent Registry API，以便对智能体组件进行编目和治理。自动注册会发现该治理项目中部署的受支持工作负载。如需治理远程组件（即托管在治理项目之外的单独 Google Cloud 项目、本地环境或外部云中的代理、MCP 服务器或端点），您需要在治理项目的注册表中手动注册这些组件。
当 Agent Registry 自动注册 Google 或 Google Cloud远程 MCP 服务器时，它仅在 global 位置创建 McpServer 资源，而不会在各个区域中创建。您可以在受支持的区域级位置或 global 位置手动注册智能体、MCP 服务器和端点，并创建绑定。区域级网关可以管理流量并将其路由到区域级资源和 global MCP 服务器。
如需了解完整的区域范围规则和政策要求，请参阅代理注册表位置。
Model Context Protocol (MCP)
用于将 AI 模型连接到数据源和工具的开放标准，取代了定制插件。
MCP 服务器
一种实现 Model Context Protocol (MCP) 的程序，用于向 AI 智能体公开标准化的工具和数据资源功能。在 Agent Registry 中，已注册的 MCP 服务器表示为只读 McpServer 发现资源。
Publisher
创建和注册技能的实体，在 Agent Registry 中表示为 Publisher 资源。发布商会为技能建立所有权和技能标识符语法。
Google 管理的 skill 使用服务网域。手动创建的技能会自动限定为 private 发布商，并带有 private- 前缀。
如需了解详情，请参阅发布商。
注册
将智能体组件（例如智能体、MCP 服务器、端点或技能）添加到 Agent Registry 的过程。
Agent Registry 支持两种注册模型：
- 自动注册：自动从支持的 Google Cloud 运行时（例如 Gemini Enterprise Agent Platform 上的 Agent Runtime）中提取智能体、MCP 服务器和 Google 管理的 skill，这些运行时部署在启用了 Agent Registry 的治理项目中。
- 手动注册：通过在治理项目的注册表中创建资源，显式注册远程或自定义智能体、MCP 服务器、端点和私有独立技能，包括托管在单独 Google Cloud 项目、本地环境、外部云或不受支持的运行时中的组件。
如需详细的架构比较，请参阅注册模型。
注册表标识符
Agent Registry 分配给已注册智能体组件的全局唯一且不可变的统一资源名称 (URN)。此标识符为使用方和编排器智能体提供了一个稳定的参考，以便在 Agent Registry 中发现、过滤和搜索组件，无论底层基础设施发生变化还是代码更新，该标识符都保持不变。
如需了解详细的 URN 语法格式，请参阅注册表标识符。
运行时参考
托管智能体、MCP 服务器或端点的物理运行时位置或计算基础设施，在智能体注册表中由 agentregistry.googleapis.com/system/RuntimeReference 属性表示。例如，运行时引用可以指向 Agent Runtime 推理引擎、Google Kubernetes Engine (GKE) 部署或 Cloud Run 服务。
运行时引用路径嵌入在智能体主体中，用于 IAM 政策评估。如需了解详情，请参阅运行时参考文档。
服务资源
Agent Registry 中的可写资源，由其自己的资源名称标识，在您手动注册智能体、MCP 服务器或端点时，用于管理操作。Service 资源存储组件的元数据，包括智能体组件的类型以及配置详细信息，例如其接口网址、说明、协议绑定和功能规范。自动注册的组件或独立技能不使用 Service 资源。
您可以通过创建、更新或删除 Service 资源，在 Agent Registry 中注册、更新元数据或取消注册手动注册的组件，而无需修改或删除底层部署。当您创建或更新 Service 资源时，Agent Registry 会读取元数据，并自动创建或更新相应的 Agent、McpServer 或 Endpoint 发现资源。在 Agent Registry 中，使用方（例如编排器智能体、客户端应用和开发者）使用这些只读发现资源来列出、搜索和查看智能体组件。如需了解详情，请参阅 Agent Registry 中的智能体组件表示。
技能
与 A2A 技能进行比较。
在 Agent Registry 中注册为顶级 Skill 资源的独立软件包，通过提供完成任务所需的特定指令和可选脚本来扩展智能体的功能。技能包含 SKILL.md 指令文件、可选脚本和元数据资源。
技能由技能标识符标识，该标识符由发布者和标准资源名称限定范围。每项技能都会维护一个默认修订版本指针，并具有一个或多个版本化快照，每个快照都表示为一个技能修订版本。
如需了解架构、打包和生命周期详情，请参阅技能架构。
技能修订版本
技能软件包的不可变版本化快照，在 Agent Registry 中表示为 SkillRevision 资源。通过技能修订版本，您可以更新技能指令或可选脚本，而无需更改父级技能标识符或破坏现有代理依赖项。
如需详细了解修订版本控制和不可变性，请参阅技能修订版本。
工具
由 MCP 服务器提供的确定性函数，可供智能体调用。