本文档介绍了与 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 会将此身份显示为仅输出属性。
智能体组件
AI 生态系统中的模块化功能实体，Agent Registry 可让您注册、发现和治理这些实体。注册表将智能体组件 分为四种主要类型：智能体、MCP 服务器、 端点和技能。
智能体工作流
一系列步骤，其中 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
注册
将 智能体组件（例如 智能体、MCP 服务器或端点）添加到注册表的过程。Agent Registry 提供以下注册机制：
- 自动注册：自动提取受支持的 Google Cloud AI 资源，例如 Agent Runtime 中的 AI 资源。自动注册在单个项目的范围内运行。
- 手动注册：手动添加自定义或外部智能体 组件，或跨多个 Google Cloud 项目 部署的智能体，以便集中发现和治理。
资源 URI
托管 智能体 或 MCP 服务器 的物理运行时位置或基础架构。统一资源标识符 (URI) 是用于标识此运行时资源的唯一字符序列。例如，资源 URI 可以是 Agent Runtime 端点、Google Kubernetes Engine (GKE) 部署或 Cloud Run 服务。
资源 URI 不同于 智能体标识符 或 MCP 服务器标识符。这些值是 URN 格式的唯一名称，用于在注册表中标识您的智能体和 MCP 服务器。 相比之下，资源 URI 指向智能体或服务器实际运行的计算资源。
智能体的资源 URI 的路径嵌入在 智能体主账号字符串中，以便在 IAM 政策中唯一标识该资源。对于跨项目的 注册， 资源 URI 引用计算资源所在的项目。
当您 查看智能体的详细信息时，Agent Registry 会将此 URI 显示为仅输出属性。
您可以使用资源 URI 在 拓扑
图表 中构建查询，以
直观呈现特定智能体的流量流和关系。在 Agent Registry API 中，此值由 agentregistry.googleapis.com/system/RuntimeReference 属性表示。
服务
对于 Agent Registry API，一种可写资源，用于将自定义或
外部 智能体组件手动注册到注册表中。Service 表示手动添加到注册表中的智能体、MCP 服务器或端点。您可以创建和管理 Service 资源，以定义 Agent Registry 不会自动注入的智能体组件的端点和元数据。
根据您提供的规范，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 服务器提供的确定性函数，智能体可以 调用该函数。