本文档介绍了与代理注册表相关的关键术语和概念。
A2A 技能
与技能进行比较。
在智能体的智能体卡片 (agent-card.json) 中内嵌列出的功能描述。A2A 技能描述了智能体可以执行的任务及其通信接口，以便其他智能体知道何时以及如何将工作委托给该智能体。
代理注册表支持 Agent2Agent (A2A) 规范的 0.3 和 1.0 版本。
代理
AI 生态系统中的自主行动者，由其标识符和所拥有的特定 A2A 技能或技能定义。
代理标识符
代理的全局唯一且不可变的统一资源名称 (URN)。 此标识符可为消费者提供稳定的参考，以便查找和调用代理，无论底层基础架构发生变化还是代码更新，此标识符都保持不变。
如需详细了解各种受支持的运行时中的 URN 语法格式，请参阅代理标识符。
Agent Registry 使用代理标识符进行库存跟踪、注册发现和过滤。如果您想在 IAM 中控制访问权限和身份验证，请改用智能体主体。
智能体主体
分配给代理的唯一 Identity and Access Management (IAM) 身份，可让代理持有权限、访问下游资源并生成审核日志。它采用可验证的 Google Cloud 服务账号或受管 Workload Identity（例如直接绑定到代理的计算运行时的 SPIFFE ID）的形式。
主账号字符串包含运行时资源路径，并支持以下三种范围：引擎实例、项目级主账号集和组织级主账号集。
如需了解完整的语法和访问权限控制指南，请参阅智能体主体。
智能体组件
AI 生态系统中的模块化功能实体，您可以通过 Agent Registry 注册、发现和治理该实体。注册表将智能体组件分为四种主要类型：智能体、MCP 服务器、端点和技能。
Agentic 工作流
AI 智能体自主确定工具使用、推理和执行路径以完成任务的一系列步骤。
身份验证提供方
Agent Identity 身份验证管理器中的一种配置，用于存储、获取和管理凭据（例如 API 密钥或 OAuth 令牌），以便将代理连接到特定的外部工具和应用，并定义身份验证类型。
绑定
源代理与目标资源（例如另一个代理、MCP 服务器或端点）之间的连接。通过创建绑定，您可以建立明确的关系，让编排器代理与下游功能进行交互。绑定还用于将代理与身份验证提供方相关联，以支持委托权限。
数据资源
由 MCP 服务器公开的特定数据上下文或数据集，代理可以访问这些数据来为回答提供依据或指导其行动。
发现
根据说明、标记或技能查询注册表以查找现有代理、MCP 工具或端点的过程。
Agent Registry 中的发现功能侧重于 AI 编排器可使用的以消费为中心的功能。您可以发现已注册的功能，以构建和编排 AI 系统。
Agent Registry 中的此流程与基础设施发现（例如 App Hub 中的基础设施发现）不同，后者用于识别 Google Cloud 项目中的未注册计算资源。
端点
对于 Agent Registry API，一种表示目标网址（通常是 REST API）的资源，由代理访问。通过将这些目的地抽象为可管理的资源，代理注册表可让您集中管理代理可以访问哪些外部服务。
端点标识符
已注册端点的全局唯一且不可变的统一资源名称 (URN)。与代理标识符和 MCP 服务器标识符类似，此 URN 可提供稳定的注册表参考，用于发现目标 API 目的地。如需了解详情，请参阅端点标识符。
治理范围
注册和管理代理注册表资源的地理和架构边界。
Google 管理的 MCP 服务器仅在 global 位置注册。
您可以在受支持的国家/地区位置或 global 位置手动注册代理、MCP 服务器和端点，并创建绑定。区域网关可以管理流量并将其路由到区域资源和 global MCP 服务器。
如需查看完整的区域范围界定规则和政策要求，请参阅代理注册表位置。
Model Context Protocol (MCP)
用于将 AI 模型连接到数据源和工具的开放标准，可取代定制插件。
MCP 服务器（或服务器）
一种实现 Model Context Protocol (MCP) 的服务，可为 AI 智能体提供标准化的工具和数据资源。
MCP 服务器标识符
MCP 服务器的全局唯一且不可变的统一资源名称 (URN)。与代理标识符类似，此 URN 可为发现特定工具集提供稳定的参考。
MCP 服务器标识符是用于注册表查找和清单管理的逻辑名称。如需了解详情，请参阅 MCP 服务器标识符。
注册
将智能体组件（例如代理、MCP 服务器或端点）添加到注册表的过程。Agent Registry 提供以下注册机制：
- 自动注册：自动提取受支持的Google Cloud AI 资源，例如在 Agent Runtime 中。自动注册在单个项目的范围内运行。
- 手动注册：手动载入自定义或外部智能体组件，或跨多个 Google Cloud 项目部署智能体，以实现集中发现和治理。
运行时参考
托管代理、MCP 服务器或端点的物理运行时位置或计算基础设施，在 Agent Registry API 中由 agentregistry.googleapis.com/system/RuntimeReference 属性表示。例如，运行时引用可以指向 Agent Runtime 推理引擎、GKE 部署或 Cloud Run 服务。
运行时引用路径嵌入在 智能体主体 中，用于 IAM 政策评估。如需了解详情，请参阅运行时参考。
服务
对于 Agent Registry API，用于将自定义或外部智能体组件手动注册到注册表中的可写入资源。Service 表示手动添加到注册表中的代理、MCP 服务器或端点。您可以创建和管理 Service 资源，以定义代理注册表不会自动注入的代理组件的端点和元数据。
根据您提供的规范，Agent Registry 会自动将此 Service 作为只读的 Agent、McpServer 或 Endpoint 资源投影到消费者端以供发现。
您始终使用 Service 资源来创建、修改或删除注册表条目。不过，如需获取、列出或搜索这些条目，您需要查询只读的 Agent、McpServer 或 Endpoint 资源。
技能
与 A2A 技能进行比较。
一种在代理注册表中注册为顶级资源的独立软件包，通过提供特定指令和可选脚本来扩展代理的功能，以完成任务。技能包含指令文件 (SKILL.md)、可选脚本和元数据资源。
技能由统一资源名称 (URN) 标识。确切的格式取决于发布商。示例如下：
- Google 创建的技能：
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID。 例如：urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing。 - 手动注册的技能：
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID。 例如：urn:skill:projects-123456789:locations:global:private-create-docs。
设置 Agent Registry 后，您会立即看到 Google 创建的技能。不过，您也可以注册自己的技能。 您可以在 Agent Registry 中将技能注册为智能体和 MCP 服务器的同级资源。每个技能都有一个默认修订版本，并且可以包含多个已纳入版本控制的技能修订版本。
平台管理员通过管理技能的生命周期状态和设置运行时解析的默认版本指针来管理技能。
技能修订版本
技能包的不可变版本化快照。借助修订版本，您可以更新技能指令或脚本，而无需更改父技能的标识符。
您可以管理技能修订版本，以便对技能进行版本控制。
Publisher
在 Agent Registry 中创建和注册技能的实体。
预填充的发布商包括 Google 发布商（例如 cloud.google.com 和 discoveryengine.googleapis.com）以及经过验证的合作伙伴。设置代理注册表后，您会立即看到这些发布商创建的 Google 技能。
您创建的技能会自动分配给默认的 private 发布商，因此特定技能的已发布 ID 会以 private- 为前缀。您无法注册自定义发布商资源。
查看和检查已注册技能的发布商详细信息。
工具
由 MCP 服务器提供的确定性函数，代理可以调用该函数。