James Valencia
← Proyectos

2026 — presente

Cowork.Ctis — agente embebido en Reportia

Fundador y autor único — CtisEvolution

Impacto

Un asistente de IA embebido en un producto real, con un techo de costo matemáticamente acotado y un apagador de emergencia que no requiere redeploy — la diferencia entre 'lo probamos' y 'lo dejamos correr en producción'.

TypeScriptExpressReactViteDrizzlePostgreSQLVercel AI SDK

El problema

Reportia, mi propio producto bajo CtisEvolution, necesitaba un asistente agéntico embebido que pudiera responder pidiendo datos reales del usuario — leer movimientos, generar reportes en Excel y HTML — sin que eso se convirtiera en una pesadilla de seguridad ni de mantenimiento. Un agente con acceso a datos reales de producción no es algo que se pueda tratar como un chatbot más.

El enfoque

La primera decisión, documentada en un ADR, fue cómo embeber Cowork dentro de Reportia. Se evaluó Module Federation y se descartó a favor de un iframe simple, por aislamiento de estilos y simplicidad de despliegue — un trade-off consciente, no la opción de moda.

La segunda fue el manejo de modelos de lenguaje: un sistema de fallback y retry con un presupuesto de costo acotado matemáticamente, como máximo intentos_por_modelo × largo_de_cadena_de_fallback llamadas en el peor caso (seis llamadas máximo con la configuración default), más un kill switch por variable de entorno que apaga el fallback al instante, sin necesidad de redeploy.

Todo se desarrolló con TDD estricto usando Vitest, y el CI corre escaneo de vulnerabilidades con Trivy y de secretos con Gitleaks en cada push.

Lo construí prácticamente solo — la ayuda externa fue puntual, en piezas muy específicas, no en el diseño ni en la implementación del sistema.

Resultado

Un asistente de IA embebido en un producto real, con un techo de costo matemáticamente acotado y un apagador de emergencia que no requiere redeploy — la diferencia entre "lo probamos" y "lo dejamos correr en producción".