Extensión A2A x402: monetización para agentes de IA

La emergencia del comercio entre máquinas (M2M)

La especificación del protocolo A2A estableció cómo los agentes anuncian capacidades e intercambian tareas a través de fronteras corporativas. Pero a medida que maduran los ecosistemas multiagente, surge una pregunta crítica: ¿cómo monetizan los proveedores de servicios los agentes de alto valor?

Piense en un agente especializado en auditoría legal o en un modelo de análisis de plegamiento de proteínas. El operador no puede ofrecer acceso gratuito ilimitado a agentes llamantes arbitrarios de todo Internet, ni puede pedirle a un agente cliente autónomo que rellene un formulario de pago interactivo.

Lo que los sistemas autónomos necesitan es un pago programático y legible por máquinas:

• El agente llamante conoce el precio antes de comprometerse con el trabajo.
• El agente receptor indica qué aceptará: una red, un activo, un importe y una dirección.
• El pago se verifica y se liquida antes de entregar el trabajo, o a la vez que este.

¿Qué es la extensión x402?

Dos cosas comparten el nombre, y es fácil confundirlas.

x402 es un protocolo de pago abierto, especificado en el repositorio de x402, que revive HTTP 402 Payment Required. Un servidor responde a una solicitud sin pagar con sus requisitos de pago; el cliente firma una autorización de pago y reintenta; un facilitator verifica la autorización y la liquida on-chain. Sobre HTTP simple, los requisitos viajan en una cabecera de respuesta PAYMENT-REQUIRED y el pago firmado en una cabecera de solicitud PAYMENT-SIGNATURE.

La extensión A2A x402, desarrollada en el repositorio google-agentic-commerce/a2a-x402, es x402 transportado sobre A2A. Usa el mecanismo estándar de extensiones de la especificación base a2aproject/A2A, de modo que nada cambió en el esquema de la Agent Card. En lugar de cabeceras HTTP, usa el estado de la tarea y los metadatos de los mensajes que A2A ya tiene:

1. Declaración en la tarjeta: el agente enumera el URI de la extensión en capabilities.extensions.
2. Pago requerido: el agente devuelve una tarea en estado input-required cuyos metadatos de mensaje llevan los requisitos de pago.
3. Pago enviado y liquidado: el cliente responde con una carga útil de pago firmada, y el agente la verifica, la liquida on-chain e informa de un recibo en los metadatos.

Declaración de la extensión en la Agent Card

La extensión se declara igual que cualquier extensión de A2A: una entrada en el array extensions de capabilities, identificada por un URI.

{
  "name": "Market Intelligence Oracle",
  "description": "Performs fundamental analysis on listed equity tickers and returns a structured report.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https://oracle.example.com/a2a/v1",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "description": "Supports payments using the x402 protocol for on-chain settlement.",
        "required": true
      }
    ]
  },
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "deep-equity-scan",
      "name": "Deep Equity Scan",
      "description": "Performs fundamental analysis on listed equity tickers.",
      "tags": ["finance", "equity", "analytics"]
    }
  ]
}

La especificación de la extensión recomienda required: true, lo que indica a los clientes que deben entender x402 para usar las habilidades monetizadas.

El ciclo de vida de negociación y liquidación

El ciclo de interacción estándar entre un agente cliente y un agente comerciante con x402 sigue estos pasos:

1. Descubrimiento y activación: el cliente lee la tarjeta, ve la extensión x402 y la activa enumerando su URI en la cabecera de extensiones de cada solicitud (el texto v0.1 de la extensión llama a esa cabecera X-A2A-Extensions; A2A v1.0 la registra como A2A-Extensions).
2. Pago requerido: ante una solicitud de pago, el agente crea una tarea en estado input-required. Su mensaje lleva x402.payment.status: "payment-required" y x402.payment.required, un objeto con un x402Version y una lista accepts de opciones de pago. El cliente puede elegir cualquiera.
3. Pago enviado: el cliente firma una opción y envía un mensaje en la misma tarea (taskId) con x402.payment.status: "payment-submitted" y la carga útil firmada en x402.payment.payload. Rechazar todas las opciones se informa, en cambio, como payment-rejected.
4. Verificación, liquidación y recibo: el agente verifica la carga útil (payment-verified), la liquida on-chain a través de un facilitator y devuelve el resultado con x402.payment.status: "payment-completed" y un array x402.payment.receipts. Un fallo termina en payment-failed con un código x402.payment.error.

{
  "x402.payment.status": "payment-required",
  "x402.payment.required": {
    "x402Version": 2,
    "resource": {
      "url": "https://oracle.example.com/a2a/v1",
      "description": "Deep equity scan"
    },
    "accepts": [
      {
        "scheme": "exact",
        "network": "eip155:8453",
        "amount": "48240000",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913",
        "payTo": "0xServerWalletAddressHere",
        "maxTimeoutSeconds": 600,
        "extra": { "name": "USD Coin", "version": "2" }
      }
    ]
  }
}

El importe está en la unidad más pequeña del token (USDC tiene seis decimales, así que la cifra anterior son 48,24 USDC). Los nombres de campo difieren entre versiones de x402: el texto v0.1 de la propia extensión aún muestra la forma v1, con maxAmountRequired, mientras que el transporte x402 para A2A usa la forma v2 mostrada aquí.

Cómo construir y generar un agente monetizado

Construir un agente de IA comercial sobre A2A exige acertar con los metadatos fundamentales. Si la tarjeta no es válida, los agentes cliente no pueden descubrir su servicio ni negociar con él.

Para ensamblar su tarjeta y su agente:

1. Abra nuestro generador de Agent Card para redactar sus endpoints base, habilidades y esquemas de autenticación, y active x402. Añade la declaración de la extensión mostrada arriba.
2. Valide el resultado con nuestro validador de Agent Card, que comprueba que las entradas de capabilities.extensions estén bien formadas.
3. Despliegue la tarjeta en /.well-known/agent-card.json de su dominio.
4. Implemente los estados de pago en su agente. El repositorio a2a-x402 incluye una implementación en Python (x402_a2a) que envuelve un ejecutor de A2A, y necesitará un facilitator para verificar y liquidar los pagos. Pruebe todo el flujo en una red de pruebas antes de aceptar fondos reales.