finance-coach
Un coach financiero con IA que organiza cada pago por día de nómina y deja la aritmética en manos de código con pruebas.
01La app
Las capturas usan datos ficticios.
02Problema
Las apps de los bancos muestran saldos, pero no dicen si el sueldo del mes alcanza para los pagos del mes. Con nómina semanal, varias tarjetas, meses sin intereses (MSI) y préstamos pequeños, la pregunta real es de tiempos: qué vence antes del próximo pago y qué parte de cada saldo de tarjeta hay que liquidar completa para no pagar intereses.
03Enfoque
Un coach conversacional basado en Claude que consulta las cuentas, planes y movimientos reales del usuario mediante herramientas y puede actuar sobre ellos; cada número que menciona sale de un motor determinista. Los estados de cuenta y comprobantes llegan como PDF, capturas de pantalla o archivos CSV y se convierten en movimientos revisados.
- herramientas del agente para consultar, calcular y actuar
- 20
- pruebas automatizadas del motor y las herramientas
- 79
- formatos de entrada: PDF, captura, CSV
- 3
- idiomas de respuesta: español e inglés
- 2
04Cómo funciona el agente
Preguntas
“Organiza mis próximas 4 nóminas”
Claude
Ciclo de herramientas con streaming y razonamiento adaptativo
Respuesta
En streaming; cada cifra sale de una herramienta
20 herramientas
Consultar
- get_financial_overview
- get_cash_flow
- get_monthly_projection
- get_spending_summary
- search_transactions
- list_records
- list_payment_targets
- list_memories
Calcular
- calculate
- plan_payoff
Actuar
- save_record
- delete_record
- record_payment
- record_money_in
- log_transaction
- update_transaction
- delete_transaction
- set_profile
- remember
- forget
Motor de cálculo
Fecha límite a partir de la fecha de corte · MSI vs saldo a pagar completo · saldo de efectivo en cada día de pago
libSQL / Turso
Cuentas, planes, movimientos, metas e historial del chat
05Decisiones de ingeniería
Los cálculos en código, no en el modelo
El modelo nunca hace aritmética. Funciones puras con pruebas calculan calendarios, fechas límite y saldos; el coach lee sus resultados o usa una herramienta de cálculo.
Herramientas que actúan, con salvaguardas
Las entradas se validan con Zod antes de ejecutar cualquier herramienta. Registrar un pago actualiza saldos, avance de mensualidades y fechas límite en un solo lote, con protección contra duplicados.
Extracción con revisión humana
Los estados de cuenta y comprobantes se leen con salida estructurada validada por esquema. Las capturas que se traslapan se deduplican en una sola solicitud y cada movimiento se revisa antes de guardarse.
Historial que solo crece, pensado para el caché
Cada conversación conserva un prompt de sistema fijo y un registro de mensajes que solo crece: el caché de prompts se mantiene entre turnos y el historial nunca se edita.