View a markdown version of this page

Ciclo di vita dei record - Fondamento Amazon AgentCore

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ciclo di vita dei record

La migrazione è ora aperta

AWS Agent Registry è stato lanciato con il nuovo agent-registry namespace. Il supporto per il bedrock-agentcore namespace di anteprima pubblico verrà interrotto il 17 settembre 2026. Per le istruzioni sulla migrazione, consulta la Guida completa alla migrazione del registro.

Transizioni di stato

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

Dettagli sulla transizione

  • Crea → BOZZA. Modifica liberamente prima di inviarlo.

  • Invia → PENDING_APPROVAL. Auto-approval passa a APPROVED. EventBridge Notifica Amazon inviata.

  • Approve/Reject→ Il curatore utilizza UpdateRegistryRecordStatus. Può approvare direttamente un record REJECTED.

  • Deprecate → Terminal da qualsiasi stato. Non può essere annullato.

In che modo le modifiche influiscono sullo stato

Stato attuale Effetto della modifica

BOZZA

Aggiornato sul posto. Rimane DRAFT.

PENDING_APPROVAL

Nuova revisione della BOZZA. La revisione in sospeso è stata scartata. Non visibile tramite le API di rilevamento o l'endpoint MCP (mai approvato).

APPROVED (APPROVATO)

Nuova revisione della BOZZA. La revisione approvata rimane rilevabile fino all'approvazione della nuova revisione.

REJECTED

Nuova revisione DRAFT. Deve ripetere il normale flusso di invio e approvazione.

OBSOLETO

I record obsoleti non possono essere modificati; Deprecato è uno stato del terminale

Nota

Per nascondere temporaneamente un record approvato dal rilevamento senza renderlo obsoleto, rifiutate il record. I record rifiutati non vengono restituiti dalle API di rilevamento o dall'endpoint MCP. Se desideri rendere nuovamente rilevabile il record, modificalo e riapprovalo per creare una nuova revisione approvata.

Dual-revision comportamento

La modifica di un record APPROVED crea una nuova revisione DRAFT mentre la revisione approvata rimane attiva:

  • Discovery APIs (SearchDiscoverableRegistryRecords,ListDiscoverableRegistryRecords,BatchGetDiscoverableRegistryRecord) e MCP endpoint (InvokeRegistryMcp): restituiscono la revisione approvata.

  • API di gestione (GetRegistryRecord,ListRegistryRecords): restituiscono la revisione più recente (che può essere DRAFT).

Una volta che un curatore ha esaminato e approvato la revisione modificata, le API di scoperta e l'endpoint MCP iniziano a mostrare la nuova revisione (approvata).

Regole di visibilità

"Hello, World!" Valori restituiti

SearchDiscoverableRegistryRecords

Solo revisioni approvate

ListDiscoverableRegistryRecords

Solo revisioni approvate

GetDiscoverableRegistryRecord

Solo revisioni approvate

BatchGetDiscoverableRegistryRecord

Solo revisioni approvate

InvokeRegistryMcp

Solo revisioni approvate

GetRegistryRecord

Revisione più recente (qualsiasi stato)

ListRegistryRecords

Revisione più recente (qualsiasi stato)

Nota

SearchDiscoverableRegistryRecordsè stato nominato SearchRegistryRecords nel bedrock-agentcore namespace. Le BatchGetDiscoverableRegistryRecord API ListDiscoverableRegistryRecords e sono disponibili solo nel namespace. agent-registry