View a markdown version of this page

Risoluzione dei problemi di AgentCore pagamento - Amazon Bedrock AgentCore
Errori di convalidaErrori di autorizzazioneErrori relativi alla risorsa non trovataErrori di conflittoErrori relativi alle quote di servizioErrori di limitazioneErrori nell'elaborazione dei pagamentiErrori server

Risoluzione dei problemi di AgentCore pagamento

Questa sezione fornisce soluzioni agli errori più comuni durante l'utilizzo AgentCore dei pagamenti AWS Amazon Bedrock.

Errori di convalida

Durante la creazione o l'aggiornamento di risorse di pagamento, il servizio restituisce unValidationException. La tabella seguente elenca gli errori di convalida più comuni e le relative risoluzioni.

Messaggio di errore Risoluzione

roleArn must contain a valid account ID

roleArnDeve essere un ARN di ruolo IAM valido con un ID account a 12 cifre. Verifica il formato:. arn:aws:iam::<accountId>:role/<roleName>

roleArn must belong to your account

L'ID dell'account inserito roleArn deve corrispondere all'account del chiamante. Cross-account i ruoli non sono supportati.

Invalid role ARN: {roleArn}

Non roleArn può essere analizzato. Verifica il formato ARN.

credentialProviderConfigurations list cannot be empty

Fornisci almeno una configurazione del provider di credenziali durante la creazione o l'aggiornamento di un connettore di pagamento.

credentialProviderArn is required but not found in the request

Ogni configurazione del provider di credenziali deve includere un. credentialProviderArn Creane prima uno utilizzando Create a Credential Provider.

Connector type '{type}' does not match the provided credentialProviderConfiguration

La variante di configurazione del provider di credenziali deve corrispondere al tipo di connettore. Ad esempio, un CoinbaseCDP connettore richiede la coinbaseCDP configurazione, nonstripePrivy.

Vengono inoltre applicati i vincoli di denominazione dei campi:

  • I nomi dei gestori dei pagamenti devono iniziare con una lettera e contenere solo caratteri alfanumerici (massimo 48 caratteri).

  • I nomi dei connettori di pagamento seguono le stesse regole ma consentono anche i caratteri di sottolineatura.

  • Le descrizioni consentono caratteri e spazi alfanumerici (massimo 4096 caratteri).

Errori di autorizzazione

Messaggio di errore Risoluzione

Access denied due to account security restrictions. Contact AWS Support for assistance.

Il tuo account è stato sottoposto a restrizioni. Contatta l' AWS assistenza per risolvere il problema.

Access denied for {CREATE|UPDATE} due to account security restrictions. Contact AWS Support for assistance.

Il tuo account è in uno stato di accesso limitato. Le operazioni di lettura ed elenco sono consentite, ma le operazioni di creazione e aggiornamento sono limitate fino alla risoluzione della restrizione.

Errori di autorizzazione IAM SigV4

Assicurati che il principale chiamante disponga delle autorizzazioni appropriate. bedrock-agentcore: Il servizio utilizza la firma SigV4 con il nome della bedrock-agentcore firma.

PassRole fallimenti

Quando si fornisce unroleArn, il chiamante deve disporre dell'iam:PassRoleautorizzazione per il ruolo. La politica di fiducia del ruolo deve consentire l'accesso bedrock-agentcore.amazonaws.com come responsabile del servizio.

Errori relativi alla risorsa non trovata

Messaggio di errore Risoluzione

Payment manager not found: {managerId}

Il gestore dei pagamenti specificato non esiste. Verifica l'ID chiamandoListPaymentManagers.

Payment connector not found: connectorId={connectorId}, managerId={managerId}

Il connettore specificato non esiste nel gestore specificato. Verifica entrambi gli ID utilizzandoListPaymentConnectors.

Risorsa non trovata durante CreatePaymentConnector

Il gestore dei pagamenti principale non esiste. Crea prima il gestore dei pagamenti.

Errori di conflitto

Il servizio restituisce un ConflictException quando due richieste modificano la stessa risorsa contemporaneamente o quando si crea una risorsa già esistente. Riprova la richiesta . Supporto operativo di creazione e aggiornamento clientToken per tentativi sicuri.

Errori relativi alle quote di servizio

Il servizio ritorna "{limitType} limit exceeded for account {accountId}" quando raggiungi il numero massimo di gestori o connettori di pagamento per il tuo account. Elimina le risorse inutilizzate o contatta il AWS Supporto per richiedere un aumento del limite.

Errori di limitazione

Il servizio "Rate exceeded" viene restituito quando la frequenza delle richieste supera il limite consentito. Implementa il backoff esponenziale con jitter nella logica dei tentativi. Se raggiungi costantemente i limiti, contatta l' AWS assistenza.

Errori nell'elaborazione dei pagamenti

Se un fornitore di servizi di pagamento esterno rifiuta la richiesta di firma, il servizio restituisce un AccessDeniedException orValidationException. La tabella seguente elenca gli errori più comuni e le relative risoluzioni.

Messaggio di errore Risoluzione

Delegated signing grant is not active for the end user wallet. Please redirect end user to the WalletHub to grant the permissions.

Non hai concesso l'autorizzazione di delega che consente al tuo agente di firmare le transazioni per tuo conto o l'hai precedentemente revocata. Per risolvere:

  1. Recupera l' WalletHub URL dal corpo della GetPaymentInstrument risposta CreatePaymentInstrument o dalla risposta ()paymentInstrumentDetails.redirectUrl.

  2. Reindirizza l'utente a. WalletHub

  3. Accedi e concedi le autorizzazioni di firma all'agente.

Per ulteriori informazioni su un'implementazione frontend che gestisce il flusso di concessione delle deleghe, consulta il AgentCore modello Coinbase sul sito web. GitHub Per ulteriori informazioni sul finanziamento del portafoglio, consulta Finanziamento del portafoglio.

Delegated signing is not enabled for your Coinbase project. Please enable delegated signing in your Coinbase project policies.

Nel tuo progetto Coinbase Developer Platform non è configurata la firma delegata. Per risolvere:

  1. Accedi alla Coinbase Developer Platform sul sito web di Coinbase.

  2. Vai alle impostazioni delle politiche del tuo progetto.

  3. Abilita l'interruttore Firma delegata.

Devi completare questo passaggio prima che il tuo agente possa firmare le transazioni per conto degli utenti.

Privy credentials are invalid. Please verify the credential configuration.

Il tuo fornitore di credenziali ha chiavi di autorizzazione del portafoglio Privy non valide o scadute. Per risolvere:

  1. Accedi alla Privy Dashboard sul sito Web di Privy.

  2. Accedi alle impostazioni dell'app e verifica che le chiavi di autorizzazione siano attive.

  3. Aggiorna il fornitore di credenziali in AgentCore Identity con le chiavi correnti. Per fare ciò, chiama UpdatePaymentConnector o aggiorna il segreto in AWS Secrets Manager.

Per ulteriori informazioni sulla configurazione delle credenziali, consulta Privy AgentCore SDK sul sito Web. GitHub

Errori server

Il servizio restituisce "Something went wrong in processing your request" gli errori interni. Riprova la richiesta dopo un breve ritardo. Se l'errore persiste, contatta il AWS Supporto con l'ID della richiesta dall'intestazione della x-amzn-requestid risposta.