View a markdown version of this page

Problembehebung bei AgentCore Zahlungen - Amazon Grundgestein AgentCore
ValidierungsfehlerFehler bei der GenehmigungFehler „Ressource nicht gefunden“KonfliktfehlerFehler bei den DienstkontingentenDrosselungsfehlerFehler bei der ZahlungsabwicklungServerfehler

Problembehebung bei AgentCore Zahlungen

In diesem Abschnitt finden Sie Lösungen für häufig auftretende Fehler bei der Verwendung von AWS Amazon AgentCore Bedrock-Zahlungen.

Validierungsfehler

Bei der Erstellung oder Aktualisierung von Zahlungsressourcen gibt der Service eine ValidationException zurück. In der folgenden Tabelle sind häufig auftretende Validierungsfehler und deren Lösungen aufgeführt.

Fehlermeldung Auflösung

roleArn must contain a valid account ID

roleArnEs muss sich um einen gültigen IAM-Rollen-ARN mit einer 12-stelligen Konto-ID handeln. Überprüfen Sie das Format:. arn:aws:iam::<accountId>:role/<roleName>

roleArn must belong to your account

Die eingegebene Konto-ID roleArn muss mit dem Konto des Anrufers übereinstimmen. Cross-account Rollen werden nicht unterstützt.

Invalid role ARN: {roleArn}

Das roleArn konnte nicht analysiert werden. Überprüfen Sie das ARN-Format.

credentialProviderConfigurations list cannot be empty

Geben Sie mindestens eine Konfiguration des Anmeldeinformationsanbieters an, wenn Sie einen Zahlungskonnektor erstellen oder aktualisieren.

credentialProviderArn is required but not found in the request

Jede Konfiguration des Anmeldeinformationsanbieters muss eine enthalten. credentialProviderArn Erstellen Sie zuerst einen mit Credential Provider erstellen.

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

Die Konfigurationsvariante des Anmeldeinformationsanbieters muss dem Connectortyp entsprechen. Zum Beispiel erfordert ein CoinbaseCDP Connector die coinbaseCDP Konfiguration, nichtstripePrivy.

Einschränkungen bei der Benennung von Feldern werden ebenfalls durchgesetzt:

  • Namen von Zahlungsmanagern müssen mit einem Buchstaben beginnen und dürfen nur alphanumerische Zeichen (maximal 48 Zeichen) enthalten.

  • Für Namen von Zahlungsverbindern gelten dieselben Regeln, es sind jedoch auch Unterstriche zulässig.

  • Beschreibungen erlauben alphanumerische Zeichen und Leerzeichen (maximal 4096 Zeichen).

Fehler bei der Genehmigung

Fehlermeldung Auflösung

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

Ihr Konto wurde gesperrt. Wenden Sie sich AWS zur Problemlösung an den Support.

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

Ihr Konto befindet sich in einem Zustand mit eingeschränktem Zugriff. Lese- und Listenvorgänge sind zulässig, Erstellungs- und Aktualisierungsvorgänge sind jedoch eingeschränkt, bis die Einschränkung aufgehoben ist.

Fehler bei der IAM-SigV4-Autorisierung

Stellen Sie sicher, dass der aufrufende Principal über die entsprechenden bedrock-agentcore: Berechtigungen verfügt. Der Dienst verwendet die SigV4-Signatur mit dem bedrock-agentcore Signaturnamen.

PassRole Misserfolge

Bei der Bereitstellung von muss der Aufrufer über die iam:PassRole Berechtigung für die Rolle verfügen. roleArn Die Vertrauensrichtlinie der Rolle muss es bedrock-agentcore.amazonaws.com als Dienstprinzipal zulassen.

Fehler „Ressource nicht gefunden“

Fehlermeldung Auflösung

Payment manager not found: {managerId}

Der angegebene Zahlungsmanager ist nicht vorhanden. Überprüfen Sie die ID, indem Sie anrufenListPaymentManagers.

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

Der angegebene Konnektor ist unter dem angegebenen Manager nicht vorhanden. Überprüfen Sie beide IDs mitListPaymentConnectors.

Ressource wurde während nicht gefunden CreatePaymentConnector

