View a markdown version of this page

记录生命周期 - 亚马逊基岩 AgentCore
状态转换过渡细节编辑如何影响状态Dual-revision 行为可见性规则

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

记录生命周期

迁移现已开放

AWS 代理注册表已在新agent-registry命名空间下启动。对公共预览bedrock-agentcore命名空间的支持将于 2026 年 9 月 17 日停止。有关迁移说明，请参阅综合注册表迁移指南。

状态转换

Create → DRAFT → Submit → PENDING_APPROVAL → Approve → APPROVED
                               │                          │
                               │ Reject                   │ Edit (new DRAFT
                               ▼                          │  revision; approved
                          REJECTED ── Approve (direct) ───┘  stays discoverable)
                               │
                               └── Edit → DRAFT

         Any status → DEPRECATED (terminal)

过渡细节

  • 创建 → 草稿。提交前可自由编辑。

  • 提交 → 待批准。 Auto-approval 跳至 “已批准”。亚马逊 EventBridge 通知已发送。

  • Approve/Reject→ 策展人使用 UpdateRegistryRecordStatus。可以直接批准被拒绝的记录。

  • 在任何状态下弃用 → 终端。无法撤消。

编辑如何影响状态

当前状态 编辑的效果

草稿

已更新到位。保持草稿状态。

待批准

新的修订草案。待修订已丢弃。通过发现 API 或 MCP 端点不可见（从未获得批准）。

APPROVED

新的修订草案。在新版本获得批准之前，已批准的修订版本将保持可被发现状态。

REJECTED

新的修订草案。必须再次通过正常的提交和批准流程。

DEPRECATED

无法编辑已过时的记录；“已弃用” 是终端状态
注意

要在不弃用的情况下暂时隐藏已批准的记录以使其不被发现，请拒绝该记录。发现 API 或 MCP 端点不会返回被拒绝的记录。当您想再次使记录可被发现时，请对其进行编辑并重新批准以创建新的已批准修订版本。

Dual-revision 行为

编辑 “已批准” 记录会创建新的草稿修订版本，而批准的修订版本仍处于活动状态：

  • 发现 API (SearchDiscoverableRegistryRecords、ListDiscoverableRegistryRecords、BatchGetDiscoverableRegistryRecord) 和 MCP 端点 (InvokeRegistryMcp) — 返回批准的修订版。

  • 管理 API (GetRegistryRecord,ListRegistryRecords) — 返回最新版本（可能是草稿）。

策展人审查并批准编辑后的修订版后，发现API和MCP终端将开始显示新的（已批准的）修订版。

可见性规则

API 返回值

SearchDiscoverableRegistryRecords

仅限经批准的修订

ListDiscoverableRegistryRecords

仅限经批准的修订

GetDiscoverableRegistryRecord

仅限经批准的修订

BatchGetDiscoverableRegistryRecord

仅限经批准的修订

InvokeRegistryMcp

仅限经批准的修订

GetRegistryRecord

最新版本（任何状态）

ListRegistryRecords

最新版本（任何状态）
注意

SearchDiscoverableRegistryRecords是在命名bedrock-agentcore空间SearchRegistryRecords中命名的。ListDiscoverableRegistryRecords和 BatchGetDiscoverableRegistryRecord API 仅在agent-registry命名空间中可用。