jandresgarcia.dev
Rev. 2026.09

Cómo funciona Clara: un agente de IA con herramientas tipadas, un motor financiero determinista dueño de cada cifra, un validador y tres niveles de modelo con tope de gasto.

AN-02

Clara Un agente de finanzas personales donde el modelo nunca hace las cuentas.

En uso diario · app privada

Video 1. Clara, resumen del producto · 1:24

Cero números adivinados

Un validador determinista bloquea cualquier número que el modelo no obtuvo de una herramienta.

0

Números adivinados por el modelo. Un validador determinista bloquea cualquier cifra que no venga de una herramienta.

Cómo funciona

  1. Pregunta
  2. Respuesta

Notas de ingeniería

  • El LLM explica y compara. Un motor determinista es dueño de cada saldo, proyección y puntaje.
  • Tres niveles de modelo elegidos por un router determinista, con fallback por rol y tope de gasto diario.
  • Una eval en vivo con modelos reales (60 casos) encontró fallas que la suite hermética no veía; se corrigieron con guardas en el servidor.

Agente IATool callingRuteo multi-modeloEvals en vivo

Next.js PWA · Fastify · SQLite · Drizzle · Zod · 3 model tiers · Docker on ARM64

Cómo funciona una corrida

  1. Preguntas: ¿cuánto me queda para gastar hasta fin de mes?
  2. La API verifica la sesión y pasa el mensaje.
  3. Un router determinista lo clasifica: es chat, así que va al modelo fuerte.
  4. El agente IA inicia un ciclo de herramientas. La llamada se registra contra el tope de gasto diario.
  5. Llama a una herramienta de cálculo en vez de hacer la cuenta.
  6. El motor financiero calcula el número exacto con los datos reales.
  7. Antes de mostrar nada, cada cifra de la respuesta se compara con los resultados de las herramientas. Las cifras sin verificar se bloquean.
  8. Recibes la respuesta, con un link para ver cómo se calculó.

Componentes del sistema

ComponenteQué hace
PWAInstalable · passkeysCódigo deterministaUn export estático de Next.js servido por la API, instalado en el celular y desbloqueado con Face ID.
iOS ShortcutsIngreso automático de comprasCódigo deterministaLos pagos con tarjeta llegan por Shortcuts a un endpoint solo de ingreso con su propio token.
APIFastify · un contenedorCódigo deterministaUna imagen Docker en un servidor ARM64, accesible solo dentro de una tailnet privada.
ProgramadorTick del agente 06:30 · TRMCódigo deterministaUn tick diario del agente planeado por el servidor, la TRM cada 30 minutos, backups y un resumen semanal.
Router de intenciónElige nivel, sin LLMCódigo deterministaReglas deterministas deciden qué nivel de modelo atiende cada pedido. Una compra de más del 25% del ingreso mensual escala.
Agente IACiclo de herramientas · con topeLlamada a modeloEntiende el pedido y explica el resultado. Trabaja con herramientas en un ciclo con tope de iteraciones; las escrituras se pueden deshacer.
HerramientasLeer · calcular · actuarCódigo deterministaHerramientas tipadas para leer datos, simular y actuar. El modelo nunca toca la base de datos directamente.
Motor financieroDueño de cada númeroCódigo deterministaSaldos, proyecciones, presupuestos y el puntaje de salud, calculados en unidades mínimas enteras. Ningún modelo hace aritmética.
Validador de cifrasBloquea cifras sin verificarCódigo deterministaCualquier cifra de la respuesta que no exista en un resultado de herramienta se bloquea antes de llegar a la pantalla.
Niveles de modeloRápido · Fuerte · FronteraLlamada a modeloLo rutinario va a un modelo rápido, el chat a uno fuerte y las revisiones mensuales y grandes decisiones a uno de frontera. Cada rol tiene proveedor de respaldo.
Guarda de gastoCada llamada registrada · tope diarioCódigo deterministaCada llamada queda registrada con su costo. Una guarda por corrida y un tope diario apagan la IA por sí solos, con alerta al 70%.
Evals60 casos en vivo · gate en CICódigo deterministaUna suite hermética más una eval en vivo con modelos reales. La primera corrida en vivo sacó 31/60 mientras la hermética pasaba; guardas en el servidor cerraron la brecha.
SQLiteWAL · backups nocturnosDatosLa única fuente de verdad, con checkpoints WAL cada 15 minutos y backup cada noche.
TRMdatos.gov.coDatosLa tasa oficial COP/USD alimenta las proyecciones de ingresos en ambas monedas.
Memoria semánticaRecuerdo a largo plazoPlaneadoSiguiente: una capa de memoria semántica para que el agente recuerde decisiones pasadas. Planeado, aún no construido.

Disponibilidad

Abierto a roles senior de AI Engineer y Fullstack, y a construir productos de IA para founders.