概念和术语
即将进行的命名空间迁移
AWS Agent Registry 目前在 bedrock-agentcore 命名空间下处于公开预览状态。从 2026 年 8 月 6 日起,该服务将移至代理注册表命名空间。如果您使用 AWS 代理注册表,则必须更新您的终端节点、IAM 策略、SDK 客户端、CLI 脚本和注册表数据。有关从公共预览版迁移的更多信息,请参阅注册表迁移综合指南。
注册表
注册表是您在 AWS 账户中创建的用于组织和管理资源的集中目录。每个注册表都有名称、描述、控制消费者如何访问搜索和 MCP API 的授权配置,以及用于确定记录在被发现之前是否需要手动审查的批准配置。
如何组织注册表取决于您的需求,例如,用于不同资源类型(代理注册表、MCP 服务器注册表、技能注册表)的专用注册表、用于不同开发阶段(生产、质量保证、开发)的注册表、适用于不同团队或业务部门的独立注册表,或者整个组织的单个注册表。
注册记录
注册表记录表示发布到注册表中的单个资源的元数据。每条记录都捕获描述底层资源的关键元数据,提供有关其内容、作用以及如何找到基础资源的信息。记录具有名称、可选描述、版本、类型和特定于资源类型的元数据。
资源类型
MCP 服务器 — 模型上下文协议 (MCP) 服务器提供 AI 代理可以发现和调用的工具。MCP 服务器记录包含服务器定义,该定义描述了服务器的配置和服务器提供的所有工具的工具定义,包括其输入参数和输出格式。 AWS 代理注册表根据 MCP 协议架构验证 MCP
代理-代理是自治程序,可以推理、计划和采取行动来完成任务。座席记录包含一张代理卡,该卡片根据 A2A (Agent-to-Agent)
技能-技能是可重复使用的能力,可以在代理之间共享。技能记录包含基本描述符元数据,例如名称、描述、Package 或 Repository 详细信息等可选访问信息,以及描述技能用途和使用方法的可选 markdown 文档。
自定义资源-对于不符合上述标准类型的资源,您可以使用任何有效的 JSON 结构定义自己的元数据架构。
凭证提供者
将注册表记录配置为同步来自外部来源的元数据(出站授权)时, AWS Agent Registry 需要凭据才能访问该源。凭证提供商存储授权详细信息(OAuth 证书或 IAM 角色), AWS 代理注册表在同步期间使用这些信息来调用外部资源的终端节点。在记录上配置同步时,您可以通过凭证提供者的 ARN 来引用凭证提供商。有关更多信息,请参阅管理凭证提供商。
注册表授权有两种类型-
-
入站授权:此配置使注册表管理员能够控制使用者搜索注册表的方式(通过 AWS CLI、 AWS SDK 或调用 MCP 端点)。注册表支持基于 IAM 和基于 JWT 的入站授权。注册表管理员将其指定为创建注册表工作流程的一部分。
-
出站授权:作为将 MCP 和 A2A 记录与其远程端点同步(用于设置同步的记录)的一部分,注册表需要出站凭据才能在指定端点调用远程资源并检索元数据。发布者在为特定注册表记录设置同步任务时会提供这些凭据。
关键角色
使用注册表的角色可能因组织而异。但是,我们已经看到了以下与注册表互动的一般角色,这些角色在各组织中都很常见。
- 管理员
-
管理员是注册表基础结构的所有者。他们负责在 AWS 账户内创建和配置注册表,决定每个注册表的组织方式(按团队、环境或资源类型),并选择决定消费者如何访问注册表的授权方法(IAM 或 JWT)。管理员设置批准工作流程(决定记录是需要手动审核还是自动批准),并配置 Amazon EventBridge 集成以将注册表连接到组织现有的通知和审查系统。他们管理 IAM 权限以控制哪些发布者、策展人和消费者可以访问每个注册表。由于他们是管理员,因此他们还拥有创建、更新和删除记录的完全访问权限,并且可以在需要时批准、拒绝或弃用记录。
- 出版商
-
发布者是组织内部的构建者,他创建了资源(MCP 服务器、代理、技能或其他工具),并希望让其他人可以发现这些资源。出版商创建描述其资源的注册表记录,提供元数据、定义和版本信息,以帮助其他人找到和理解该资源的用途。他们迭代处于 “草稿” 状态的记录,完善描述和架构,直到记录准备就绪,然后将其提交审批。如果记录被拒绝,出版商将审查策展人的反馈,进行必要的更改,然后重新提交。发布者还可以配置 URL-based 同步,使其记录与实时 MCP 服务器保持同步,无需手动更新。
- 策展人/审批人
-
策展人是注册处的高素质看门人,通常也可以是注册处的管理员。他们负责审查出版商提交审批的记录,根据组织的安全性、合规性、元数据完整性标准以及组织定义的任何其他标准对每份记录进行评估。策展人批准符合这些标准的记录,使其在搜索结果中和通过 MCP 端点可见,并拒绝不符合这些标准的记录,从而就需要修复的内容提供明确的反馈。当资源停用、存在已知问题或被新版本取代时,策展人会弃用该记录以将其从发现中删除。策展人确保注册表仍然是一个值得信赖的高质量目录,整个组织的建设者都可以信赖。
- 使用者
-
消费者是任何需要寻找和使用资源的人,无论是人类还是代理人。消费者使用自然语言查询或关键字查询来搜索注册表,以发现 MCP 服务器、代理、技能以及其他已批准和发布的资源。他们还可以使用任何 MCP-compatible 客户端连接到注册表的 MCP 端点,以编程方式发现可用的工具。消费者只能看到经批准的记录,因此他们可以相信他们在注册表中找到的所有内容都经过审查并符合组织的质量标准。消费者可以通过 IAM 凭证或企业身份提供商的 JWT 令牌进行授权,具体取决于注册表的配置方式。