View a markdown version of this page

Guida completa alla migrazione del registro - 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à.

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:

  1. 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-agentcore agent-registry Ciò 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.

  2. 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-agentcore namespace. 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.

  3. 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-registry namespace per AWS Agent Registry. Accedere al servizio nella console dell'Agent Registry. AWS Se disponi di registri e record esistenti, hai accesso simultaneo ai namespace e ai namespace. bedrock-agentcore agent-registry Gli 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-namespace GitHub È 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-agentcore Inizia a utilizzare AWS Agent Registry direttamente dal namespace. agent-registry

  • 17 settembre 2026: la finestra di migrazione si chiude. Il vecchio bedrock-agentcore namespace 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 il agent-registry namespace.

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

bedrock-agentcore.{region}.amazonaws.com

agent-registry.{region}.api.aws

Punto finale del piano di controllo

bedrock-agentcore-control.{region}.amazonaws.com

agent-registry-control.{region}.api.aws

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

bedrock-agentcore:*

agent-registry:*

Principale del servizio

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

ARN del registro

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}

arn:aws:agent-registry:{region}:{account}:registry/{id}

Registra ARN

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}/record/{rid}

arn:aws:agent-registry:{region}:{account}:registry/{id}/record/{rid}

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

BedrockAgentCoreClient

AgentRegistryClient

Classe client Controlplane SDK

BedrockAgentCoreControlClient

AgentRegistryControlClient

Namespace CLI

aws bedrock-agentcore

aws agent-registry

Codice Service Quotas

bedrock-agentcore

agent-registry

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

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

EventBridge fonte

aws.bedrock-agentcore

aws.agent-registry

CloudWatch namespace

AWS/BedrockAgentCore

AWS/AgentRegistry

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

aws.bedrock-agentcore

aws.agent-registry

Namespace ARN delle risorse

arn:aws:bedrock-agentcore:{region}:{account}:registry/…​

arn:aws:agent-registry:{region}:{account}:registry/…​

Router di eventi

Bus predefinito

Bus predefinito (invariato)

Registry-record eventi

1 tipo di dettaglio (Registry Record State changed to Pending Approval)

5 tipi di dettagli (ciclo di vita completo dell'approvazione)

Eventi del registro

1 tipo di dettaglio () Registry State transitions from Creating to Ready

7 tipi di dettagli (ciclo di vita completo del registro)

Payload dell'evento detail

registryRecordId, registryId (record)

(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

Registry Record State changed to Draft

La versione del record viene inserita DRAFT

Registry Record State changed to Pending Approval

SubmitRegistryRecordForApprovalchiamato (invariato)

Registry Record State changed to Approved

Registra le transizioni a APPROVED

Registry Record State changed to Rejected

Registra le transizioni su REJECTED

Registry Record State changed to Deprecated

Registra le transizioni su DEPRECATED

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

Registry Creating

Inserimenti nel registro CREATING

Registry Ready

Il registro diventa READY (sostituisce il valore dello bedrock-agentcore spazio dei nomi) Registry State transitions from Creating to Ready

Registry Create Failed

Il registro entra CREATE_FAILED

Registry Updating

Il registro entra UPDATING

Registry Update Failed

Il registro entra UPDATE_FAILED

Registry Deleting

Il registro entra DELETING

Registry Delete Failed

Il registro entra DELETE_FAILED

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:

  • authorizerTypee authorizerConfiguration vengono spostati all'interno di un nuovo discoveryConfiguration oggetto.

  • approvalConfiguration.autoApproval(boolean) viene sostituito con approvalConfiguration.autoApprovalRules (array di stringhe enum). Il valore "APPROVE_ALL" ha lo stesso significato semantico di. autoApproval: true Vengono 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

name

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 recordVersion è presente anche, la combinazione di name e recordVersion deve essere univoca.

recordType

Enum (obbligatorio)

Il tipo semantico del record. Valori validi: AGENT, MCP, SKILL, CUSTOM. Determina in quale chiave descrittiva primaria è valida. descriptors Puoi utilizzare API come ListRegistryRecords e SearchDiscoverableRegistryRecords per filtrare i risultati in base a questo tipo semantico.

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

name

displayName

Visualizza il nome del record. Ci sarà anche un nuovo name campo che è la chiave di deduplica.

descriptorType

Rimosso

Sostituito dal campo di primo livellorecordType.

inlineContent

data

Il payload dei contenuti all'interno di ciascun descrittore.

schemaVersion / protocolVersion

dataSchemaVersion

Campo di versione unificato per tutti i tipi di descrittore.

synchronizationConfiguration

source

Spostato all'interno di ogni descrittore (inclusi i bambini). additionalData

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,, mcpServer custom

  • 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. GitHub Per istruzioni di configurazione complete, riferimenti ai comandi e indicazioni operative, consulta il repository README.

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-agentcore namespace, estrae i registri e i record, trasforma i dati agent-registry nello 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-agentcore namespace 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-registry namespace, 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-agentcore namespace 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-registry Quindi punta la piattaforma o la pipeline verso lo spazio dei agent-registry nomi oltre allo spazio dei bedrock-agentcore nomi: l'applicazione scrive su entrambi contemporaneamente. Usa questo periodo attivo-attivo per convalidare le tue integrazioni e aumentare la fiducia nel namespace. agent-registry Quando 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-registries CLI 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:

  1. Aggiornare la politica di fiducia sul ruolo interessato.

  2. Elimina il CREATE_FAILED record dal agent-registry namespace.

  3. 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.