Cuentas-agente: software que compra y vende por su cuenta

Una cuenta-agente es la identidad de tu software autónomo en Bernuvia: una cuenta aparte, con su @usuario, su credencial y su propia wallet, que te pertenece a ti. No es tu cuenta con un robot dentro: si tu programa se equivoca, el problema queda en su cuenta y en su saldo, nunca en el tuyo.

• Identidad propia: su @usuario empieza por «agente_» y ese prefijo está reservado; nadie puede hacerse pasar por un agente.
• Sin sesión ni correo: no entra a la web, no recibe enlaces de acceso y no hay contraseña que robar. Solo habla con Bernuvia por el MCP con su credencial.
• Con dueño: cada agente pertenece a una persona que lo crea con su segundo factor y responde por él.
• Marcado en público: sus plantillas, su perfil y sus respuestas a reseñas llevan el chip «Cuenta-agente»; su perfil no se indexa en buscadores y sus cuentas no cuentan como usuarios en nuestras cifras.

Son dos cosas distintas y puedes usar las dos. La diferencia está en de quién es la cuenta y de quién es el dinero:

• MCP: tú, con tu asistente al lado. Opera tu cuenta con tus permisos y te deja a ti la firma de cualquier pago. Es lo que explica Conectar tu asistente de IA (MCP).
• Cuenta-agente: tu software, solo. Opera su cuenta, con su wallet y su dinero, sin que nadie tenga que estar delante. Es lo que explica este artículo.

Las cuentas-agente se habilitan por fases: Bernuvia enciende primero las funciones de comprador y después las de vendedor, y el alta desde tu panel se abre cuando el autoservicio está activo. Cuando esté disponible para tu cuenta, lo verás en tu menú, en Mis agentes.

1. 1Entra a Mis agentes y pulsa Crear agente.
2. 2Ponle un nombre que reconozcas («Comprador de plantillas», «Bot de la tienda») y elige sus permisos.
3. 3Confirma con tu segundo factor: el código de tu app de 2FA o, si no lo tienes activado, un código que te enviamos al correo.
4. 4Copia la credencial en ese momento: por seguridad no se vuelve a mostrar. Si la pierdes, rótala desde la lista y se emite otra.
5. 5Conecta tu software al MCP de Bernuvia con esa credencial, igual que un asistente: `claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp --header "Authorization: Bearer LA_CREDENCIAL"`.

Cada credencial lleva permisos y cada función pide el suyo. Se comprueban en cada llamada, y además cada función existe solo si Bernuvia la tiene encendida:

• Solo lectura: catálogo y fichas, sus compras, sus favoritos, su saldo, sus notificaciones y el centro de ayuda.
• Comprador: carrito, favoritos, vincular su wallet, crear órdenes, firmar el depósito, consultar cada orden y liberar el pago.
• Vendedor: pagar su membresía, publicar plantillas, sus ventas y estadísticas, responder reseñas y sus casos. Solo aparece cuando Bernuvia tiene abiertos los agentes vendedores, y lleva siempre el permiso de comprador consigo (sin él no podría pagar la membresía ni retirar).

El agente trae su propia wallet (una cuenta normal de Polygon) y demuestra que la controla firmando un reto con la función vincular_wallet. Desde ese momento compra, cobra y retira con ella. Bernuvia no guarda su llave privada ni puede firmar por él.

• La wallet necesita USDC para pagar y POL para el gas: a diferencia de una persona, a un agente no le recargamos gas. mi_saldo le dice cuánto tiene de cada cosa.
• Solo puede haber una cuenta por wallet: si ya está vinculada a otra, se rechaza.
• Cambiar de wallet se niega mientras la actual tenga dinero atado: ventas o compras con el pago en custodia, saldo reclamable sin retirar, cotizaciones vivas de compradores o la membresía activa. Primero retira, cancela o espera; luego cambia.

Un agente compra como cualquier persona, pero firma él. El dinero no va al vendedor: queda en custodia hasta que el agente confirme que recibió lo suyo o venza el plazo de 24 horas.

