View a markdown version of this page

AgentCore 결제 문제 해결 - Amazon Bedrock AgentCore
유효성 검사 오류권한 오류리소스를 찾을 수 없음 오류충돌 오류서비스 할당량 오류제한 오류결제 처리 오류서버 오류

AgentCore 결제 문제 해결

이 섹션에서는 AWS Amazon Bedrock AgentCore 결제를 사용할 때 발생하는 일반적인 오류에 대한 솔루션을 제공합니다.

유효성 검사 오류

결제 리소스를 생성하거나 업데이트할 때 서비스는를 반환합니다ValidationException. 다음 표에는 일반적인 검증 오류와 해결 방법이 나와 있습니다.

오류 메시지 해결 방법

roleArn must contain a valid account ID

는 12자리 계정 ID가 있는 유효한 IAM 역할 ARN이어야 roleArn 합니다. 형식을 확인합니다arn:aws:iam::<accountId>:role/<roleName>.

roleArn must belong to your account

의 계정 ID는 호출자의 계정과 일치해야 roleArn 합니다. 교차 계정 역할은 지원되지 않습니다.

Invalid role ARN: {roleArn}

를 구문 분석할 수 roleArn 없습니다. ARN 형식을 확인합니다.

credentialProviderConfigurations list cannot be empty

결제 커넥터를 생성하거나 업데이트할 때 하나 이상의 자격 증명 공급자 구성을 제공합니다.

credentialProviderArn is required but not found in the request

각 자격 증명 공급자 구성에는가 포함되어야 합니다credentialProviderArn. 자격 증명 공급자 생성을 사용하여 먼저 하나를 생성합니다.

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

자격 증명 공급자 구성 변형은 커넥터 유형과 일치해야 합니다. 예를 들어 CoinbaseCDP 커넥터에는가 아닌 coinbaseCDP 구성이 필요합니다stripePrivy.

필드 이름 지정 제약 조건도 적용됩니다.

  • 결제 관리자 이름은 문자로 시작해야 하며 영숫자(최대 48자)만 포함해야 합니다.

  • 결제 커넥터 이름은 동일한 규칙을 따르지만 밑줄도 허용합니다.

  • 설명은 영숫자와 공백(최대 4096자)을 허용합니다.

권한 오류

오류 메시지 해결 방법

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

계정이 제한되었습니다. 해결하려면 AWS Support에 문의하세요.

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

계정이 제한된 액세스 상태입니다. 읽기 및 나열 작업은 허용되지만 제한이 해결될 때까지 생성 및 업데이트 작업은 제한됩니다.

IAM SigV4 권한 부여 실패

호출 보안 주체에 적절한 bedrock-agentcore: 권한이 있는지 확인합니다. 서비스는 서명 이름과 함께 SigV4 bedrock-agentcore 서명을 사용합니다.

PassRole 실패

를 제공할 때 호출roleArn자는 역할에 대한 iam:PassRole 권한이 있어야 합니다. 역할의 신뢰 정책은를 서비스 보안 주체bedrock-agentcore.amazonaws.com로 허용해야 합니다.

리소스를 찾을 수 없음 오류

오류 메시지 해결 방법

Payment manager not found: {managerId}

지정된 결제 관리자가 존재하지 않습니다. 를 호출하여 ID를 확인합니다ListPaymentManagers.

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

지정된 관리자 아래에 지정된 커넥터가 없습니다. IDs를 모두 확인합니다ListPaymentConnectors.

에서 리소스를 찾을 수 없음 CreatePaymentConnector

상위 결제 관리자가 존재하지 않습니다. 먼저 결제 관리자를 생성합니다.

충돌 오류

서비스는 ConflictException 두 요청이 동시에 동일한 리소스를 수정하거나 이미 존재하는 리소스를 생성할 때를 반환합니다. 요청을 다시 시도하세요. 생성 및 업데이트 작업은 안전한 재시도를 clientToken 위해를 지원합니다.

서비스 할당량 오류

계정의 최대 결제 관리자 또는 커넥터 수에 도달"{limitType} limit exceeded for account {accountId}"하면 서비스가를 반환합니다. 미사용 리소스를 삭제하거나 AWS Support에 문의하여 한도 증가를 요청하세요.

제한 오류

요청 속도가 허용 한도를 초과"Rate exceeded"하면 서비스가를 반환합니다. 재시도 로직에서 지터를 사용하여 지수 백오프를 구현합니다. 한도에 지속적으로 도달하면 AWS Support에 문의하십시오.

결제 처리 오류

외부 결제 공급자가 서명 요청을 거부하면 서비스는 AccessDeniedException 또는를 반환합니다ValidationException. 다음 표에는 일반적인 오류와 해결 방법이 나와 있습니다.

오류 메시지 해결 방법

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

에이전트가 사용자를 대신하여 트랜잭션에 서명하도록 허용하는 위임 권한을 부여하지 않았거나 이전에 트랜잭션을 취소했습니다. 이 문제를 해결하려면:

  1. CreatePaymentInstrument 또는 GetPaymentInstrument 응답 본문()에서 WalletHub URL을 검색합니다paymentInstrumentDetails.redirectUrl.

  2. 사용자를 WalletHub로 리디렉션합니다.

  3. 로그인하고 에이전트에 서명 권한을 부여합니다.

위임 권한 부여 흐름을 처리하는 프런트엔드 구현에 대한 자세한 내용은 GitHub 웹 사이트의 Coinbase AgentCore 템플릿을 참조하세요. Wallet 자금 조달에 대한 자세한 내용은 Wallet 자금 조달을 참조하세요.

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

Coinbase 개발자 플랫폼 프로젝트에 위임된 서명이 구성되어 있지 않습니다. 이 문제를 해결하려면:

  1. Coinbase 웹 사이트에서 Coinbase 개발자 플랫폼에 로그인합니다.

  2. 프로젝트의 정책 설정으로 이동합니다.

  3. 위임 서명 토글을 활성화합니다.

에이전트가 사용자를 대신하여 트랜잭션에 서명하려면 먼저이 단계를 완료해야 합니다.

Privy credentials are invalid. Please verify the credential configuration.

자격 증명 공급자에 유효하지 않거나 만료된 Privy wallet 권한 부여 키가 있습니다. 이 문제를 해결하려면:

  1. Privy 웹 사이트의 Privy Dashboard에 로그인합니다.

  2. 앱 설정으로 이동하여 권한 부여 키가 활성 상태인지 확인합니다.

  3. AgentCore Identity의 자격 증명 공급자를 현재 키로 업데이트합니다. 이렇게 하려면 AWS Secrets Manager에서 보안 암호를 호출UpdatePaymentConnector하거나 업데이트합니다.

자격 증명 구성에 대한 자세한 내용은 GitHub 웹 사이트의 Privy AgentCore SDK를 참조하세요.

서버 오류

서비스는 내부 오류"Something went wrong in processing your request"에 대해를 반환합니다. 잠시 후 요청을 다시 시도합니다. 오류가 지속되면 x-amzn-requestid 응답 헤더의 요청 ID로 AWS Support에 문의하세요.