本文档介绍了与代理注册表相关的关键术语和概念。
代理
AI 生态系统中的自主行动者，由其标识符和所拥有的特定技能定义。
代理标识符
代理的全局唯一且不可变名称。此逻辑标识符为使用方提供了一个稳定的参考来调用代理，无论底层基础架构如何变化，该标识符都保持不变。
代理标识符由代理注册表在注入期间自动生成，并遵循统一资源名称 (URN) 格式。确切的格式取决于代理的部署位置。示例如下：
- Gemini Enterprise Agent Platform 上的 Agent Runtime：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Cloud Run 服务：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - GKE 部署：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace：
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - 手动注册的代理：
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
代理正文
分配给代理的唯一 Identity and Access Management (IAM) 标识符，用于让代理持有权限并接受审核。它以可验证的 Google Cloud服务账号或受管理的 Workload Identity（例如绑定到代理或服务器的 SPIFFE ID）的形式呈现。
由于此身份直接绑定到代理运行时所用的计算资源，因此正文字符串包含该底层资源的精确路径。例如，Gemini Enterprise Agent Platform 部署中的 Agent Runtime 的代理正文如下所示：
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
当您查看代理的详细信息时，代理注册表会将此身份显示为仅输出属性。
代理组件
AI 生态系统中的模块化功能实体，Agent Registry 可让您注册、发现和管理此类实体。注册表将智能体组件分为三种主要类型：智能体、MCP 服务器和端点。
智能体工作流
一个步骤序列，其中 AI 智能体可独立确定工具使用情况、推理和执行路径，以完成任务。
授权提供方
代理身份验证管理器中的一种配置，用于存储、获取和管理凭据（例如 API 密钥或 OAuth 令牌），以便将代理连接到特定的外部工具和应用，并定义身份验证类型。
绑定
源代理与目标资源（例如另一个代理、MCP 服务器或端点）之间的连接。通过创建绑定，您可以建立明确的关系，让编排器代理与下游功能进行交互。绑定还用于将代理与身份验证提供方相关联，以支持委托权限。
数据资源
MCP 服务器公开的特定数据情境或数据集，代理可以访问这些数据情境或数据集，以便根据这些数据情境或数据集生成回答或采取行动。
发现
根据说明、标记或技能查询注册表以查找现有代理、MCP 工具或端点的过程。
代理注册表中的发现功能侧重于 AI 编排器可使用的以消费为中心的功能。您可以发现已注册的功能，以构建和编排 AI 系统。
代理注册表中的此流程与基础设施发现（例如 App Hub 中的基础设施发现）不同，后者用于识别 Google Cloud 项目中的未注册计算资源。
端点
对于 Agent Registry API，一种表示目标网址（通常是 REST API）的资源，由代理访问。通过将这些目的地抽象为可管理的资源，代理注册表可让您集中管理代理可以访问哪些外部服务。
Model Context Protocol (MCP)
用于将 AI 模型连接到数据源和工具的开放标准，可取代定制插件。
MCP 服务器（或服务器）
一种实现 Model Context Protocol (MCP) 的服务，可为 AI 智能体 提供标准化的工具和数据资源。
MCP 服务器标识符
MCP 服务器的全局唯一且不可变的统一资源名称 (URN)。与代理标识符类似，此名称可提供稳定的参考，用于发现特定的工具集。
格式取决于它是内置 Google 服务还是已注册的外部服务器。示例如下：
- Google Cloud 远程 MCP 服务器：
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - 手动注册的 MCP 服务器：
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
注册
将智能体组件（例如代理、MCP 服务器或端点）添加到注册表的过程。代理注册表提供以下注册机制：
- 自动注册：自动提取受支持的 Google Cloud AI 资源，例如在 Agent Runtime 中。
- 手动注册：手动载入自定义或外部代理组件。
资源 URI
托管代理或 MCP 服务器的物理运行时位置或基础设施。统一资源标识符 (URI) 是用于标识此运行时资源的唯一字符序列。例如，资源 URI 可以是 Agent Runtime 端点、Google Kubernetes Engine (GKE) 部署或 Cloud Run 服务。
资源 URI 不同于代理标识符或 MCP 服务器标识符。这些值是 URN 格式的唯一名称，用于在注册表中标识您的代理和 MCP 服务器。相比之下，资源 URI 指向代理或服务器运行的实际计算资源。
代理的资源 URI 的路径嵌入在 agent principal 字符串中，以便在 IAM 政策中唯一标识该资源。
当您查看代理的详细信息时，代理注册表会将此 URI 显示为仅输出属性。
您可以使用资源 URI 在拓扑图中构建查询，以直观呈现特定代理的流量流和关系。在代理注册 API 中，此值由 agentregistry.googleapis.com/system/RuntimeReference 属性表示。
服务
对于代理注册表 API，用于将自定义或外部智能体组件手动注册到注册表中的可写入资源。Service 表示手动添加到注册表中的代理、MCP 服务器或端点。您可以创建和管理 Service 资源，以定义代理注册中心不会自动注入的智能体组件的端点和元数据。
根据您提供的规范，代理注册表会自动将此 Service 投影到消费者端，作为只读 Agent、McpServer 或 Endpoint 资源以供发现。
您始终使用 Service 资源来创建、修改或删除注册表条目。不过，如需获取、列出或搜索这些条目，您需要查询只读的 Agent、McpServer 或 Endpoint 资源。
技能
A2A 代理所具备的高级功能。技能是从 A2A 智能体卡片中提取的，是智能体发现的主要数据点。
工具
由 MCP 服务器提供的确定性函数，代理可以调用该函数。