Contexto
Nexo IA comenzó como proyecto final de un curso sobre agentes y MCP. El equipo planeó primero un asistente de trámites vehiculares y después amplió el concepto hacia una capa de infraestructura reutilizable para instituciones y dominios.
Su madurez forma parte de la historia: es una arquitectura experimental con un roadmap activo. No se presenta como producto institucional maduro.
El problema institucional
La información y los servicios gubernamentales están fragmentados entre dependencias, infraestructuras y áreas. Las personas deben saber dónde buscar antes de comenzar un trámite.
Un chatbot general no resuelve confianza, vigencia, permisos o auditoría asociados con acciones institucionales.
Actores y canales
Los canales propuestos incluyen portal ciudadano, consola administrativa, voz y WhatsApp. Detrás, agentes especializados, fuentes verificables y herramientas con permisos separan recuperación de información y acción autorizada.
Visión
Nexo IA está diseñado como directorio universal que se adapta a sistemas existentes sin forzar migraciones. Una institución podría conectar documentación, APIs, sistemas legacy, catálogos, procesos y métricas.
La plataforma mapearía fuentes, recuperaría información verificable, expondría herramientas autorizadas, solicitaría confirmación, ejecutaría acciones, registraría auditoría y generaría interfaces administrativas seguras con A2UI.
Flujo del producto
- Recibir una solicitud por web, voz o mensajería.
- Clasificar el dominio y recuperar fuentes versionadas.
- Componer una respuesta con evidencia trazable.
- Identificar una herramienta MCP autorizada si se solicita una acción.
- Aplicar permisos y validación determinista.
- Pedir confirmación antes de ejecutar.
- Registrar eventos y resultados para auditoría.
Arquitectura
El frontend combina Next.js y un renderer A2UI. Un backend FastAPI maneja autenticación, conversaciones, ejecuciones, SSE, acciones, webhooks y administración. Contratos Pydantic, OpenAPI y JSON Schema conectan capas.
LangGraph orquesta flujos y checkpoints. Agentes especializados trabajan con RAG híbrido, un catálogo MCP con permisos y builders A2UI seguros. PostgreSQL almacena tenants, conversaciones, acciones y auditoría; observabilidad y evaluaciones son capas de primer nivel.
Decisiones técnicas clave
- Separar recuperación, verificación y acción.
- Usar fuentes versionadas por dominio y conservar trazabilidad.
- Exigir validaciones deterministas y confirmación explícita para herramientas sensibles.
- Compartir contratos mediante esquemas tipados y eventos versionados.
- Tratar observabilidad, auditoría y datasets de evaluación como infraestructura del producto.
Mi contribución
Diseñé la arquitectura y delegué tareas. Me concentré en agentes, RAG, MCP, infraestructura, contratos compartidos y observabilidad.
Fue trabajo de equipo bajo un plazo agresivo. La amplitud actual es roadmap y exploración arquitectónica, no evidencia de que cada adaptador esté listo para producción.
Desafío principal
El reto fue definir cómo interactúan agentes y herramientas MCP: qué contexto reciben, cómo se aplican permisos, cuándo se requiere validación determinista y cómo cada acción se vuelve trazable.
Resultado y estado actual
Nexo IA es una plataforma experimental temprana. La primera etapa estableció la arquitectura y la dirección funcional; los mocks y límites incompletos permanecen en el roadmap.
El sistema está diseñado para conservar fuente, vigencia y trazabilidad. No afirma que la información generada siempre sea correcta.
Lo que aprendí
Aprendí MCP y arquitectura orientada a agentes desde cero y los apliqué a un flujo institucional específico, no como demos aisladas.
Qué cambiaría
Definiría límites de capacidades, propiedad del runtime y contratos antes de ampliar el número de agentes y dominios.
Roadmap
Incluye mejorar MCP Mapper, aclarar límites, integrar adaptadores reales, workers durables, evaluaciones sistemáticas, seguridad por herramienta, observabilidad, formularios A2UI dinámicos, pruebas de carga y gobierno del corpus.
Galería de interfaz
La galería final requiere chat ciudadano, fuentes, voz, panel administrativo, flujo de herramientas, A2UI y un diagrama capturado del prototipo real.
Demo escrita
La demo etiquetará el prototipo, seguirá una pregunta hacia sus fuentes, solicitará una acción autorizada, mostrará confirmación y eventos, y cerrará con interfaz administrativa y roadmap.
Código
El repositorio es público y está disponible mediante el enlace de código verificado de este caso de estudio.