View a markdown version of this page

Concepts de base pour AgentCore les paiements - Amazon Bedrock AgentCore
Personnages clésConcepts clés

Concepts de base pour AgentCore les paiements

Personnages clés

Les personnes qui interagissent avec les AgentCore paiements peuvent varier d'une organisation à l'autre. Vous trouverez ci-dessous les personnalités générales que l'on retrouve dans les organisations.

Personnages clés pour les paiements AgentCore

  1. Développeur d'agents : les développeurs d'agents créent des agents d'intelligence artificielle qui exécutent des paiements par microtransactions pour accéder à des API payantes, à des serveurs MCP et à du contenu Web. Ils s'occupent de tâches administratives telles que la configuration des garde-fous en matière de dépenses, le suivi des activités de paiement et la gestion des politiques d'identification du portefeuille. Ils configurent un plan de contrôle en une seule fois (création PaymentManagers et PaymentConnectors) et intègrent leur code d'agent au SDK de AgentCore paiement ou aux API du plan de données pour permettre une exécution autonome des paiements.

  2. Utilisateur final : les utilisateurs finaux interagissent avec l'agent pour atteindre un objectif spécifique. Ils peuvent recharger le solde de leurs agents par le biais de pièces stables cryptées ou de méthodes de paiement traditionnelles telles que les cartes de crédit (disponibilité limitée en raison de restrictions géographiques), les cartes de débit, Apple Pay, Google Pay ou ACH, afin que les agents puissent exécuter des transactions en leur nom, avec des autorisations de dépenses, des limites de dépenses configurables et une transparence totale sur la manière dont leurs fonds sont utilisés.

  3. Marchand : les marchands sont des fournisseurs d'API, des fournisseurs de contenu et des opérateurs de services qui monétisent leurs offres par le biais de modèles de paiement à l'utilisation. Ils fixent les prix, acceptent les paiements x402 et fournissent le contenu ou le service demandé après confirmation du paiement.

Concepts clés

AgentCore concepts de base en matière de paiements

PaymentManager

A PaymentManager est la ressource de haut niveau que vous créez dans votre AWS compte pour coordonner les opérations de paiement de vos agents IA. Chacun PaymentManager possède un nom, une configuration d'autorisation qui contrôle la manière dont les agents s'authentifient auprès du plan de données (AWS_IAMouCUSTOM_JWT) et un rôle IAM que le service assume lors de l'exécution. Lorsque vous créez un PaymentManager, AgentCore les paiements fournissent une identité de charge de travail correspondante dans AgentCore Identity. Chacun PaymentManager possède un identifiant et un ARN uniques, et gère une ou plusieurs ressources PaymentConnectors en tant qu'enfants.

La façon dont vous vous organisez PaymentManagers dépend de vos besoins. Par exemple, PaymentManagers séparez-les pour les différentes applications d'agents, les différents environnements (production, développement, développement) ou les différentes équipes au sein de votre organisation.

PaymentConnector

A vous PaymentConnector intègre PaymentManager à un fournisseur de paiement externe. Chaque connecteur fait référence à un fournisseur d'informations d'identification stocké dans AgentCore Identity, ce qui garantit que les informations d'identification sensibles telles que les clés API et les secrets du portefeuille ne sont jamais transmises directement à l'API Payments. Les informations d'identification sont stockées dans AWS Secrets Manager via AgentCore Identity et référencées par l'ARN. A PaymentConnector appartient exactement à un PaymentManager, et un seul PaymentManager peut avoir plusieurs connecteurs (par exemple, un pour Coinbase et un autre pour Stripe). AgentCore payments prend en charge les types de connecteurs suivants :

  1. CoinbaseCDP — Se connecte à la plateforme de développement Coinbase pour les opérations de portefeuille cryptographique.

  2. StripePrivy— Se connecte à Stripe via l'infrastructure de portefeuille Privy.

PaymentSession

A PaymentSession est un contexte de paiement délimité qui permet de suivre les dépenses liées à une interaction avec un seul agent. Chaque session a une durée d'expiration configurable et peut éventuellement inclure des limites de dépenses (maxSpendAmount,currency) qui appliquent les limites de paiement. Lorsque la session expire ou que la limite de paiement est atteinte, les autres demandes de paiement au cours de cette session sont refusées. Si la signature d'un paiement échoue après une déduction, le montant est automatiquement annulé.

PaymentInstrument

A PaymentInstrument représente un portefeuille crypté intégré qu'un agent utilise pour payer les commerçants au nom d'un utilisateur. Chaque instrument est associé à un réseau de blockchain spécifique et possède l'un des statuts suivants :INITIATED, ACTIVEFAILED, ouDELETED. Comme la même adresse de portefeuille ne peut pas être utilisée entre les chaînes, les développeurs gèrent des instruments distincts pour chaque réseau pris en charge (par exemple, Ethereum et Solana). Le seul type d'instrument pris en charge estEMBEDDED_CRYPTO_WALLET.

PaymentCredentialProvider

A PaymentCredentialProvider est un fournisseur d'informations d'identification spécialisé dans AgentCore Identity conçu pour les protocoles de paiement par cryptomonnaies. Il stocke en toute sécurité les informations d'identification spécifiques au fournisseur (telles que les clés API Coinbase CDP et les secrets du portefeuille, ou les informations d'identification et les clés d'autorisation de l'application Privy) dans Secrets Manager. AWS Au moment de l'exécution, le service Payments récupère les jetons d'authentification via l'API du plan de GetResourcePaymentToken données AgentCore d'identité. Chacun PaymentConnector gère un mappage 1:1 avec un PaymentCredentialProvider.

protocole x402

Le protocole x402 est une norme de HTTP-native paiement ouverte qui réutilise le code de statut HTTP 402 pour les paiements programmatiques directs. Lorsqu'un agent demande une ressource payante, le commerçant répond par HTTP, 402 Payment Required y compris une charge utile de paiement qui spécifie le montant, le destinataire, l'actif et le réseau. L'agent signe le paiement et réessaie la demande avec la preuve signée dans l'X-PAYMENTen-tête. Le commerçant vérifie le paiement et fournit le contenu.

Microtransaction

Une microtransaction est un paiement de faible valeur (souvent en centimes) pour un appel d'API individuel, une invocation d'outil ou un accès au contenu. Les systèmes de paiement traditionnels ont des coûts de transaction minimaux, ce qui les rend inefficaces pour les paiements inférieurs à 0,01$. AgentCore payments utilise des cryptomonnaies et des stablecoins pour permettre des micropaiements rentables.