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à.
Guida completa alla migrazione del registro
AWS Agent Registry: migrazione al nuovo agent-registry namespace
Introduzione
Come parte del lancio del nuovo agent-registry namespace il 6 agosto 2026, AWS Agent Registry introdurrà modifiche significative al principio del servizio, ai dati e al modello API. Se hai utilizzato AWS Agent Registry nel bedrock-agentcore namespace, devi completare una migrazione che abbraccia tre aree:
-
Modifiche allo spazio dei nomi e alla configurazione: stiamo spostando l' AWS Agent Registry dal namespace AWS Bedrock al proprio AgentCore namespace dedicato. Questa modifica allo spazio dei nomi si applica solo all'Agent Registry. AWS Tutte le altre AgentCore offerte, come Identity, Gateway, Runtime e Policy, rimangono inalterate. Per AWS Agent Registry, lo spazio dei nomi del servizio cambia da a.
bedrock-agentcoreagent-registryCiò influisce su ogni superficie che fa riferimento al servizio: endpoint, policy IAM, client SDK, comandi CLI, ARN di risorse e integrazioni di osservabilità. È necessario aggiornare il codice e l'infrastruttura per utilizzare il nuovo namespace. -
Modifiche allo schema API: i modelli di dati del registro e dei record di registro vengono aggiornati in base al feedback dei clienti proveniente dal
bedrock-agentcorenamespace. Queste modifiche interrompono la compatibilità con le versioni precedenti degli schemi API esistenti. Il codice dell'applicazione che costruisce o analizza le richieste e le risposte API deve essere aggiornato per riflettere il nuovo schema, come parte della migrazione al nuovo namespace. -
Migrazione dei dati: è necessario migrare i registri e i record di registro esistenti dal vecchio namespace a quello nuovo. Forniamo strumenti di migrazione per estrarre i dati, trasformarli nel nuovo schema e caricarli nel nuovo namespace. I dati vengono migrati nello stesso account e nella stessa area geografica: cambia solo il namespace.
Questa guida descrive ogni area in dettaglio con esempi precedenti e successivi per aiutarti a pianificare ed eseguire la migrazione.
Qual è la tempistica della migrazione?
Ci sono due tappe importanti da ricordare per questa migrazione:
-
6 agosto 2026 — Viene lanciato ufficialmente il nuovo
agent-registrynamespace per AWS Agent Registry. Accedere al servizio nella console dell'Agent Registry. AWSSe disponi di registri e record esistenti, hai accesso simultaneo ai namespace e ai namespace. bedrock-agentcoreagent-registryGli strumenti di migrazione diventano disponibili nel repository agentcore-samples sul sito Web. https://github.com/awslabs/agentcore-samples/tree/main/01-features/07-centralize-and-govern-your-ai-infrastructure/03-registry/04-migrate-to-new-namespaceGitHub È possibile iniziare il processo di migrazione. Nota
Se sei un nuovo cliente senza registri o record esistenti al 6 agosto 2026, non puoi accedere al registro degli AWS agenti tramite il namespace.
bedrock-agentcoreInizia a utilizzare AWS Agent Registry direttamente dal namespace.agent-registry -
17 settembre 2026: la finestra di migrazione si chiude. Il vecchio
bedrock-agentcorenamespace viene chiuso in questa data. Si perde read/write l'accesso al servizio e a tutti i dati rimanenti nel vecchio namespace. Dopo questa data, è necessario utilizzare ilagent-registrynamespace.
Modifiche allo spazio dei nomi e alla configurazione
Il agent-registry namespace viene sostituito nei seguenti puntibedrock-agentcore. Questa sezione elenca tutte le superfici che vengono modificate e fornisce esempi su come aggiornare il codice.
Importante
Le modifiche allo spazio dei nomi riguardano solo le API offerte da AWS Agent Registry, ma non il resto di AWS Bedrock AgentCore, come Identity. AWS AgentCore Pertanto, le risorse relative all'identità del carico di lavoro e ai provider di credenziali OAuth rimangono nel namespace. bedrock-agentcore
Endpoint di servizio
Le applicazioni devono puntare ai nuovi nomi host degli endpoint. I nuovi endpoint utilizzano il dominio. .api.aws
| Surface (Superficie) | Valore precedente | Nuovo valore |
|---|---|---|
|
Endpoint del piano dati |
|
|
|
Punto finale del piano di controllo |
|
|
IAM e sicurezza
Tutte le politiche IAM, le politiche di controllo dei servizi (SCP) e i limiti di autorizzazione a cui si fa riferimento bedrock-agentcore devono essere aggiornati. Gli ARN delle risorse cambiano anche per riflettere il nuovo namespace.
| Surface (Superficie) | Valore precedente | Nuovo valore |
|---|---|---|
|
Prefisso dell'azione IAM |
|
|
|
Principale del servizio |
|
|
|
ARN del registro |
|
|
|
Registra ARN |
|
|
Se disponi di un'automazione che analizza gli ARN o li memorizza, aggiorna anche quei riferimenti. Le policy personalizzate con condizioni sul prefisso dell'azione IAM o sull'entità del servizio devono essere aggiornate in modo che corrispondano ai nuovi valori. Per visualizzare l'elenco completo delle autorizzazioni IAM associate all' AWS Agent Registry, consulta il riferimento alle autorizzazioni IAM dell'AWS Agent Registry.
Nota
Se attualmente utilizzi la BedrockAgentCoreFullAccess AWS Managed Policy per l'accesso all' AWS Agent Registry (vedi i dettagli della BedrockAgentCoreFullAccess policy), devi sostituirla con la nuova policy AgentRegistryFullAccess gestita (disponibile il 6 agosto 2026). La vecchia politica BedrockAgentCoreFullAccess gestita NON verrà aggiornata per includere le agent-registry:* autorizzazioni.
SDK, CLI e infrastruttura
Aggiorna il codice dell'applicazione, gli script di distribuzione e i modelli infrastructure-as-code per fare riferimento alla nuova classe client e allo spazio dei nomi CLI.
| Surface (Superficie) | Valore precedente | Nuovo valore |
|---|---|---|
|
Classe client Dataplane SDK |
|
|
|
Classe client Controlplane SDK |
|
|
|
Namespace CLI |
|
|
|
Codice Service Quotas |
|
|
Se in precedenza hai richiesto aumenti personalizzati delle quote con il codice bedrock-agentcore di servizio, devi richiederli nuovamente in. agent-registry
Osservabilità ed eventi
Aggiorna tutte le query su CloudTrail Lake, le query Athena, le integrazioni SIEM, le EventBridge regole, i CloudWatch dashboard e gli allarmi che fanno riferimento al vecchio namespace.
| Surface (Superficie) | Valore vecchio | Nuovo valore |
|---|---|---|
|
CloudTrail fonte dell'evento |
|
|
|
EventBridge fonte |
|
|
|
CloudWatch namespace |
|
|
EventBridge notifiche
Nel bedrock-agentcore namespace, AWS Agent Registry ha emesso due EventBridge eventi Amazon sotto l'origine dell'aws.bedrock-agentcoreevento. L'origine degli eventi ora cambia inaws.agent-registry, gli ARN delle risorse adottano il nuovo namespace e la copertura delle notifiche si estende all'intero record di registro e al ciclo di vita del registro. Gli eventi continuano a passare al bus predefinito EventBridge nell'account della risorsa. È necessario aggiornare tutte EventBridge le regole che corrispondono alla vecchia sorgente o alle vecchie stringhe di tipo di dettaglio.
| Surface (Superficie) | Valore precedente | Nuovo valore |
|---|---|---|
|
Origine eventi |
|
|
|
Namespace ARN delle risorse |
|
|
|
Router di eventi |
Bus predefinito |
Bus predefinito (invariato) |
|
Registry-record eventi |
1 tipo di dettaglio ( |
5 tipi di dettagli (ciclo di vita completo dell'approvazione) |
|
Eventi del registro |
1 tipo di dettaglio () |
7 tipi di dettagli (ciclo di vita completo del registro) |
|
Payload dell'evento |
|
(invariato) |
Importante
Il tipo di dettaglio del registro (principale) è cambiato da una frase a una breve stringa di stato. Una regola che corrisponde al tipo di dettaglio Registry State transitions from Creating to Ready non viene più attivata: aggiornala. Registry Ready Il tipo di dettaglio del record di registro Registry Record State changed to Pending Approval è invariato, quindi le regole corrispondenti continuano a funzionare dopo l'aggiornamento del. source
Registry-record eventi. Emesso quando un record del registro passa da uno stato all'altro del flusso di lavoro di approvazione. Resourcesè l'ARN del record completo; contiene e. detail registryRecordId registryId
| Tipo di dettaglio | Trigger |
|---|---|
|
|
La versione del record viene inserita |
|
|
|
|
|
Registra le transizioni a |
|
|
Registra le transizioni su |
|
|
Registra le transizioni su |
Eventi del registro. Emesso durante il provisioning del registro e le transizioni del ciclo di vita. Resourcesè l'ARN completo del registro; contiene e. detail registryId registryName
| Tipo di dettaglio | Trigger |
|---|---|
|
|
Inserimenti nel registro |
|
|
Il registro diventa |
|
|
Il registro entra |
|
|
Il registro entra |
|
|
Il registro entra |
|
|
Il registro entra |
|
|
Il registro entra |
Evento di esempio (record di registro).
Prima (bedrock-agentcorenamespace, da deprecare):
{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.bedrock-agentcore", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
Dopo (namespace): agent-registry
{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.agent-registry", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:agent-registry:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
Nota
Per far corrispondere qualsiasi modifica dello stato del record di registro a una singola regola, fai corrispondere source (aws.agent-registry) più il prefisso di. detail-type Registry Record State changed to Per corrispondere a qualsiasi modifica del ciclo di vita del registro, fate corrispondere il prefisso del tipo di dettaglio `Registry `.
Esempio: aggiornamento delle politiche IAM
Sostituisci il prefisso dell'azione e lo spazio dei nomi ARN della risorsa in tutte le tue policy IAM.
Prima (bedrock-agentcorenamespace, che sarà obsoleto):
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateRegistry", "bedrock-agentcore:GetRegistry", "bedrock-agentcore:UpdateRegistry", "bedrock-agentcore:ListRegistries", "bedrock-agentcore:DeleteRegistry", "bedrock-agentcore:CreateRegistryRecord", "bedrock-agentcore:GetRegistryRecord", "bedrock-agentcore:UpdateRegistryRecord", "bedrock-agentcore:ListRegistryRecords", "bedrock-agentcore:DeleteRegistryRecord", "bedrock-agentcore:SubmitRegistryRecordForApproval", "bedrock-agentcore:UpdateRegistryRecordStatus", "bedrock-agentcore:SearchRegistryRecords" ], "Resource": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:*"] }] }
Dopo (namespace): agent-registry
{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "agent-registry:CreateRegistry", "agent-registry:GetRegistry", "agent-registry:UpdateRegistry", "agent-registry:ListRegistries", "agent-registry:DeleteRegistry", "agent-registry:CreateRegistryRecord", "agent-registry:GetRegistryRecord", "agent-registry:UpdateRegistryRecord", "agent-registry:ListRegistryRecords", "agent-registry:DeleteRegistryRecord", "agent-registry:SubmitRegistryRecordForApproval", "agent-registry:UpdateRegistryRecordStatus", "agent-registry:SearchDiscoverableRegistryRecords", "agent-registry:ListDiscoverableRegistryRecords", "agent-registry:GetDiscoverableRegistryRecord" ], "Resource": ["arn:aws:agent-registry:us-west-2:123456789012:*"] }] }
Nota
L'BatchGetDiscoverableRegistryRecordAPI non dispone di una propria azione IAM. Autorizza ogni record richiesto rispetto all'agent-registry:GetDiscoverableRegistryRecordazione. Assicurati che la tua politica GetDiscoverableRegistryRecord includa l'usoBatchGet.
Importante
Le risorse relative all'identità del carico di lavoro e ai provider di credenziali OAuth rimangono nel namespace. bedrock-agentcore Se i tuoi registri utilizzano URL sync (source.fromUrl) con credenziali OAuth o IAM, devi mantenere le seguenti autorizzazioni insieme alle nuove autorizzazioni: agent-registry:*
"bedrock-agentcore:CreateWorkloadIdentity", "bedrock-agentcore:GetWorkloadIdentity", "bedrock-agentcore:DeleteWorkloadIdentity"
Non sostituite ogni bedrock-agentcore azione: queste risorse di identità mantengono intenzionalmente il vecchio namespace.
Esempio: aggiornamento della configurazione del client SDK
Aggiorna il nome del servizio, la classe client e l'URL dell'endpoint nelle chiamate SDK.
Prima (bedrock-agentcorenamespace, che sarà obsoleto):
import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "bedrock-agentcore-control", endpoint_url="https://bedrock-agentcore-control.us-west-2.amazonaws.com" ) dp_client = session.client( "bedrock-agentcore", endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com" )
Dopo (namespace): agent-registry
import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "agent-registry-control", endpoint_url="https://agent-registry-control.us-west-2.api.aws" ) dp_client = session.client( "agent-registry", endpoint_url="https://agent-registry.us-west-2.api.aws" )
Esempio: aggiornamento dei comandi CLI
Sostituisci lo spazio dei nomi CLI in tutti gli script e le automazioni.
Prima (bedrock-agentcorenamespace, da deprecare):
aws bedrock-agentcore-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://bedrock-agentcore-control.us-west-2.amazonaws.com
Dopo (namespace): agent-registry
aws agent-registry-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://agent-registry-control.us-west-2.api.aws
Modifiche allo schema API
Oltre alla migrazione dello spazio dei nomi, abbiamo aggiornato i modelli di dati del registro e dei record di registro nel agent-registry namespace. Queste modifiche migliorano la coerenza e l'estensibilità dell'API in base al feedback ricevuto dal namespace. bedrock-agentcore Questa sezione tratta ogni categoria di modifica con esempi precedenti e successivi in modo da poter aggiornare il codice dell'applicazione.
Modifica 1: aggiornamenti delle entità del registro
La configurazione delle autorizzazioni sulla risorsa di registro, che controlla il modo in cui si accede al piano dati di un registro, ora si trova in un discoveryConfiguration involucro dedicato che ne rende esplicito lo scopo. La configurazione di approvazione (che controlla se i record inviati allo stato passano automaticamente allo PENDING_APPROVAL APPROVED stato) passa da un array booleano a uno enum estensibile.
Le modifiche specifiche ai campi sono:
-
authorizerTypeeauthorizerConfigurationvengono spostati all'interno di un nuovodiscoveryConfigurationoggetto. -
approvalConfiguration.autoApproval(boolean) viene sostituito conapprovalConfiguration.autoApprovalRules(array di stringhe enum). Il valore"APPROVE_ALL"ha lo stesso significato semantico di.autoApproval: trueVengono applicate le regole specificate nell'elenco enum. Non specificare (null) significa che è necessaria l'approvazione.
Prima (bedrock-agentcorenamespace, che sarà obsoleto):
{ "name": "string", "description": "string", "authorizerConfiguration": { ... }, "authorizerType": "string", "approvalConfiguration": { "autoApproval": true } }
Dopo (agent-registrynamespace): con Approvazione ALL
{ "name": "string", "description": "string", "discoveryConfiguration": { "authorizerConfiguration": { ... }, "authorizerType": "string" }, "approvalConfiguration": { "autoApprovalRules": ["APPROVE_ALL"] } }
Dopo (agent-registrynamespace): con NULL nell'elenco enum
{ "name": "string", "description": "Registry with manual approval only", "approvalConfiguration": { "autoApprovalRules": [] } }
Modifica 2: nuovi campi obbligatori nei record di registro
I record del registro ottengono due nuovi campi obbligatori di primo livello per supportare una migliore categorizzazione e deduplicazione. È necessario specificare entrambi i campi durante la creazione di un record di registro utilizzando l'CreateRegistryRecordAPI e modificarli in un secondo momento utilizzando l'API. UpdateRegistryRecord
| Campo | Tipo | Description |
|---|---|---|
|
|
Stringa (obbligatoria) |
Un identificatore univoco all'interno del registro che può essere specificato dal cliente. Ogni record deve avere un nome univoco nel registro. Quando |
|
|
Enum (obbligatorio) |
Il tipo semantico del record. Valori validi: |
Modifica 3: ristrutturazione dei record di registro
Il descriptors campo passa da un'unione discriminata a una struttura a chiave piatta.
Nel modello precedente, il descriptorType campo (MCP,, A2AAGENT_SKILLS,CUSTOM) determinava la forma interna. Questo associava il contenuto descrittivo a una classificazione approssimativa del protocollo o del formato. Quel campo non esiste più. recordType, un attributo di primo livello separato, lo sostituisce per la categorizzazione semantica. L'API impone chiavi descrittive valide per ciascuna di esse in fase di esecuzione anziché strutturalmente recordType nella forma. Ogni chiave di primo livello in basso rappresenta descriptors ora un tipo di descrittore primario granulare (ad esempio,,,). a2aAgentCard mcpServer agentSkillsDefinition custom I descrittori supplementari (ad esempio,,) si annidano sotto i descrittori tools primariskillMd. additionalData Il inlineContent campo diventa. data I protocolVersion campi schemaVersion e si consolidano in. dataSchemaVersion
L'synchronizationConfigurationattributo di primo livello diventa source e si sposta all'interno di ogni descrittore (inclusi i figli). additionalData
Il name campo esistente diventadisplayName, rendendone il significato più esplicito. Un nuovo name campo funge da chiave di deduplicazione e deve essere univoco in tutti i record di un registro. Se si specificano entrambi name e recordVersion per lo stesso record, la loro combinazione deve essere univoca.
I seguenti campi vengono rinominati:
| Prima | Dopo | Note |
|---|---|---|
|
|
|
Visualizza il nome del record. Ci sarà anche un nuovo |
|
|
Rimosso |
Sostituito dal campo di primo livello |
|
|
|
Il payload dei contenuti all'interno di ciascun descrittore. |
|
|
|
Campo di versione unificato per tutti i tipi di descrittore. |
|
|
|
Spostato all'interno di ogni descrittore (inclusi i bambini). |
Prima (bedrock-agentcorenamespace, da deprecare):
{ "recordId": "string", "name": "string", "descriptorType": "string", // A2A, MCP, AGENT_SKILL, CUSTOM "descriptors": { "agent": { "a2aAgentCard": { "inlineContent": "string", "schemaVersion": "string" } }, "agentSkills": { "skillDefinition": { "inlineContent": "string", "schemaVersion": "string" }, "skillMd": { "inlineContent": "string" } }, "mcp": { "server": { "inlineContent": "string", "schemaVersion": "string" }, "tools": { "inlineContent": "string", "protocolVersion": "string" } }, "custom": { "inlineContent": "string" } }, "synchronizationType": "URL", "synchronizationConfiguration": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [ { "credentialProvider": { ... }, "credentialProviderType": "string" } ] } }, ... }
Dopo (namespace): agent-registry
{ "recordId": "string", "displayName": "string", "name": "string", "recordVersion": "string", "recordType": "AGENT" | "MCP" | "SKILL" | "CUSTOM", "descriptors": { "a2aAgentCard": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [...] } } }, "mcpServer": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } }, "additionalData": { "tools": { "data": "string", "dataSchemaVersion": "string" } } }, "agentSkillsDefinition": { "data": "string", "dataSchemaVersion": "string", "additionalData": { "skillMd": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } } } } }, "custom"?: { "data": "string" } } ... }
Vengono applicati i vincoli seguenti:
È possibile inserire esattamente una chiave descrittiva primaria per record. I descrittori primari validi per sono: recordType
-
AGENTE:
a2aAgentCard,,mcpServercustom -
MCP:
mcpServer,custom -
ABILITÀ:
agentSkillsDefinition,custom -
PERSONALIZZATO:
custom
sourceè per descrittore anziché un singolo blocco di primo livello. Si collega ai descrittori che contengono un campo nello schema e. source mcpServer a2aAgentCard Il tools bambino (minoremcpServer.additionalData), il agentSkillsDefinition genitore e il custom descrittore portano n. source
Nel agent-registry namespace, è supportato solo. source.fromUrl
Auto-synchronization viene attivato solo per i descrittori a2aAgentCard primari mcpServer e per i tipi di record MCP e AGENT. A source sul skillMd figlio viene mantenuto ma non utilizzato per eseguire la sincronizzazione e i record SKILL non possono essere sincronizzati automaticamente. I record PERSONALIZZATI devono essere creati manualmente inserendoli direttamente. data
Modifica 4: aggiornamenti del filtro del piano dati
SearchRegistryRecordsdiventa SearchDiscoverableRegistryRecords (POST /discoverable-records-search). La richiesta e la risposta raccolgono i nuovi nomi dei campi e il nuovo modello di dati:
-
Filtra per
recordType(sostituiscedescriptorType). -
Filtra per
recordVersion(sostituisceversion). -
La risposta restituisce i descrittori nel nuovo formato, senza.
credentialProviderConfigurations
Lo strumento di ricerca MCP search_registry_records diventasearch_discoverable_registry_records, restituisce il nuovo formato descrittore e utilizza i nuovi nomi dei filtri.
Modifica 5: nuove API di navigazione
Due nuove API del piano dati supportano la creazione di esperienze di navigazione e catalogo sulla base di record approvati. Queste API non richiedono alcuna migrazione esplicita; le menzioniamo qui come aggiunte al modello API AWS Agent Registry nel namespace. agent-registry
ListDiscoverableRegistryRecords— Restituisce un elenco suddiviso in pagine di record di registro approvati. Usalo per creare interfacce di navigazione sui contenuti pubblicati.
// HTTP: POST /registries/{registryId}/discoverable-records-list { "registryId": "string", // path param, required (ARN or ID) "maxResults": 1-100, // query param, optional "nextToken": "string", // query param, optional "filters": [ { "name": "recordType", "values": ["MCP"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "nextToken": "string" }
BatchGetDiscoverableRegistryRecord— Recupera i dettagli completi di un batch di record in uno o più registri in una singola chiamata.
// HTTP: POST /discoverable-records-batch { "entries": [ { "registryId": "reg-AAA", "recordIds": ["rec-111", "rec-222"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "descriptors": { ... }, "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "errors": [ { "registryId": "string", "recordId": "string", "errorCode": "RESOURCE_NOT_FOUND" | "ACCESS_DENIED" | "INTERNAL_ERROR", "message": "string" } ] }
La risposta include un registryRecords array con i dettagli completi dei record e un errors array per tutti i record che non è stato possibile recuperare.
All'avvio, viene accettata esattamente una voce (un registro, 1-100 ID di record). La forma raggruppata è compatibile in futuro con il batching tra registri nelle versioni future.
Modifica 6: le API delle liste adottano il parametro dei filtri strutturati
Nel bedrock-agentcore namespace, le API List espongono ogni campo filtrabile come parametro di query separato (ad esempio,). --status READY --recordType MCP Nel agent-registry namespace, un singolo parametro strutturato sostituisce questi parametri discreti. filters Il filters valore è un elenco di { "name": "<dotted.path>", "values": ["<value>"] } voci in cui name è indicato un percorso di attributi delimitato da punti. I nuovi campi filtrabili, inclusi quelli annidati, diventano nuovi name percorsi anziché nuovi parametri API. Anche le operazioni relative agli elenchi cambiano da aGET. POST I parametri di impaginazione (maxResults,nextToken) rimangono invariati.
Prima (bedrock-agentcorenamespace, da deprecare):
GET /registries?status=READY&authorizerType=AWS_IAM GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP
Dopo (namespace): agent-registry
// ListRegistries // POST /registries-list { "filters": [ { "name": "status", "values": ["READY"] }, { "name": "discoveryConfiguration.authorizerType", "values": ["AWS_IAM"] } ], "maxResults": 100, "nextToken": "string" } // ListRegistryRecords // POST /registries/{registryId}/records-list { "filters": [ { "name": "name", "values": ["my-agent"] }, { "name": "status", "values": ["APPROVED"] }, { "name": "recordType", "values": ["MCP"] } ], "maxResults": 100, "nextToken": "string" }
Migrazione dei dati
È necessario migrare i registri e i record di registro esistenti dal namespace al bedrock-agentcore namespace. agent-registry Forniamo uno strumento di migrazione per facilitare la migrazione. Lo strumento gestisce l'estrazione dei dati esistenti, la trasformazione dal vecchio schema al nuovo schema e il caricamento nei registri nel nuovo namespace. Lo strumento crea nuovi registri nel agent-registry namespace all'interno dello stesso account e della stessa regione. Migra tutti i record esistenti dai vecchi registri a quelli nuovi, tenendo conto delle modifiche allo spazio dei nomi e allo schema delle API.
Lo strumento di migrazione è disponibile nel repository agentcore-samples sul sito Web.
Scelta del tuo approccio alla migrazione
L'approccio giusto dipende dal fatto che sia sufficiente una migrazione completa una tantum o se sia necessaria un'esecuzione automatica e la capacità di eseguire un carico incrementale al termine del ciclo.
Caso 1: migrazione semplice
-
Profilo: è sufficiente una migrazione completa una tantum. Non è necessario eseguire carichi incrementali o lasciare i processi in esecuzione incustoditi.
-
Approccio: Esegui lo strumento di migrazione direttamente dal tuo terminale o. AWS CloudShell Nessuna infrastruttura da implementare. Lo strumento si connette al
bedrock-agentcorenamespace, estrae i registri e i record, trasforma i datiagent-registrynello schema e li crea nel nuovo namespace. Questo è il percorso più semplice e non richiede l'implementazione dell'infrastruttura.
Caso 2: migrazione gestita con AWS Aderenza
-
Profilo: si preferisce l'esecuzione automatica oppure si prevede di eseguire entrambe le versioni del registro in parallelo per un periodo e si richiede un caricamento incrementale al termine del caricamento per acquisire tutti i record creati o aggiornati nel
bedrock-agentcorenamespace dopo l'esecuzione completa iniziale. -
Approccio: implementa la migrazione come processi AWS Glue utilizzando lo stack CDK fornito. I processi vengono eseguiti nel tuo account senza dipendere da una sessione terminale aperta.
Il flusso tipico è: esegui una migrazione completa per aggiornare il
agent-registrynamespace, quindi gestisci entrambi i namespace in parallelo mentre convalidi e aggiorni le integrazioni. Quando sei pronto a procedere, esegui un carico incrementale per sincronizzare tutti i record che sono cambiati durante il periodo parallelo, verifica e trasferisci il traffico verso il namespace.agent-registry
Caso 3: migrazione Active-active
-
Profilo: hai creato una piattaforma o una pipeline di automazione sulla base delle API dei
bedrock-agentcorenamespace e scrivi continuamente nuovi record in produzione. -
Approccio: inizia con una migrazione completa utilizzando l' AWS Glue-based approccio gestito per portare tutti i dati storici nel namespace.
agent-registryQuindi punta la piattaforma o la pipeline verso lo spazio deiagent-registrynomi oltre allo spazio deibedrock-agentcorenomi: l'applicazione scrive su entrambi contemporaneamente. Usa questo periodo attivo-attivo per convalidare le tue integrazioni e aumentare la fiducia nel namespace.agent-registryQuando sei soddisfatto, interrompi tutte le letture e le scritture e disattiva l'integrazione dello spazio dei nomiagent-registry.bedrock-agentcore
Verifica della migrazione
Dopo aver eseguito la migrazione, conferma che i tuoi dati siano stati migrati correttamente:
-
Elenca tutti i registri nel nuovo namespace utilizzando il comando
list-registriesCLI e conferma che il conteggio corrisponda alla fonte. -
Per ogni registro, confronta il conteggio dei record utilizzando.
list-registry-records -
Spot-check singoli record per confermare che i descrittori sono stati trasformati correttamente (ridenominazione dei campi, ristrutturazione dei descrittori).
-
Aggiorna le policy, gli endpoint e i client SDK IAM come descritto nella sezione Namespace e modifiche alla configurazione.
-
Verifica che le tue applicazioni siano in grado di leggere e scrivere correttamente utilizzando il nuovo namespace.
Aggiorna le politiche di fiducia IAM per i record sincronizzati
Se uno dei tuoi record di registro utilizza il tipo di credenziale Sincronizza con il ruolo IAM, devi aggiornare la politica di fiducia del ruolo prima di eseguire il live load. Il responsabile del servizio che assume il ruolo è cambiato da bedrock-agentcore.amazonaws.com a agent-registry.amazonaws.com nel nuovo namespace. I record che utilizzano credenziali OAuth o che non utilizzano alcuna autorizzazione non sono interessati.
Nota
Lo strumento di migrazione non è in grado di rilevarlo: lo strumento non assume mai il ruolo di sincronizzazione. Il servizio di registro lo assume in modo asincrono dopo la creazione del record. Se salti questo passaggio, il record migrato arriva nello spazio dei agent-registry nomi indicando lo stesso ruolo e la sincronizzazione ha esito negativo finché il ruolo non considera attendibile il nuovo principale.
Aggiorna la politica di fiducia sul ruolo a cui fa riferimento ogni record interessato.
Prima (bedrock-agentcorenamespace, che sarà obsoleto):
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "bedrock-agentcore.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Dopo (namespace): agent-registry
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "agent-registry.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Se un record ha già avuto esito negativo per questo motivo, lo stato del record migrato esiste. CREATE_FAILED Lo strumento di migrazione si rifiuta di sovrascrivere un record in stato di errore, pertanto la sola correzione della politica di fiducia non risolve il problema. Per recuperare:
-
Aggiornare la politica di fiducia sul ruolo interessato.
-
Elimina il
CREATE_FAILEDrecord dalagent-registrynamespace. -
Re-run il carico.
Domande frequenti
Cosa sta cambiando in AWS Registro degli agenti?
AWS Agent Registry sta passando dal bedrock-agentcore namespace al nuovo namespace dedicatoagent-registry. La migrazione si estende su tre aree: modifiche allo spazio dei nomi e alla configurazione (endpoint, IAM, SDK, CLI, ARNs, osservabilità), modifiche allo schema API (modello di dati ristrutturato per registri e record) e migrazione dei dati (spostamento dei registri e dei record esistenti nel nuovo namespace).
Posso continuare a utilizzare Registry nel namespace bedrock-agentcore?
L'attuale utilizzo del Registro nel bedrock-agentcore namespace continua a funzionare senza interruzioni durante la finestra di migrazione. Tuttavia, ti consigliamo di iniziare la migrazione non appena gli strumenti saranno disponibili per assicurarti di avere tempo sufficiente per completare sia la migrazione dei dati che gli aggiornamenti del codice.
Tuttavia, se non disponi di registri o record esistenti al 6 agosto 2026, non puoi accedere al bedrock-agentcore namespace per il registro degli AWS agenti dal 6 agosto 2026. Se disponi di registri o record esistenti al 6 agosto 2026, puoi accedere al bedrock-agentcore namespace per AWS Agent Registry durante la finestra di migrazione (6 agosto 2026 — 17 settembre 2026).
I miei dati verranno migrati automaticamente?
No È necessario avviare personalmente la migrazione utilizzando gli strumenti di migrazione forniti. Consulta la sezione Migrazione dei dati per i dettagli sugli approcci disponibili in base alla tua scalabilità.
Quali modifiche allo schema API sono incluse?
Oltre alla modifica dello spazio dei nomi, abbiamo aggiornato il modello di dati API in sei aree: entità del registro (configurazione di autorizzazione raggruppata in), nuovi campi del record di registro (namee discoveryConfigurationrecordType), ristrutturazione dei record del registro (descrittori appiattiti, ridenominazione dei campi), aggiornamenti dei filtri delle API di ricerca (,), nuove API di navigazione (recordType,recordVersion) e filtri strutturati per le operazioni di elenco. ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord
Quanto durerà la migrazione dei dati?
Il tempo di migrazione dipende dal numero di registri e record presenti nel tuo account. Per gli account con meno di 100 record, la migrazione viene completata in pochi minuti se eseguita localmente. Per gli account con migliaia di record, si prevede che la migrazione venga completata in meno di 15 minuti se eseguita come processo gestito.
Cosa succede se ho una distribuzione su larga scala con scritture attive?
Se stai scrivendo attivamente i dati nel bedrock-agentcore namespace in produzione, utilizza l'approccio di migrazione active-active come descritto nel Caso 3. Inizia con una migrazione completa per aggiornare il agent-registry namespace, quindi scrivi su entrambi i namespace contemporaneamente per convalidare le tue integrazioni e aumentare la fiducia nel nuovo namespace. Interrompi le operazioni di lettura e scrittura fino a quando sei pronto. agent-registry
Dove posso ricevere assistenza?
Per domande o assistenza sulla migrazione, contatta l'AWS assistenza