# 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 un`ValidationException`. 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` | `roleArn`Deve essere un ARN di ruolo IAM valido con un ID account a 12 cifre. Verifica il formato:. `arn:aws:iam:::role/` | | `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](resource-providers.md). | | `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, non`stripePrivy`. | 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 un`roleArn`, il chiamante deve disporre dell'`iam:PassRole`autorizzazione 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 chiamando`ListPaymentManagers`. | | `Payment connector not found: connectorId={connectorId}, managerId={managerId}` | Il connettore specificato non esiste nel gestore specificato. Verifica entrambi gli ID utilizzando`ListPaymentConnectors`. | | 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` or`ValidationException`. 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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Per ulteriori informazioni su un'implementazione frontend che gestisce il flusso di concessione delle deleghe, consulta il [ AgentCore modello Coinbase sul sito web](https://github.com/coinbase/cdp-agentcore-template). GitHub Per ulteriori informazioni sul finanziamento del portafoglio, consulta [Finanziamento del](payments-how-it-works.md#payments-how-it-works-funding-wallet) 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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
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:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/payments-troubleshooting.html)
Per ulteriori informazioni sulla configurazione delle credenziali, consulta [Privy AgentCore SDK](https://github.com/privy-io/aws-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.