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à.
Risoluzione dei problemi
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.
Errori di convalida dei dati
Quando si creano diversi tipi di record, è possibile che venga visualizzata un'eccezione di convalida per i descrittori. Vedi la sezione Tipi di record supportati per gli schemi validi.
Errori comuni:
-
«La versione dello schema '0.3.0' non è supportata per il tipo di descrittore 'a2a'.» — Il valore del campo SchemaVersion deve essere invece di.
0.30.3.0Ciò è in linea con la descrizione ufficiale della versione del protocollo A2Asul sito Web del protocollo A2A: «Usa l'ultima versione secondaria supportata per versione principale». -
«Convalida dello schema non riuscita: il contenuto non è conforme alla versione dello schema '0.3' per il tipo di descrittore 'a2a'». — È possibile trovare lo schema in Tipi di record supportati. Tipi di record e descrittori supportati Nota che il contenuto verrà convalidato rispetto a #/ definitions/AgentCard nello schema json.
Registra gli errori di sincronizzazione
Quando si crea o si aggiorna un record utilizzando la funzionalità di sincronizzazione, il record può passare allo stato CREATE_FAILED o UPDATE_FAILED, con una spiegazione dell'accaduto. statusReason
Ad alto livello, gli errori possono essere classificati come: errori di autorizzazione, errori di connessione, errori di convalida ed errori lato server.
Errori di autorizzazione
La configurazione di sincronizzazione è errata o scaduta:
-
«Impossibile connettersi al server MCP perché le credenziali del chiamante sono scadute». — Le tue credenziali per l'API di creazione o aggiornamento sono scadute. Puoi riprovare con l'API. UpdateRegistryRecord
-
«Eccezione ricevuta dall' GetWorkloadAccessToken API:<detailed message>» — Il registro chiama l'GetWorkloadAccessTokenAPI per tuo conto. Fai riferimento al messaggio dettagliato per l'errore specifico. Se viene visualizzato un errore di accesso negato, consulta Sincronizzare i record da fonti esterne.
-
«Impossibile analizzare l'ARN del provider di credenziali:<arn>» — L'ARN del provider di credenziali non è valido. Fornisci un ARN del provider di credenziali valido creato da Identity. AgentCore
-
«Eccezione ricevuta dall' GetResourceOauth2Token API:<detailed message>»: il registro chiama l'GetResourceOauth2TokenAPI per tuo conto. Fai riferimento al messaggio dettagliato per l'errore specifico. Se viene visualizzato un errore di accesso negato, consulta Sincronizzare i record da fonti esterne.
-
«Impossibile assumere il ruolo IAM fornito per l'autorizzazione del server MCP». — Il registro chiama l' AssumeRole API per conto dell'utente. Vedi Sincronizzazione dei record da fonti esterne per le autorizzazioni IAM previste. Ad esempio, è necessario disporre dell'
iam:PassRoleautorizzazione.
Errori di connessione
Impossibile raggiungere il server:
-
«Impossibile recuperare la scheda agente dall'URL: %s» — A2A IOException
-
«Il server MCP ha restituito HTTP<code>» — risposta non 200/202 HTTP dal server MCP. Controlla se l'URL è corretto e il server MCP può essere connesso.
-
Se il codice di stato è 401 o 403, verifica di aver configurato il provider di credenziali corretto e che le tue credenziali dispongano dell'autorizzazione per connettersi al server MCP. Per risolvere il problema, acquisite le credenziali manualmente e connettetevi direttamente al server MCP.
-
«L'URL fornito si risolve in un indirizzo IP non pubblico»: il registro supporta solo la connessione a server di indirizzi IP pubblici.
-
«Connessione al server MCP non riuscita»: errore IOException/connection
-
«URL del server MCP non valido»: URL non valido
-
«Impossibile inizializzare la connessione MCP»: eccezione di inizializzazione della richiesta
-
«Invio della notifica inizializzata non riuscito» — eccezione di notifica
-
«Impossibile elencare gli strumenti dal server MCP» — eccezione tools/list
-
«L' tools/list impaginazione del server MCP è scaduta»: il registro supporta solo un massimo di 30 secondi per l'impaginazione degli strumenti dal server MCP. Contatta l' AWS assistenza se il tuo server MCP ha bisogno di più tempo per la sincronizzazione.
Errori di convalida
Il server ha risposto ma il contenuto non è supportato:
-
«Impossibile analizzare il JSON della scheda agente»: contenuto A2A vuoto o in formato JSON non valido
-
«La scheda agente supera il limite massimo di dimensione»: risposta A2A troppo grande
-
«Impossibile analizzare la risposta del server MCP JSON»: contenuto MCP vuoto o non valido
-
«Il server MCP ha restituito una risposta non valida: risultato mancante» — Risultato MCP mancante JSON-RPC
-
«La risposta del server MCP supera la dimensione massima consentita»: risposta MCP troppo grande
-
«Il tipo di descrittore %s non supporta la sincronizzazione degli URL» — tipo di descrittore non supportato
Errori lato server
-
«Errore sconosciuto»: si tratta di un errore lato server. Riprova più tardi o contatta l' AWS assistenza per ricevere assistenza.
Auto-detection errori
«La creazione di un registro con ambito organizzativo richiede che il chiamante faccia parte di un AWS Organizzazione».
L'account che crea il registro non è membro di un' AWS organizzazione (ad esempio, è un account autonomo). Crea il registro da un account che appartiene alla tua organizzazione.
«i Auto-detection presupposti non sono soddisfatti per questa organizzazione».
L'organizzazione non soddisfa ancora le condizioni preliminari per il rilevamento automatico o non ha terminato la propagazione. Verifica che l'accesso affidabile sia abilitato per il rilevamento automatico e che stai creando il registro dall'account di gestione o da un amministratore delegato registrato, quindi riprova dopo una breve attesa. Vedi Abilitazione del rilevamento automatico in tutta l'organizzazione.
«Esiste già un registro con ambito organizzativo per questo account».
Questo account possiede già un registro con ambito organizzativo e un account può averne solo uno. Utilizza il registro esistente o eliminalo prima di crearne un altro. Se non riesci a trovare il registro in questo account, vedi Individuazione di un registro esistente con ambito organizzativo.
«Per questa organizzazione esiste già un altro registro con rilevamento automatico attivo».
Un altro account dell'organizzazione possiede già un registro con ambito organizzativo con rilevamento automatico attivo e un'organizzazione può averne solo uno alla volta. Per motivi di sicurezza, il messaggio di errore non indica il nome dell'account proprietario del registro esistente. Per trovarlo e scegliere come risolvere il conflitto, vedi Individuazione di un registro esistente con ambito organizzativo.
Individuazione di un registro esistente con ambito organizzativo
Quando si CreateRegistry segnala che esiste già un registro con ambito organizzativo, nell'account o in un altro punto dell'organizzazione, l'errore non indica il nome del registro specifico o dell'account che lo possiede. Trova prima il registro esistente, quindi decidi come risolvere il conflitto.
Un registro con ambito organizzativo è normalmente di proprietà di uno di questi account:
-
L'account di gestione dell'organizzazione.
-
L'account attualmente registrato come amministratore delegato per AWS Agent Registry.
Chiedi a un amministratore con accesso a tali account di elencare i registri nella stessa regione della chiamata non riuscita e cercane uno che sia: autoDetectionConfiguration.scope ORGANIZATION
aws agent-registry-control list-registries --region us-east-1
Dall'account di gestione, conferma quale account è attualmente l'amministratore delegato:
aws organizations list-delegated-administrators \ --service-principal agent-registry.amazonaws.com
Il conflitto si applica solo all'interno della stessa regione: un accesso di registro us-east-1 non impedisce la creazione di un account. us-west-2
Una volta individuato il registro esistente, scegli uno dei seguenti percorsi:
-
Condividilo e riutilizzalo. Chiedi all'account proprietario di concedere l'accesso al tuo account utilizzando la AWS RAM e gestisci i record nel registro condiviso invece di crearne uno nuovo. Vedi Condivisione di un registro tra account con AWS RAM.
-
Libera lo slot senza eliminarlo. L'account proprietario viene impostato
autoDetectionConfiguration.enablednel registro esistente; una volta che l'aggiornamento avrà effetto,CreateRegistryriprova.falseVedi Disabilitare il rilevamento automatico nel registro. -
Eliminare il registro esistente. Se non è più necessario, l'account proprietario lo elimina. Vedi Disattivazione del rilevamento automatico per l'ordine di smontaggio.
CreateRegistryfallisce anche se l'accesso affidabile è abilitato e l'amministratore delegato è registrato
Verificare che l'account di gestione abbia il ruolo collegato al servizio AWS Agent Registry (). AWSServiceRoleForAgentRegistry Deve essere presente nell'account di gestione prima di poter creare un registro con ambito organizzativo, anche quando è l'amministratore delegato a crearlo. Vedi Passaggio 1: abilitare l'accesso affidabile e creare il ruolo collegato al servizio.
Il registro è PRONTO ma i record non vengono visualizzati
Verifica che lo stato di rilevamento automatico del registro sia ACTIVE (conget-registry) e che gli account dei membri contengano tipi di risorse supportati (AgentCore Runtime o Gateway). Attendi il tempo necessario per il completamento dell'individuazione: alla prima configurazione, l'individuazione iniziale delle risorse preesistenti può richiedere fino a 20 minuti.
Auto-detection lo stato mostra ancora «L'account amministratore delegato del registro è stato annullato» dopo la nuova registrazione di un amministratore delegato
Quando l'account di gestione annulla la registrazione dell'amministratore delegato proprietario di un registro con ambito organizzativo, AWS Agent Registry disattiva il rilevamento automatico su quel registro e registra il motivo dello stato The registry’s delegated administrator account was deregistered. Questo motivo di stato descrive il motivo per cui il rilevamento automatico è stato originariamente disabilitato: è un record storico e non viene aggiornato quando lo stato dell'organizzazione cambia successivamente.
Se un amministratore delegato viene registrato nuovamente, il rilevamento automatico del registro non viene ripreso automaticamente e il motivo dello stato continua a visualizzare il messaggio di annullamento della registrazione. Ciò è previsto in ognuna delle seguenti situazioni:
-
Lo stesso account viene registrato nuovamente come amministratore delegato.
-
Un account diverso viene registrato come amministratore delegato, anche quando tale account possiede già un proprio registro con ambito organizzativo con rilevamento automatico precedentemente disabilitato.
-
Non è registrato alcun nuovo amministratore delegato e l'account di gestione possiede direttamente un registro con ambito organizzativo.
Per riprendere il rilevamento automatico, l'account proprietario del registro interessato deve essere esplicitamente impostato su. enabled true ACTIVEIn un'organizzazione può essere autoDetection.status impostato solo un registro con ambito organizzativo per regione, quindi se più registri sono idonei, riattiva il rilevamento automatico solo su quello che desideri mantenere attivo.
aws agent-registry-control update-registry \ --registry-id <registry-id-or-arn> \ --auto-detection-configuration '{"optionalValue":{"scope":"ORGANIZATION","enabled":true}}' \ --region us-east-1
Per l'intero ciclo di vita, vedi Disattivazione del rilevamento automatico. Disattivazione del rilevamento automatico
«Il registro non può essere eliminato quando il rilevamento automatico è abilitato. Disabilita prima il rilevamento automatico».
È necessario disabilitare il rilevamento automatico prima di poter eliminare un registro con ambito organizzativo. Per eliminare il registro, completa questi passaggi nell'ordine:
-
Disattiva il rilevamento automatico nel registro (impostato
autoDetectionConfiguration.enabledsufalse). -
Elimina tutti i record del registro.
-
Eliminare il registro.
Per ulteriori informazioni, vedere Disabilitare il rilevamento automatico nel registro.