Der übergeordnete Zahlungsmanager ist nicht vorhanden. Erstellen Sie zuerst den Zahlungsmanager.

Konfliktfehler

Der Dienst gibt a zurück, ConflictException wenn zwei Anfragen dieselbe Ressource gleichzeitig ändern oder wenn eine Ressource erstellt wird, die bereits vorhanden ist. Wiederholen Sie die Anforderung. Erstellungs- und Aktualisierungsvorgänge unterstützen a clientToken für sichere Wiederholungsversuche.

Fehler bei den Dienstkontingenten

Der Service kehrt zurück"{limitType} limit exceeded for account {accountId}", wenn Sie die maximale Anzahl von Zahlungsmanagern oder Konnektoren für Ihr Konto erreicht haben. Löschen Sie ungenutzte Ressourcen oder wenden Sie sich an den AWS Support, um eine Erhöhung des Limits zu beantragen.

Drosselungsfehler

Der Service kehrt zurück"Rate exceeded", wenn die Anforderungsrate das zulässige Limit überschreitet. Implementieren Sie exponentielles Backoff mit Jitter in Ihre Wiederholungslogik. Wenn Sie ständig an Limits stoßen, wenden Sie sich an den AWS Support.

Fehler bei der Zahlungsabwicklung

Wenn ein externer Zahlungsanbieter die Signaturanfrage ablehnt, gibt der Dienst ein AccessDeniedException Oder ValidationException zurück. In der folgenden Tabelle sind häufig auftretende Fehler und ihre Lösungen aufgeführt.

Fehlermeldung Auflösung

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

Sie haben die Delegierungsberechtigung, die es Ihrem Agenten ermöglicht, Transaktionen in Ihrem Namen zu unterzeichnen, nicht erteilt, oder Sie haben sie zuvor widerrufen. Um dies zu lösen:

  1. Rufen Sie die WalletHub URL aus dem CreatePaymentInstrument oder dem GetPaymentInstrument Antworttext ab (paymentInstrumentDetails.redirectUrl).

  2. Leiten Sie den Benutzer an den weiter WalletHub.

  3. Melden Sie sich an und gewähren Sie dem Agenten Signierberechtigungen.

Weitere Informationen zu einer Frontend-Implementierung, die den Ablauf der Delegationsgewährung abwickelt, finden Sie in der AgentCore Coinbase-Vorlage auf der GitHub Website. Weitere Informationen zur Finanzierung der Brieftasche finden Sie unter Finanzierung der Brieftasche.

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

In Ihrem Coinbase Developer Platform-Projekt ist kein delegiertes Signieren konfiguriert. Um dies zu lösen:

  1. Melden Sie sich auf der Coinbase-Website bei der Coinbase Developer Platform an.

  2. Navigiere zu den Richtlinieneinstellungen deines Projekts.

  3. Aktivieren Sie den Schalter Delegiertes Signieren.

Sie müssen diesen Schritt abschließen, bevor Ihr Agent Transaktionen im Namen von Benutzern signieren kann.

Privy credentials are invalid. Please verify the credential configuration.

Ihr Anmeldeinformationsanbieter hat ungültige oder abgelaufene Privy-Wallet-Autorisierungsschlüssel. Um dies zu lösen:

  1. Melden Sie sich im Privy-Dashboard auf der Privy-Website an.

  2. Navigieren Sie zu den Einstellungen Ihrer App und überprüfen Sie, ob die Autorisierungsschlüssel aktiv sind.

  3. Aktualisieren Sie den Anmeldeinformationsanbieter in AgentCore Identity mit den aktuellen Schlüsseln. Rufen Sie dazu das Secret in AWS Secrets Manager auf UpdatePaymentConnector oder aktualisieren Sie es.

Weitere Informationen zur Konfiguration von Anmeldeinformationen finden Sie im Privy AgentCore SDK auf der GitHub Website.

Serverfehler

Der Dienst kehrt bei internen "Something went wrong in processing your request" Fehlern zurück. Versuchen Sie die Anfrage nach einer kurzen Verzögerung erneut. Wenn der Fehler weiterhin besteht, wenden Sie sich mit der Anforderungs-ID aus dem x-amzn-requestid Antwortheader an den AWS Support.