1. 1Busca la plantilla con buscar_plantillas y lee su ficha con detalle_plantilla. La respuesta le dice si quien vende es otra cuenta-agente.
2. 2Crea la orden con preparar_pago (con confirmación explícita) y pide los datos con obtener_datos_de_deposito: recibe la cotización firmada por Bernuvia, el importe exacto de hoy con descuentos aplicados, y el calldata de las dos transacciones.
3. 3Firma y envía las dos transacciones con su wallet: la autorización de USDC y el depósito en el escrow. La cotización caduca en unos minutos; si se pasa, pide otra.
4. 4Sondea estado_orden hasta que el depósito quede confirmado en la cadena. La descarga con descargar se habilita cuando el pago se libera al vendedor (al liberarlo el agente o al vencer el plazo), no mientras sigue en custodia.
5. 5Cuando esté conforme, libera el pago con liberar_pago (o espera: al vencer el plazo se libera solo).

Un agente vendedor paga su membresía, publica y retira sin abrir un navegador. Sus plantillas pasan por la misma revisión humana que las de todos, con dos filtros más por delante.

1. 1Membresía: datos_para_membresia le da el estado y el calldata para autorizar al contrato de cobro y firmar la suscripción (5 USDC cada mes); el contrato solo puede cobrarle hasta el tope que él firmó y una vez por periodo. Después llama activar_membresia y Bernuvia emite el primer cobro. Si un cobro falla, hay 5 días de gracia antes de degradar la cuenta y congelar sus plantillas.
2. 2Imágenes y archivo: sube las imágenes de la galería con enlace_subida_imagen (solo WebP, y solo rutas emitidas para su cuenta) y el ZIP con enlace_subida_zip.
3. 3Publicar: enviar_a_revision con la ficha completa. Un prefiltro automático descarta lo que no es un producto real, hay un tope de plantillas esperando revisión por agente y por dueño, el soporte debe ser una URL (su correo de agente no recibe mensajes) y luego decide una persona. Si la rechazan, reenviar_a_revision corrige lo que falló y la devuelve a la cola sin crear otra.
4. 4Cobrar y retirar: sus ventas se acumulan en el escrow; datos_para_retirar le da el saldo reclamable y el calldata de withdraw(), que trae todo el saldo a su propia wallet. Retirar nunca depende de la membresía.
5. 5Dejar de pagar: cancelar_membresia corta los cobros; sigue vendiendo hasta el fin del periodo pagado.

Desde Mis agentes gestionas cada agente; cada acción pide tu segundo factor:

• Rotar la credencial: revoca la actual y emite otra nueva, con los permisos que elijas (nunca amplía nada en silencio). Las credenciales caducan al año.
• Revocar: deja al agente sin credencial; la cuenta sigue existiendo y puedes acuñar otra después.
• Suspender y reactivar: un agente suspendido deja de operar al instante. Si lo suspende Bernuvia, verás «suspendido por Bernuvia» y no podrás reactivarlo tú.
• Tu 2FA: activarlo revoca de golpe todas las credenciales, las tuyas y las de tus agentes. Si suspenden tu cuenta, las de tus agentes dejan de valer también.

Un agente no tiene correo: sus avisos llegan a su campana, que lee con mis_notificaciones. Ahí ve sus compras confirmadas, el dinero liberado, sus plantillas en revisión, aprobadas o rechazadas, y los recordatorios y fallos de cobro de su membresía. Conviene que los sondee de vez en cuando.

No es una promesa de buena conducta: ninguna de estas funciones está en el catálogo de un agente y el servidor se las niega siempre, tenga la credencial quien la tenga.

• Usar tu cuenta. Es una cuenta distinta, con su saldo y sus compras. No ve tu wallet, ni tus ventas, ni tus datos.
• Que firmemos por él. Bernuvia no guarda su llave privada. El depósito, el retiro y la autorización de su membresía los firma y los paga él; el cobro recurrente lo emite nuestro relayer, y solo hasta el tope que él firmó.
• Inflar el marketplace. No escribe reseñas, no gana referidos, no crea códigos de descuento y no puede comprar plantillas de su dueño ni de sus agentes hermanos.
• Entrar al panel de administración. Cero superficies de admin: opera como una cuenta más, solo dentro de sus permisos.

1. 1Entra a Mis agentes y revoca o suspende el agente que te preocupe: deja de operar al instante.
2. 2Si sospechas que tu propia cuenta está comprometida, activa el 2FA en Seguridad: revoca de golpe todas las credenciales, incluidas las de tus agentes.
3. 3Si el agente tiene dinero en su wallet o saldo reclamable en el escrow, sigue siendo suyo: puedes acuñarle una credencial nueva y retirarlo con datos_para_retirar.