本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 概念和术语
<a name="registry-concepts"></a>

**迁移现已开放**  
 Amazon 代理注册表已在新`agent-registry`命名空间下启动。2026 年 10 月 30 日将停止对公共预览版`bedrock-agentcore`命名空间的支持。有关迁移说明，请参阅[注册表迁移综合指南](registry-faq.md)。

## 注册表
<a name="registry-concept-registry"></a>

注册表是您在 Amazon 账户中创建的用于组织和管理资源的集中目录。每个注册表都有名称、描述、控制消费者如何访问可发现的数据平面 API 和 MCP 端点的授权配置，以及用于确定记录在可发现之前是否需要手动审查的批准配置。

如何组织注册表取决于您的需求，例如，用于不同资源类型（代理注册表、MCP 服务器注册表、技能注册表）的专用注册表、用于不同开发阶段（生产、质量保证、开发）的注册表、适用于不同团队或业务部门的独立注册表，或者整个组织的单个注册表。

## 注册记录
<a name="registry-concept-record"></a>

注册表记录表示发布到注册表中的单个资源的元数据。每条记录都捕获描述底层资源的关键元数据，提供有关其内容、作用以及如何找到基础资源的信息。记录有 a `name`、可选的人类可读`displayName`、可选的描述、a `recordVersion`、a `recordType` (`AGENT`、`MCP``SKILL`、或`CUSTOM`) 以及承载实际内容的特定于资源类型的描述符。`name`和的组合在注册表中`recordVersion`必须是唯一的（用作重复数据删除密钥），因此`name`可以在同一资源的不同版本中重复使用相同的组合。

## 资源类型
<a name="registry-concept-resource-types"></a>

 **MCP 服务器** — 模型上下文协议 (MCP) 服务器提供 AI 代理可以发现和调用的工具。MCP 服务器记录包含服务器定义，该定义描述了服务器的配置和服务器提供的所有工具的工具定义，包括其输入参数和输出格式。 Amazon 代理注册表根据 MCP [协议架构验证 MCP](https://modelcontextprotocol.io/docs/getting-started/intro) 服务器记录，以确保正确性。

 **代理**-代理是自治程序，可以推理、计划和采取行动来完成任务。座席记录包含一张代理卡，该卡片根据 A2A [(Agent-to-Agent)](https://a2a-protocol.org/latest/) 协议规范描述代理的能力、技能和通信接口。 Amazon 代理注册表根据 A2A 协议架构验证代理记录，以确保正确性。

 **技能**-技能是可重复使用的能力，可以在代理之间共享。技能记录包含基本描述符元数据，例如名称、描述、Package 或 Repository 详细信息等可选访问信息，以及描述技能用途和使用方法的可选 markdown 文档。

 **自定义资源**-对于不符合上述标准类型的资源，您可以使用任何有效的 JSON 结构定义自己的元数据架构。

## 凭证提供者
<a name="registry-concept-credential-provider"></a>

将注册表记录配置为同步来自外部来源的元数据（出站授权）时， Amazon Agent Registry 需要凭据才能访问该源。凭证提供商存储授权详细信息（OAuth 证书或 IAM 角色）， Amazon 代理注册表在同步期间使用这些信息来调用外部资源的终端节点。在记录上配置同步时，您可以通过凭证提供者的 ARN 来引用凭证提供商。有关更多信息，请参阅[管理凭证提供商](https://docs.amazonaws.cn/bedrock-agentcore/latest/devguide/identity-outbound-credential-provider.html)。

注册表授权有两种类型：

1.  **入站授权**：使用此配置控制用户如何搜索、浏览和调用注册表的可发现数据平面 API 和 MCP 端点（通过 CL Amazon I、 Amazon SDK 或客户端 MCP-compatible ）。注册表支持 IAM-based 和 JWT-based 入站授权。您可以在创建注册表的工作流程中指定入站授权。

1.  **出站授权**：配置与远程 MCP 或 A2A 端点同步的记录时，注册表需要出站凭据才能在指定端点调用远程资源并检索元数据。在为特定注册表记录设置同步作业时，您需要提供这些凭据。

## 标签
<a name="registry-concept-tags"></a>

您可以将标签附加到注册表和注册表记录，以进行成本分配、访问控制和组织跟踪。每个标签都是一个键值对，键和值都是您定义的字符串。标签不会影响注册表或记录的运行时行为，它们以元数据形式存在，您和您的组织可以使用这些元数据对 Amazon 账户中的资源进行分类。

## 关键人物
<a name="registry-concept-personas"></a>

使用注册表的角色可能因组织而异。但是，我们已经看到了以下与注册表互动的一般角色，这些角色在各组织中都很常见。

 **管理员**   
作为管理员，您拥有注册表基础架构。您可以在 Amazon 账户中创建和配置注册表，决定每个注册表的组织方式（按团队、环境或资源类型），并选择决定使用者如何访问注册表的授权方法（IAM 或 JWT）。您可以设置批准工作流程（决定记录是需要手动审核还是需要自动批准），并配置 Amazon EventBridge 集成以将注册表连接到您组织的现有通知和审查系统。您可以管理 IAM 权限以控制哪些发布者、策展人和消费者可以访问每个注册表。作为管理员，您还拥有创建、更新和删除记录的完全访问权限，并且可以在需要时批准、拒绝或弃用记录。

 **出版商**   
作为发布者，你是组织中的建设者，他创建了资源（MCP 服务器、代理、技能或其他工具），并希望让其他人可以发现这些资源。您可以创建描述您的资源的注册表记录，提供元数据、定义和版本信息，以帮助其他人查找和理解该资源的用途。您可以迭代处于 “草稿” 状态的记录，完善描述和架构，直到记录准备就绪，然后将其提交审批。如果记录被拒绝，您可以查看策展人的反馈，进行必要的更改，然后重新提交。您还可以配置 URL-based 同步，以便您的记录与实时 MCP 服务器保持同步，无需手动更新。

 **策展人/审批人**   
作为策展人，您是注册表的优质看门人，通常也可以是注册表的管理员。您可以查看出版商提交审批的记录，根据贵组织的安全性、合规性、元数据完整性标准以及组织定义的任何其他标准对每条记录进行评估。您可以批准符合这些标准的记录（通过可发现的数据平面 API（搜索、列表、批量获取）和 MCP 端点显示这些记录，并拒绝不符合这些标准的记录，从而就需要修复的内容提供明确的反馈。当资源已停用、存在已知问题或被新版本取代时，您可以弃用该记录以将其从发现中删除。作为策展人，你可以帮助注册表保持一个值得信赖的高质量目录，整个组织的建设者都可以信赖。

 **使用者**   
作为消费者，你是一个需要寻找和使用资源的人或代理人。您可以通过三种方式发现已批准的记录：  
+  使用自然语言查询或关键字查询进行@@ **搜索**，以查找与主题、功能或用例 (`SearchDiscoverableRegistryRecords`) 匹配的记录。
+  使用分页列表@@ **浏览**已批准记录的目录，可以选择按记录类型进行筛选，并一次检索一条或多条记录的详细信息（`ListDiscoverableRegistryRecords`和`GetDiscoverableRegistryRecord`/`BatchGetDiscoverableRegistryRecord`）。
+  从任何 MCP-compatible 客户端@@ **连接到**注册表的 MCP 端点，以编程方式发现可用的工具 () `InvokeRegistryMcp`。

  作为消费者，您只能看到经批准的记录，因此您可以相信您在注册表中找到的所有内容都经过审查并符合组织的质量标准。您可以通过 IAM 凭证或企业身份提供商的 JWT 令牌进行授权，具体取决于注册表的配置方式。