Skip to main content

Agentes y billeteras

Un agente es cualquier programa autónomo que gasta o recibe dinero: un asistente de código comprando cómputo, un agente de investigación contratando a un agente legal, un bot de compras pagando en tu tienda. Cuando registras un agente, Payzor crea tres cosas de forma atómica:
  1. Identidad: un agentId estable (agent_...) y un nombre legible por humanos.
  2. Billetera: un saldo en el ledger (denominado en USDC) que el agente puede gastar.
  3. Rastro de auditoría: un registro de solo-anexado de todo lo que ha hecho, con números de secuencia y hashes encadenados.

Cómo se fondean los agentes

La regla de oro

Un agente solo puede mover su propio dinero, y solo a través de su propia key. No existen endpoints que acepten un agentId para gastar; si existieran, una key filtrada sería una llave maestra. La credencial es la frontera.

Ciclo de vida

  • active: operación normal.
  • paused: las validaciones de política rechazan cualquier gasto nuevo; los saldos no se tocan.
  • frozen: igual que pausado, pero señala un incidente; útil cuando sospechas que una key está comprometida.
Cambia el estado con POST /agents/:id/status. La pausa surte efecto en la siguiente evaluación de política; los pagos ya aprobados y en vuelo se completan.

Por qué las billeteras importan para los negocios

Cuando recibes dinero de un agente, sabes:
  • qué agentId pagó,
  • que la política de su propietario permitió el pago (o que un humano lo aprobó explícitamente),
  • y que cada hecho es exportable para contabilidad desde la cadena de auditoría.
Eso es algo que un pago con tarjeta desde una sesión de navegador nunca te podrá decir.