View a markdown version of this page

Solução de problemas de AgentCore pagamentos - Amazon Bedrock AgentCore
Erros de validaçãoErros de permissãoErros de recurso não encontradoErros de conflitoErros de cota de serviçoErros de controle de utilizaçãoErros no processamento do pagamentoErros de servidor

Solução de problemas de AgentCore pagamentos

Esta seção fornece soluções para erros comuns ao usar AgentCore pagamentos do AWS Amazon Bedrock.

Erros de validação

Ao criar ou atualizar recursos de pagamento, o serviço retorna umValidationException. A tabela a seguir lista os erros comuns de validação e suas resoluções.

Mensagem de erro Resolução

roleArn must contain a valid account ID

roleArnDeve ser um ARN de função do IAM válido com um ID de conta de 12 dígitos. Verifique o formato:arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

O ID da conta roleArn deve corresponder à conta do chamador. Cross-account funções não são suportadas.

Invalid role ARN: {roleArn}

O não roleArn pôde ser analisado. Verifique o formato ARN.

credentialProviderConfigurations list cannot be empty

Forneça pelo menos uma configuração de provedor de credenciais ao criar ou atualizar um conector de pagamento.

credentialProviderArn is required but not found in the request

Cada configuração do provedor de credenciais deve incluir umcredentialProviderArn. Crie um primeiro usando Criar um provedor de credenciais.

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

A variante de configuração do provedor de credenciais deve corresponder ao tipo de conector. Por exemplo, um CoinbaseCDP conector requer a coinbaseCDP configuração, nãostripePrivy.

As restrições de nomenclatura de campo também são impostas:

  • Os nomes dos gerentes de pagamento devem começar com uma letra e conter somente caracteres alfanuméricos (máximo de 48 caracteres).

  • Os nomes dos conectores de pagamento seguem as mesmas regras, mas também permitem sublinhados.

  • As descrições permitem caracteres alfanuméricos e espaços (máximo de 4096 caracteres).

Erros de permissão

Mensagem de erro Resolução

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

Sua conta foi restrita. Entre em contato com o AWS Support para resolver.

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

Sua conta está em um estado de acesso limitado. As operações de leitura e listagem são permitidas, mas as operações de criação e atualização são restritas até que a restrição seja resolvida.

Falhas de autorização do IAM SigV4

Certifique-se de que o responsável pela chamada tenha as bedrock-agentcore: permissões apropriadas. O serviço usa a assinatura SigV4 com o nome da bedrock-agentcore assinatura.

PassRole falhas

Ao fornecer umroleArn, o chamador deve ter iam:PassRole permissão para a função. A política de confiança da função deve permitir bedrock-agentcore.amazonaws.com como diretor de serviço.

Erros de recurso não encontrado

Mensagem de erro Resolução

Payment manager not found: {managerId}

O gerente de pagamento especificado não existe. Verifique o ID ligandoListPaymentManagers.

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

O conector especificado não existe no gerenciador fornecido. Verifique os dois IDs usandoListPaymentConnectors.

Recurso não encontrado durante CreatePaymentConnector

O gerente de pagamento principal não existe. Crie primeiro o gerenciador de pagamentos.

Erros de conflito

O serviço retorna um ConflictException quando duas solicitações modificam o mesmo recurso ao mesmo tempo ou ao criar um recurso que já existe. Repetir a solicitação . Suporte de operações de criação e atualização clientToken para novas tentativas seguras.

Erros de cota de serviço

O serviço retorna "{limitType} limit exceeded for account {accountId}" quando você atinge o número máximo de gerenciadores ou conectores de pagamento para sua conta. Exclua recursos não utilizados ou entre em contato com o AWS Support para solicitar um aumento de limite.

Erros de controle de utilização

O serviço retorna "Rate exceeded" quando a taxa de solicitação excede o limite permitido. Implemente um recuo exponencial com instabilidade em sua lógica de repetição. Se você atingir os limites de forma consistente, entre em contato com o AWS Support.

Erros no processamento do pagamento

Se um provedor de pagamento externo rejeitar a solicitação de assinatura, o serviço retornará um AccessDeniedException ouValidationException. A tabela a seguir lista os erros comuns e suas resoluções.

Mensagem de erro Resolução

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

Você não concedeu à delegação a permissão que permite que seu agente assine transações em seu nome, ou você a revogou anteriormente. Para resolver:

  1. Recupere o WalletHub URL do corpo da GetPaymentInstrument resposta CreatePaymentInstrument ou (paymentInstrumentDetails.redirectUrl).

  2. Redirecione o usuário para o. WalletHub

  3. Faça login e conceda permissões de assinatura ao agente.

Para obter mais informações sobre uma implementação de front-end que lida com o fluxo de concessão de delegação, consulte o AgentCore modelo da Coinbase no site. GitHub Para obter mais informações sobre como financiar a carteira, consulte Financiando a carteira.

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

Seu projeto da Coinbase Developer Platform não tem a assinatura delegada configurada. Para resolver:

  1. Faça login na Plataforma de Desenvolvedores da Coinbase no site da Coinbase.

  2. Navegue até as configurações de Políticas do seu projeto.

  3. Ative a opção Assinatura delegada.

Você deve concluir essa etapa antes que seu agente possa assinar transações em nome dos usuários.

Privy credentials are invalid. Please verify the credential configuration.

Seu provedor de credenciais tem chaves de autorização de carteira Privy inválidas ou expiradas. Para resolver:

  1. Faça login no Painel Privy no site da Privy.

  2. Navegue até as configurações do seu aplicativo e verifique se as chaves de autorização estão ativas.

  3. Atualize o provedor de credenciais no AgentCore Identity com as chaves atuais. Para fazer isso, ligue UpdatePaymentConnector ou atualize o segredo no AWS Secrets Manager.

Para obter mais informações sobre a configuração de credenciais, consulte o Privy AgentCore SDK no site. GitHub

Erros de servidor

O serviço retorna em "Something went wrong in processing your request" caso de erros internos. Tente fazer a solicitação novamente após um breve atraso. Se o erro persistir, entre em contato com o AWS Support com o ID da solicitação no cabeçalho da x-amzn-requestid resposta.