---
title: Los 12 agentes de finanzas y nómina
persona: all
category: Documentación técnica
version: 1.0.0
updated: 2026-06-09
---

# Los 12 agentes · finanzas y nómina

MyFinAI corre sobre el **Lopettia Agent Framework (LAF)**: una familia de doce
agentes con persona única —**Felipe**, el copiloto financiero— que cubren el ciclo
completo del dinero, de la captura al cierre. Cada agente tiene un arquetipo, un
lugar en el flujo y un alcance acotado. Trabajan para el equipo; no lo sustituyen.

## El ciclo

```mermaid
flowchart LR
  Lente --> Libro --> Espejo --> Mayor
  Cobro & Mecenas & Salario & Fisco --> Mayor
  Caudal & Guardian & Norte -.observan.- Mayor
  Conclave((Cónclave)) --- Lente & Cobro & Salario & Fisco
```

## El catálogo

| Agente | Arquetipo | Qué hace en el negocio | En el hogar |
|---|---|---|---|
| **Cónclave** | Orquestador (núcleo) | Detecta la intención financiera y enruta al especialista | El mismo: coordina a los demás |
| **Lente** | Captura / OCR | Lee recibos, banco y tarjeta y crea el movimiento | Captura cargos del hogar |
| **Libro** | Contabilidad | Propone la cuenta y arma el asiento por partida doble | Categoriza el gasto doméstico |
| **Espejo** | Conciliación | Casa el libro contra el extracto del banco | Concilia las cuentas del hogar |
| **Cobro** | Cuentas por cobrar | Prioriza qué facturas perseguir y cuándo | — |
| **Mecenas** | Cuentas por pagar | Marca vencimientos y descuentos por pronto pago | Hipoteca, servicios, suscripciones |
| **Salario** | Nómina | Calcula bruto, retenciones y neto de cada corrida | Los ingresos que entran al hogar |
| **Fisco** | Impuestos | Prepara IVU, 941 y vencimientos desde el libro | La planilla personal |
| **Caudal** | Flujo de caja | Proyecta entradas y salidas semana a semana | Las metas de ahorro |
| **Guardián** | Fraude / anomalías | Marca cargos duplicados o comercios desconocidos | Fraude de tarjeta y suscripciones zombi |
| **Norte** | Asistente NL + salud | Responde en lenguaje natural leyendo el libro | La salud del hogar |
| **Mayor** | Cierre y auditoría | Cuadra la balanza, sella el cierre y la cadena de hash | El cierre del mes en casa |

## Cómo trabajan

- **Deterministas primero.** Cada agente resuelve con reglas sobre el libro; la IA
  (Claude) *pule* la respuesta cuando hay llave disponible. Sin llave, el sistema
  sigue operando.
- **Trazables.** Cada corrida se registra en `agent_runs` con su modelo, entrada,
  salida y costo. Nada ocurre fuera del registro.
- **Acotados por rol y por inquilino.** Un agente solo ve el libro del espacio
  activo, y solo lo invocan los roles autorizados. Norte, por ejemplo, devuelve
  `403` a un empleado: no se sacan los libros por el chat.
- **De solo lectura, por ahora.** En esta versión los agentes informan y proponen;
  mover dinero (emitir, pagar, correr nómina) pasa por una persona. El camino para
  darles herramientas con aprobación humana (HITL) y tope de gasto está descrito en
  [Seguridad](security.es.html) y en `api/AUDIT.md`.

## La misma familia, dos contextos

Los doce agentes son los mismos en el negocio y en el hogar; solo se **reetiquetan**.
Mecenas paga proveedores en el café y la hipoteca en casa; Salario corre la nómina
del negocio y registra el ingreso familiar. Una sola inteligencia financiera,
puesta al servicio de las dos caras de la vida económica de una persona.

> La ficha viva de cada agente (arquetipo, modelo, estado) se sirve en la sección
> **Agentes** de la consola y está catalogada en el repositorio **AIaaSAgents**
> como la vertical *Finanzas & Nómina*.