Conceptos básicos para AgentCore los pagos
Personajes clave
Las personas que interactúan con AgentCore los pagos pueden variar de una organización a otra. Las siguientes son las personas generales que se encuentran en todas las organizaciones.
-
Desarrollador de agentes: los desarrolladores de agentes crean agentes de inteligencia artificial que ejecutan pagos por microtransacciones para acceder a las API de pago, los servidores MCP y el contenido web. Se encargan de tareas administrativas, como configurar los límites de gasto, supervisar la actividad de pago y gestionar las políticas de credenciales de los monederos. Configuran el plano de control una sola vez (crean PaymentManagers y PaymentConnectors) e integran su código de agente con el SDK de AgentCore pagos o las API del plano de datos para permitir la ejecución autónoma de los pagos.
-
Usuario final: los usuarios finales interactúan con el agente para lograr un objetivo específico. Pueden recargar el saldo del agente mediante monedas estables basadas en criptomonedas o mediante métodos de pago tradicionales, como tarjetas de crédito (disponibilidad limitada debido a restricciones geográficas), tarjetas de débito, Apple Pay, Google Pay o ACH, para que los agentes puedan ejecutar transacciones en su nombre, con permisos de gasto, límites de gasto configurables y total transparencia en cuanto al uso de sus fondos.
-
Comerciante: los comerciantes son proveedores de API, proveedores de contenido y operadores de servicios que monetizan sus ofertas mediante modelos de pago por uso. Fijan los precios, aceptan pagos de 402 veces al día y entregan el contenido o servicio solicitado tras la confirmación del pago.
Conceptos clave
PaymentManager
A PaymentManager es el recurso de nivel superior que creas en tu AWS cuenta para coordinar las operaciones de pago para tus agentes de IA. Cada uno PaymentManager tiene un nombre, una configuración de autorizador que controla la forma en que los agentes se autentican en el plano de datos (AWS_IAMoCUSTOM_JWT) y una función de IAM que el servicio asume en tiempo de ejecución. Al crear una PaymentManager, AgentCore Payments aprovisiona la identidad de carga de trabajo correspondiente en Identity. AgentCore Cada uno PaymentManager tiene un identificador y un ARN únicos, y administra uno o más PaymentConnectors como recursos secundarios.
La forma en que los organice PaymentManagers depende de sus necesidades. Por ejemplo, separe PaymentManagers para diferentes aplicaciones de agentes, diferentes entornos (producción, puesta en escena, desarrollo) o diferentes equipos dentro de su organización.
PaymentConnector
A lo PaymentConnector integra PaymentManager con un proveedor de pagos externo. Cada conector hace referencia a un proveedor de credenciales almacenado en AgentCore Identity, lo que garantiza que las credenciales confidenciales, como las claves de API y los secretos del monedero, nunca se pasen directamente a la API de pagos. Las credenciales se almacenan en AWS Secrets Manager a través de AgentCore Identity y se hace referencia a ellas mediante el ARN. A PaymentConnector pertenece exactamente a uno PaymentManager, y uno solo PaymentManager puede tener varios conectores (por ejemplo, uno para Coinbase y otro para Stripe). AgentCore payments admite los siguientes tipos de conectores:
-
CoinbaseCDP
: se conecta a la plataforma de desarrolladores de Coinbase para realizar operaciones con monederos criptográficos. -
StripePrivy
— Se conecta a Stripe con la infraestructura de monedero privado.
PaymentSession
A PaymentSession es un contexto de pago limitado que hace un seguimiento de los gastos de una interacción con un solo agente. Cada sesión tiene una duración de caducidad configurable y, de forma opcional, puede incluir límites de gasto (maxSpendAmount,currency) que imponen límites de pago. Cuando la sesión caduca o se alcanza el límite de pago, se rechazan las demás solicitudes de pago dentro de esa sesión. Si se produce un error al firmar un pago tras efectuar una deducción, el importe se devolverá automáticamente.
PaymentInstrument
A PaymentInstrument representa una cartera criptográfica integrada que un agente utiliza para pagar a los comerciantes en nombre de un usuario. Cada instrumento está asociado a una red de cadena de bloques específica y tiene uno de los siguientes estados:INITIATED, ACTIVEFAILED, oDELETED. Como no se puede usar la misma dirección de cartera en todas las cadenas, los desarrolladores mantienen instrumentos separados para cada red compatible (por ejemplo, Ethereum y Solana). El único tipo de instrumento compatible esEMBEDDED_CRYPTO_WALLET.
PaymentCredentialProvider
A PaymentCredentialProvider es un proveedor de credenciales especializado en AgentCore Identity diseñado para protocolos de pago en criptomonedas. Almacena de forma segura las credenciales específicas del proveedor (como las claves de la API CDP de Coinbase y los secretos de la cartera, o las credenciales y claves de autorización de la aplicación Privy) en Secrets Manager. AWS En tiempo de ejecución, el servicio de pagos recupera los tokens de autenticación a través de la API del plano de datos de Identity. AgentCore GetResourcePaymentToken Cada uno PaymentConnector mantiene un mapeo 1:1 con un PaymentCredentialProvider.
protocolo x402
El protocolo x402 es un estándar de HTTP-native pago abierto que reutiliza el código de estado HTTP 402 para pagos directos y programáticos. Cuando un agente solicita un recurso de pago, el comerciante responde con HTTP, que 402 Payment Required incluye una carga útil de pago que especifica el importe, el destinatario, el activo y la red. El agente firma el pago y vuelve a intentar la solicitud con el comprobante firmado en el X-PAYMENT encabezado. El vendedor verifica el pago y entrega el contenido.
Microtransacción
Una microtransacción es un pago de bajo valor (a menudo en centavos) por una llamada individual a la API, la invocación de una herramienta o el acceso a un contenido. Los sistemas de pago tradicionales tienen costos de transacción mínimos, lo que los hace ineficientes para pagos de menos de 0,01$. AgentCore Los pagos utilizan criptomonedas y monedas estables para permitir micropagos rentables.
