Concetti fondamentali per AgentCore i pagamenti
Personaggi chiave
Le persone che interagiscono con AgentCore i pagamenti possono variare da un'organizzazione all'altra. Di seguito sono riportati i personaggi generali presenti nelle diverse organizzazioni.
-
Sviluppatore di agenti: gli sviluppatori di agenti creano agenti di intelligenza artificiale che eseguono pagamenti in microtransazione per accedere alle API a pagamento, ai server MCP e ai contenuti web. Si occupano di attività amministrative come la configurazione dei limiti di spesa, il monitoraggio delle attività di pagamento e la gestione delle politiche relative alle credenziali dei portafogli. Eseguono una sola configurazione del piano di controllo (creazione PaymentManagers e PaymentConnectors) e integrano il codice dell'agente con l'SDK per i AgentCore pagamenti o le API del piano dati per consentire l'esecuzione autonoma dei pagamenti.
-
Utente finale: gli utenti finali interagiscono con l'agente per raggiungere un obiettivo specifico. Possono ricaricare il saldo degli agenti tramite stablecoin basate su criptovalute o metodi di pagamento tradizionali come carte di credito (disponibilità limitata a causa delle restrizioni geografiche), carte di debito, Apple Pay, Google Pay o ACH, in modo che gli agenti possano eseguire transazioni per loro conto, con autorizzazioni di spesa, limiti di spesa configurabili e piena trasparenza sull'utilizzo dei fondi.
-
Commerciante: i commercianti sono fornitori di API, fornitori di contenuti e operatori di servizi che monetizzano le proprie offerte tramite modelli pay-per-use. Stabiliscono i prezzi, accettano pagamenti x402 e forniscono il contenuto o il servizio richiesti dopo la conferma del pagamento.
Concetti chiave
PaymentManager
A PaymentManager è la risorsa di primo livello che crei nel tuo AWS account per coordinare le operazioni di pagamento dei tuoi agenti di intelligenza artificiale. Ciascuna PaymentManager ha un nome, una configurazione di autorizzazione che controlla il modo in cui gli agenti si autenticano sul piano dati (AWS_IAMoCUSTOM_JWT) e un ruolo IAM che il servizio assume in fase di esecuzione. Quando crei un PaymentManager, AgentCore payments fornisce un'identità del carico di lavoro corrispondente in Identity. AgentCore Ciascuno PaymentManager ha un identificatore e un ARN univoci e gestisce una o PaymentConnectors più risorse secondarie.
Il modo in cui organizzi le tue PaymentManagers dipende dalle tue esigenze. Ad esempio, utilizzate applicazioni separate PaymentManagers per agenti diversi, ambienti diversi (produzione, gestione temporanea, sviluppo) o team diversi all'interno dell'organizzazione.
PaymentConnector
A PaymentConnector integra il tuo PaymentManager con un fornitore di servizi di pagamento esterno. Ogni connettore fa riferimento a un fornitore di credenziali memorizzato in AgentCore Identity, garantendo che credenziali sensibili come chiavi API e segreti del portafoglio non vengano mai trasmesse direttamente all'API Payments. Le credenziali vengono archiviate in AWS Secrets Manager tramite AgentCore Identity e referenziate da ARN. A PaymentConnector appartiene esattamente a uno e uno PaymentManager PaymentManager può avere più connettori (ad esempio, uno per Coinbase e un altro per Stripe). AgentCore payments supporta i seguenti tipi di connettori:
-
CoinbaseCDP
: si collega alla piattaforma di sviluppo Coinbase per le operazioni di portafoglio crittografico. -
StripePrivy
— Si connette a Stripe con l'infrastruttura del portafoglio Privy.
PaymentSession
A PaymentSession è un contesto di pagamento mirato che tiene traccia delle spese per l'interazione con un singolo agente. Ogni sessione ha una durata di scadenza configurabile e può facoltativamente includere limiti di spesa (maxSpendAmount,currency) che impongono limiti di pagamento. Quando la sessione scade o viene raggiunto il limite di pagamento, ulteriori richieste di pagamento all'interno di quella sessione vengono rifiutate. Se la firma di un pagamento fallisce dopo una detrazione, l'importo viene automaticamente ripristinato.
PaymentInstrument
A PaymentInstrument rappresenta un portafoglio crittografico incorporato che un agente utilizza per pagare i commercianti per conto di un utente. Ogni strumento è associato a una rete blockchain specifica e presenta uno dei seguenti stati:INITIATED, ACTIVEFAILED, o. DELETED Poiché lo stesso indirizzo di portafoglio non può essere utilizzato su più catene, gli sviluppatori mantengono strumenti separati per ogni rete supportata (ad esempio, Ethereum e Solana). L'unico tipo di strumento supportato è. EMBEDDED_CRYPTO_WALLET
PaymentCredentialProvider
A PaymentCredentialProvider è un fornitore di credenziali specializzato in AgentCore Identity progettato per i protocolli di pagamento in criptovalute. Archivia in modo sicuro le credenziali specifiche del fornitore (come le chiavi API CDP di Coinbase e i segreti del portafoglio, o le credenziali e le chiavi di autorizzazione dell'app Privy) in Secrets Manager. AWS In fase di esecuzione, il servizio Payments recupera i token di autenticazione tramite l'API Identity data plane. AgentCore GetResourcePaymentToken Ciascuno PaymentConnector mantiene una mappatura 1:1 con un. PaymentCredentialProvider
protocollo x402
Il protocollo x402 è uno standard di HTTP-native pagamento aperto che riutilizza il codice di stato HTTP 402 per pagamenti diretti e programmatici. Quando un agente richiede una risorsa a pagamento, il merchant risponde con HTTP, 402 Payment Required incluso un payload di pagamento che specifica l'importo, il destinatario, la risorsa e la rete. L'agente firma il pagamento e riprova la richiesta con la prova firmata nell'intestazione. X-PAYMENT Il venditore verifica il pagamento e consegna il contenuto.
Microtransazione
Una microtransazione è un pagamento di piccolo importo (spesso in centesimi) per una singola chiamata API, la chiamata a uno strumento o l'accesso ai contenuti. I sistemi di pagamento tradizionali hanno costi di transazione minimi, il che li rende inefficienti per i pagamenti inferiori a 0,01 USD. AgentCore payments utilizza criptovalute e stablecoin per consentire micropagamenti convenienti.
