View a markdown version of this page

Risoluzione dei problemi - Amazon Bedrock AgentCore
Errori di convalida dei datiRegistra gli errori di sincronizzazione

Risoluzione dei problemi

Prossima migrazione del namespace

AWS Agent Registry è attualmente disponibile in anteprima pubblica nel namespace bedrock-agentcore. A partire dal 6 agosto 2026, il servizio passerà allo spazio dei nomi agent-registry. Se utilizzi AWS Agent Registry, devi aggiornare gli endpoint, le policy IAM, i client SDK, gli script CLI e i dati del registro. Per ulteriori informazioni sulla migrazione dall'anteprima pubblica, 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:

Registra gli errori di sincronizzazione

Quando si crea o si aggiorna un record utilizzando la funzione 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 della sincronizzazione è errata o scaduta:

  • «Impossibile connettersi al server MCP perché le credenziali del chiamante sono scadute». — il chiamante dell'API di creazione o aggiornamento ha credenziali scadute. Puoi riprovare con l'API. UpdateRegistryRecord

  • «Eccezione ricevuta dall' GetWorkloadAccessToken API:<detailed message>": il registro chiama GetWorkloadAccessTokenl'API per conto del chiamante. Per informazioni sull'errore, consulta il messaggio dettagliato. Consulta Sincronizza i record da fonti esterne se vedi l'eccezione Accesso negato.

  • «Impossibile analizzare l'ARN del provider di credenziali:<arn>" — ARN del provider di credenziali non valido. Deve essere un ARN del provider di credenziali valido creato AgentCore da Identity.

  • «Eccezione ricevuta dall' GetResourceOauth2Token API:<detailed message>": il registro chiama l'GetResourceOauth2TokenAPI per conto del chiamante. Per informazioni sull'errore, consulta il messaggio dettagliato. Consulta Sincronizza i record da fonti esterne se vedi l'eccezione Accesso negato.

  • «Impossibile assumere il ruolo IAM fornito per l'autorizzazione del server MCP». — il registro chiama AssumeRole l'API per conto del chiamante. Fai riferimento a Sincronizza i record da fonti esterne per le autorizzazioni IAM previste, ad esempio il chiamante deve avere l'autorizzazione. iam:PassRole

Errori di connessione

Impossibile raggiungere il server:

  • «Impossibile recuperare la scheda dell'agente dall'URL: %s» — A2A IOException

  • «Il server MCP ha restituito HTTP<code>": risposta non 200/202 HTTP dal server MCP. Verifica che l'URL sia corretto e che il server MCP possa essere collegato.

  • «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»: inizializza l'eccezione della richiesta

  • «Impossibile inviare la notifica inizializzata»: eccezione di notifica

  • «Impossibile elencare gli strumenti dal server MCP» — eccezione tools/list

  • «Timeout di tools/list impaginazione del server MCP»: il registro supporta solo un massimo di 30 secondi per l'impaginazione degli strumenti dal server MCP. Contattate l' AWS assistenza se il server MCP necessita di più tempo per la sincronizzazione.

Errori di convalida

Il server ha risposto ma il contenuto non è supportato:

  • «Impossibile analizzare il codice JSON della scheda agente»: contenuto A2A (JSON vuoto o non valido)

  • «La scheda dell'agente supera il limite massimo di dimensione»: risposta A2A troppo grande

  • «Impossibile analizzare la risposta JSON del server MCP»: 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 sul lato server

  • «Errore sconosciuto»: si tratta di un errore sul lato server. Riprova più tardi o contatta l' AWS assistenza per ricevere assistenza.