// Proyecto propio

NIA — Laboratorio de agentes gobernados

Un laboratorio para diseñar agentes con memoria contextual, herramientas acotadas y criterio operativo: no un chatbot, sino una arquitectura con límites explícitos, evidencia y control de excepción.

nia@control — arquitectura
agent status --governed
context: authorized
tools: scoped · reversible
policy: human-in-the-loop
evidence: required
mode: controlled execution
$
¿Qué es NIA?

Un agente se demuestra en su operación

NIA es un entorno de referencia para evaluar cómo una capacidad agéntica recibe señales, recupera contexto autorizado, propone una acción y registra evidencia antes de escalarla.

La tesis es sencilla: cuanto más crítica es la plataforma, menos basta con que el modelo explique lo que supuestamente hizo. El resultado debe contrastarse con el estado real.

Capacidades

Diseño agéntico con fricción útil

🧠 Memoria contextual

Contexto persistente y versionado para recuperar decisiones, dependencias y antecedentes sin mezclar fuentes ni permisos.

🛠 Herramientas acotadas

Integraciones con permisos granulares, contratos explícitos, timeouts e idempotencia; cada herramienta declara lo que puede y no puede hacer.

📡 Canal MCP

Intercambio bidireccional desacoplado mediante mensajería y servicios privados detrás de un gateway de APIs.

🛡 Políticas y guardrails

Precondiciones, clasificación de riesgo, límites de escritura y autorización humana cuando la reversibilidad no está garantizada.

📊 Evidencia operacional

Logs, métricas y estado de la plataforma como fuente de verdad; el relato del agente es sólo una hipótesis hasta ser verificado.

🔄 Remediación reversible

Acciones con checkpoints, rollback y escalamiento por excepción para evitar automatizaciones irreversibles disfrazadas de eficiencia.

Arquitectura de referencia

Un agente gobernado de extremo a extremo

La arquitectura desacopla señal, razonamiento, ejecución y evidencia. Así, cada decisión puede ser inspeccionada, detenida o revertida.

01Señalevento · métrica · alerta
02Contextofuentes autorizadas
03Políticariesgo · permisos
04EjecuciónCloud Run · APIs
05Evidenciaestado real · auditoría
Pub/SubMCPApigee Xservicio privadopersistencianotificaciónhuman-in-the-loop
Criterio operacional

La evidencia está por encima del relato

Un agente puede declarar una tarea completada sin que la plataforma la haya ejecutado. Por eso todo output se contrasta contra el estado real, nunca contra su propio informe.

Esta disciplina evita la falsa sensación de automatización: una respuesta convincente no es un resultado operativo, y una acción sin reversibilidad no es una buena automatización.

¿Quieres llevar este patrón a una operación real?

Conversemos sobre contexto, riesgo, herramientas y el primer caso donde la IA debe demostrar criterio, no sólo velocidad.