Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Financez le portefeuille et accordez des autorisations aux agents

Après avoir créé un instrument de paiement, l'utilisateur final doit approvisionner le portefeuille avec des USD Coin (USDC) et autoriser l'agent à signer des transactions. Tant que l'utilisateur final n'a pas terminé les deux étapes, l'opération de paiement échoue à une exception près du côté client.

Votre utilisation de fournisseurs de portefeuilles tiers est régie par leurs conditions. AWS n'a pas la garde ni le contrôle des portefeuilles, des fonds, des actifs numériques ou des clés privées associées et n'en est pas responsable. Vous êtes seul responsable de toute transaction, litige ou responsabilité en matière de paiement découlant de votre utilisation des AgentCore paiements, et de la mise en œuvre de mesures de protection appropriées (telles que la supervision humaine) en fonction de votre cas d'utilisation. Pour plus de détails, consultez la section 50.15 (Amazon Bedrock AgentCore Payments) des Conditions de AWS service.

Coinbase CDP

Lorsque vous créez un instrument de paiement avec le connecteur Coinbase CDP, l'CreatePaymentInstrumentAPI renvoie un redirectUrl pointeur vers Coinbase WalletHub, un portail permettant d'accorder des autorisations aux agents et de financer le portefeuille. Dirigez l'utilisateur final vers cette URL pour approvisionner son portefeuille et accorder des autorisations aux agents à partir d'une interface unique.

Utilisez l' WalletHub URL

Le redirectUrl résultat de la CreatePaymentInstrument réponse ouvre la Coinbase WalletHub, où l'utilisateur final peut approvisionner le portefeuille et accorder des autorisations de signature à l'agent.

instrument = dp_client.create_payment_instrument(
    userId="test-user-123",
    paymentManagerArn=PAYMENT_MANAGER_ARN,
    paymentConnectorId=PAYMENT_CONNECTOR_ID,
    paymentInstrumentType="EMBEDDED_CRYPTO_WALLET",
    paymentInstrumentDetails={
        "embeddedCryptoWallet": {
            "network": "ETHEREUM",
            "linkedAccounts": [{"email": {"emailAddress": "user@example.com"}}]
        }
    },
    clientToken=str(uuid.uuid4()),
)

# Direct the end user to this URL
wallet_hub_url = instrument["paymentInstrumentDetails"]["redirectUrl"]
print(f"Open the WalletHub: {wallet_hub_url}")

Vous pouvez également déployer le AgentCore modèle Coinbase en GitHub tant que Next.js frontend auto-hébergé qui fournit les mêmes fonctionnalités de financement et d'autorisations avec une interface utilisateur personnalisable. Consultez (Alternative) Déployez le frontend auto-hébergé les instructions de configuration.

Financez le portefeuille

À partir du WalletHub (ou du frontend auto-hébergé), l'utilisateur final peut approvisionner son portefeuille en utilisant l'une des méthodes suivantes :

Pour les environnements testnet, approvisionnez le portefeuille avec testnet USDC depuis le robinet Circle USDC.

Accorder des autorisations aux agents

Les autorisations des agents dans Coinbase CDP utilisent une délégation à l'échelle du portefeuille  : chaque portefeuille reçoit sa propre autorisation indépendante et limitée dans le temps de la part de l'utilisateur final, qui autorise l'agent à signer des transactions.

Une fois accordée, l'agent peut signer des transactions pour le compte des portefeuilles de l'utilisateur final jusqu'à l'expiration de la subvention. L'utilisateur final peut révoquer ses autorisations à tout moment depuis le même tableau de bord. Une fois la subvention accordée, passez à Créer une session de paiement.

Révoquer les autorisations

L'utilisateur final peut révoquer l'accès des agents à n'importe quel portefeuille à tout moment depuis la section des autorisations du tableau de WalletHub bord frontal. Après la révocation, l'agent ne peut plus signer de transactions pour ce portefeuille tant que l'utilisateur n'a pas accordé de nouvelles autorisations.

(Alternative) Déployez le frontend auto-hébergé

Si vous avez besoin d'une interface utilisateur personnalisable au lieu de l'interface hébergée WalletHub, déployez le AgentCore modèle Coinbase en tant qu'application auto-hébergée Next.js .

Le frontend auto-hébergé fournit les mêmes flux de financement et d'octroi d'autorisations décrits ci-dessus, avec un contrôle total sur le style et l'expérience utilisateur.

Stripe (Privy)

Le AgentCore SDK Privy GitHub est une interface de Next.js référence qui permet aux utilisateurs finaux de s'authentifier, de financer des portefeuilles et d'accorder des autorisations aux agents via un flux de configuration guidé.

Déployez le frontend

Financez le portefeuille

Lorsque l'utilisateur final s'authentifie via le frontend Privy, des portefeuilles intégrés sont automatiquement créés pour les réseaux Base (EVM) et Solana. L'utilisateur final peut approvisionner son portefeuille en utilisant l'une des méthodes suivantes :

Pour les environnements testnet, approvisionnez le portefeuille avec testnet USDC depuis le robinet Circle USDC.

Accorder des autorisations aux agents

Les autorisations des agents dans Privy utilisent des signataires de session (également appelés clés d'autorisation) : l'utilisateur final enregistre la clé d'autorisation de l'agent sur chaque portefeuille intégré, ce qui permet à l'agent de signer des transactions sans approbation par transaction.

Le frontend appelle addSessionSigners depuis le SDK Privy pour enregistrer la clé d'autorisation de l'agent sur chaque portefeuille intégré. L'opération est idempotente : si le signataire est déjà enregistré, aucune erreur n'est renvoyée.

Une fois connecté, l'agent peut signer des transactions pour le compte des portefeuilles de l'utilisateur. Les autorisations sont maintenues jusqu'à leur révocation explicite.

(Facultatif) Vérifier la connexion de l'agent

Le frontend vérifie que les autorisations sont actives en appelant l'API Privy :

GET https://auth.privy.io/api/v1/wallets/{walletId}
Authorization: Basic <base64(appId:appSecret)>

La réponse comprend un additional_signers tableau. Si l'ID d'autorisation configuré apparaît dans ce tableau, l'agent est connecté.

Une fois la subvention accordée, passez à Créer une session de paiement.

Tester avec testnet USDC

Pour le développement et les tests, utilisez les réseaux testnet et financez les portefeuilles avec le test USDC :