本文档介绍了与 Agent Registry 相关的关键术语和概念。
A2A 技能
与技能进行比较。
在代理的
智能体卡片
(agent-card.json)中以内联方式表示的声明性功能元数据块。A2A 技能描述了代理间通信接口
以及符合 A2A 标准的代理所拥有的高级功能。
Agent Registry 支持 Agent2Agent (A2A) 规范的版本 0.3 和 1.0。
代理
AI 生态系统中的自主执行者，由其 标识符以及它拥有的特定 A2A 技能 或 技能定义。
代理标识符
代理的全局唯一且不可变的名称。此逻辑标识符为使用方提供了一个稳定的引用来调用代理，无论底层基础架构如何更改，该引用都保持不变。
代理标识符由 Agent Registry 在提取期间自动生成，并遵循统一资源名称 (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 服务账号或受管工作负载身份（例如 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
当您 查看代理的详细信息时，Agent Registry 会将此身份显示为仅输出属性。
Agentic 组件
AI 生态系统中的模块化功能实体，Agent Registry 可让您注册、发现和管理这些实体。注册表将 Agentic 组件 分为四种主要类型：代理、MCP 服务器、 端点和技能。
Agentic 工作流
一系列步骤，其中 AI 智能体独立确定工具使用、推理和执行路径以完成任务。
授权提供方
Agent Identity Auth Manager 中的配置，用于存储、获取和管理凭据（例如 API 密钥或 OAuth 令牌），以便 将代理连接到特定的外部工具和应用，并定义 身份验证类型。
绑定
源 代理 与目标资源（例如 另一个代理、MCP 服务器或端点）之间的连接。通过创建绑定，您可以建立明确的关系，让编排器代理与下游功能进行交互。绑定还用于将代理与授权提供方相关联，以支持委托权限。
数据资源
MCP 服务器公开的特定数据上下文或数据集， 代理可以访问这些数据来支持其响应或告知其操作。
发现
查询注册表以根据说明、标签或 技能查找现有代理、MCP 工具或端点的过程。
Agent Registry 中的发现侧重于 AI 编排器可以使用的以使用为中心的功能。您可以发现已注册的功能，以构建和编排 AI 系统。
Agent Registry 中的此过程与基础架构发现（例如 App Hub 中的基础架构发现）不同，后者用于识别 Google Cloud 项目中的未注册 计算资源。
端点
对于 Agent Registry API，端点是一种资源，表示代理访问的目标网址（通常是 REST API）。通过将这些目标抽象为可管理的资源，Agent Registry 可让您集中管理代理可以访问哪些外部服务。
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
注册
将 Agentic 组件（例如 代理、MCP 服务器或端点）添加到注册表的过程。Agent Registry 提供以下注册机制：
- 自动注册：自动提取受支持的 Google Cloud AI 资源，例如 Agent Runtime 中的 AI 资源。
- 手动注册：手动添加自定义或外部 Agentic 组件。
资源 URI
托管 代理 或 MCP 服务器的物理运行时位置或基础架构。统一资源标识符 (URI) 是标识此运行时资源的唯一字符序列。例如，资源 URI 可以是 Agent Runtime 端点、Google Kubernetes Engine (GKE) 部署或 Cloud Run 服务。
资源 URI 不同于 代理标识符 或 MCP 服务器标识符。这些值是 URN 格式的唯一名称，用于在注册表中标识您的代理和 MCP 服务器。 相比之下，资源 URI 指向代理或服务器运行的实际计算资源。
代理的资源 URI 的路径嵌入在 代理 正文 字符串中，以便在 IAM 政策中唯一标识该资源。
当您 查看代理的详细信息时，Agent Registry 会将此 URI 显示为仅输出属性。
您可以使用资源 URI 在 拓扑
图表 中构建查询，以
直观呈现特定代理的流量流和关系。在 Agent Registry API 中，此值由 agentregistry.googleapis.com/system/RuntimeReference 属性表示。
服务
对于 Agent Registry API，服务是可写资源，用于将自定义或
外部 Agentic 组件手动注册到注册表中。Service 表示手动添加到注册表的代理、MCP 服务器或端点。您可以创建和管理 Service 资源，以定义 Agent Registry 不会自动注入的 Agentic 组件的端点和元数据。
根据您提供的规范，Agent Registry 会自动将此 Service 投影到使用方端，作为只读 Agent、McpServer 或 Endpoint 资源以供发现。
您始终使用 Service 资源来创建、修改或删除注册表条目。但是，如需获取、列出或搜索这些条目，您可以查询只读 Agent、McpServer 或 Endpoint 资源。
技能
与 A2A 技能进行比较。
在
Agent Registry 中注册为顶级资源的独立可执行软件包，通过
提供特定说明、自然语言或代码来完成任务，从而扩展 代理 的功能。
技能包含说明文件 (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 服务器的同级资源。每个技能都有一个默认修订版本，并且可以包含 多个版本化的 技能修订版本。
平台管理员通过 管理技能的生命周期状态和 设置默认版本指针来管理技能，以进行运行时 解析。
技能修订版本
技能软件包的不可变版本化快照。通过修订版本，您可以更新技能说明或代码，而无需更改父级技能的标识符。
您可以管理技能修订版本，以实现对技能的版本 控制。
发布者
在 Agent Registry 中创建和注册 技能 的实体。
预填充的发布者包括 Google 发布者（例如 cloud.google.com 和 discoveryengine.googleapis.com）以及经过验证的合作伙伴。设置 Agent Registry 后，这些发布者创建的 Google 技能会立即显示。
您创建的技能会自动分配给默认的 private
发布者，因此特定技能的已发布 ID 会以
private- 为前缀。您无法注册自定义发布者资源。
查看和检查发布者详细信息已注册 技能。
工具
MCP 服务器提供的确定性函数，代理可以 调用该函数。