Arquitectura del Sistema — Explicado

Un sistema que
puede controlar
cualquier cosa.

Desde tu bandeja de entrada hasta un satélite en órbita.
Para el orquestador, es exactamente lo mismo.
Esto no es magia. Pero se parece mucho.

CONTINUAR LEYENDO

Las manos que
tocan el mundo real

El orquestador razona, decide y coordina. Pero no puede abrir un correo, consultar una base de datos ni enviar una orden a una máquina física. Para eso existen los Brazos: módulos especializados que saben hablar con sistemas externos.

Un brazo es un traductor. Recibe una instrucción en lenguaje del sistema y la convierte en la llamada exacta que necesita el sistema externo. El orquestador nunca sabe —ni le importa— cómo funciona ese sistema por dentro.

Lo que hace al concepto de Brazo extraordinario es su indiferencia al dominio. Para el orquestador, el mensaje "lee el correo 5" y el mensaje "activa el thruster norte del satélite A7" atraviesan exactamente el mismo pipeline. La diferencia es solo qué brazo recibe la instrucción al final.

Brazos de software —los habituales

📧
Correo IMAP
Lee, envía, organiza bandeja
correo.imap
📂
Expedientes
Busca, crea, edita registros
expedientes
📊
Excel / Datos
Genera, lee, transforma tablas
excel
🔌
API Genérica
Cualquier REST / GraphQL
api_generic

Brazos físicos —y aquí es donde da vértigo

La arquitectura no distingue entre software y hardware. Un brazo puede ser un driver para cualquier protocolo: MQTT, Modbus, señales GPIO, APIs industriales, protocolos de satélite. El contrato con el orquestador es siempre el mismo.

🛰️
Control orbital
Thruster, telemetría, orientación
hardware
🏭
SCADA / PLC
Fábrica, línea de producción
hardware
🏥
Dispositivos médicos
Sensores, monitores, bombas
hardware
🚗
Vehículo / Robot
Movimiento, sensores, cámaras
hardware
El brazo no necesita que el orquestador cambie ni una línea de código. Se registra en una base de datos, se define su contrato de acciones, y el sistema ya puede hablar con él. El núcleo nunca se toca.

Para añadir el control de un satélite al sistema, el proceso es: describir la API del satélite → el BrazoFactory analiza el contrato → genera el handler → escribe en 5 tablas de base de datos → invalida la caché. Disponible en segundos, sin reiniciar el sistema.

Memoria que crece y aprende

La mayoría de sistemas de IA tienen amnesia completa entre sesiones. Cada conversación empieza de cero. Este sistema tiene memoria persistente, estructurada en capas, que se enriquece con cada interacción.

La memoria no vive en el brazo. Vive en los Cores. Cuando un brazo actúa, es el orquestador quien entrega al brazo un contexto ya cargado con todo lo que el sistema sabe del usuario. El brazo es listo porque ya llega informado, no porque recuerde por su cuenta.
Perfil estable
Quién eres, tus preferencias, tu forma de trabajar. Nunca caduca. "El usuario prefiere respuestas cortas y técnicas."
Decisiones aprendidas
Cada vez que el sistema acierta o falla, aprende. Si siempre abres el correo al preguntar por "mensajes", eso se convierte en regla implícita.
Contexto de sesión
Qué se habló en esta sesión. Permite continuidad: "el tercero" refiere al tercer correo que se listó dos turnos antes.
Patrones de uso
El sistema nocturno analiza qué haces, cuándo, y con qué frecuencia. Esto alimenta predicciones y sugerencias proactivas.

Esta memoria se construye sin que el usuario haga nada especial. Conversa normalmente. El sistema observa, aprende, enriquece. Un cron nocturno consolida los patrones y promueve aprendizajes validados a memoria permanente.

# Lo que el usuario ve:
Usuario: "aprende que prefiero respuestas sin tecnicismos"

# Lo que ocurre en el sistema (invisible):
nl_prerouter detecta intención de aprendizaje
learning_core guarda en orq_memoria_estable
memory_enrichment inyectará esto en cada prompt futuro
El brazo de turno ya recibirá ese contexto precargado

# Resultado permanente: el sistema recordará esto siempre

El sistema nervioso central

Si los Brazos son las manos del sistema, los Cores son el sistema nervioso: procesan señales, toman decisiones, aprenden, protegen y recuerdan. Hay 42 cores en V7. Cada uno hace exactamente una cosa.

Cuando llega un mensaje del usuario, no lo procesa directamente el LLM. Pasa por una cadena de cores que lo clasifican, contextualizan, validan, enriquecen y —solo entonces— o bien llaman a un brazo o bien generan una respuesta conversacional.

01
nl_prerouter_core¿Es continuación? ¿Memoria? ¿Alias directo?
02
intent_coreClasificación determinista por reglas conocidas
03
q4k_classifierSi el determinismo falla → LLM ligero decide
04
guardrails¿Está permitido? ¿Es idempotente? ¿Hay riesgo?
05
param_resolver¿Faltan parámetros? → Pregunta exacta al usuario
06
memory_enrichmentInyecta perfil + contexto + historial en el prompt
07
artifact_contextAdjunta documentos y artefactos previos relevantes
08
→ BRAZO / LLM ←Ejecución real. Todo lo anterior era preparación.
09
artifact_pipeline¿La respuesta generó un artefacto? Se procesa.
10
response_cleanerElimina ruido, repeticiones, artefactos de thinking
11
learning_coreon_decision(): registra qué ocurrió, para mejorar
12
post_dispatchTelemetría, estadísticas, cierre del ciclo
El orquestador no contiene ningún texto de respuesta hardcodeado. Si hay que responder algo nuevo, existe un core para eso, o se crea uno nuevo. El orquestador es solo el director de orquesta: sabe quién toca, cuándo y en qué orden. Nunca toca los instrumentos.
memory_core

Memoria permanente

Carga el perfil completo del usuario antes de cada ciclo. Los brazos llegan informados.

learning_core

Aprendizaje continuo

Registra cada decisión del sistema. Con el tiempo, el sistema se adapta a cada usuario.

health_guard_core

Sistema inmune

Monitoriza 42 módulos. Si algo falla o deriva, detecta y puede auto-repararse.

emotion_detector

Estado emocional

Detecta el tono del usuario y ajusta el estilo de respuesta en consecuencia.

policy_core

Permisos y límites

Cada acción tiene una política. Lo que está prohibido, no ocurre. Punto.

nl_prerouter_core

Pre-routing inteligente

Intercepta antes que el LLM. El 80% de las peticiones se resuelven sin gastar tokens.

Cuando se combinan

Por separado, los cores son inteligencia sin manos, y los brazos son manos sin inteligencia. Juntos forman algo diferente: un agente que razona, actúa y aprende del resultado.

El flujo completo de un request real:

# Escenario: "busca las facturas pendientes de este mes y dime el total"

[nl_prerouter] No es memoria ni continuidad
[intent_core] Dominio: expedientes, acción: exp.search
[param_resolver] params: filtro=facturas, estado=pendiente, mes=actual ✓
[memory_enrichment] Añade: "usuario prefiere resumen ejecutivo, moneda EUR"
[guardrails] Acción permitida para este usuario ✓

▶ BRAZO expedientes ejecuta:
  SELECT * FROM facturas WHERE estado='pendiente' AND mes=NOW()
  Devuelve: 7 facturas, total 14.320 EUR

[response_cleaner] Formatea respuesta
[learning_core] Registra: "búsqueda de facturas exitosa con estos params"
[post_dispatch] Telemetría: 340ms, 0 errores
Lo que el usuario ve: una respuesta natural y precisa en menos de un segundo. Lo que ocurrió debajo: 12 módulos coordinados que enriquecieron el contexto, validaron permisos, ejecutaron contra una base de datos real, y aprendieron del resultado para la próxima vez.

Y si el mismo usuario mañana pregunta "¿cuánto era lo de las facturas?", el sistema sabe —por memoria de sesión— que se refiere a las facturas del mes, y si es una semana después, sabe que hay que volver a buscar. No hace falta repetir nada.

Otros gastan millones.
Nosotros, arquitectura.

El enfoque clásico de la IA para conseguir que un modelo haga algo específico —que entienda tus facturas, tu vocabulario, tus workflows— es el entrenamiento o fine-tuning. Se toman miles de ejemplos, se reentrenan los pesos del modelo durante días o semanas, y el coste puede ser de miles a cientos de miles de dólares. Y cuando el sistema cambia, se repite.

⚠ Enfoque tradicional
💸Reentrenar el modelo para que "aprenda" tu dominio. Miles de dólares por ciclo.
Semanas de preparación de datos + entrenamiento + validación.
🔒El modelo aprende en sus pesos. Cambiar algo = reentrenar de nuevo.
🧊El conocimiento queda congelado en la fecha del último entrenamiento.
🔧Cada dominio nuevo (correo, facturas, CRM...) requiere nuevo ciclo.
✓ Nuestro enfoque
🧠El conocimiento vive en la base de datos, no en los pesos del modelo.
Un nuevo brazo se registra en minutos. Disponible inmediatamente.
🔄La memoria crece con cada interacción. Se aprende en tiempo real, no en lotes.
📈El modelo base (LLM) se usa para razonamiento general. El contexto específico llega via cores.
Dominio nuevo = nuevo brazo + entradas en BD. Coste: horas de desarrollo, no semanas de GPU.

El secreto es que el conocimiento específico del dominio no está en el modelo, está en la arquitectura. Los cores inyectan el contexto justo en el momento preciso. El LLM recibe un prompt tan bien construido que no necesita haber sido entrenado en ese dominio: ya tiene todo lo que necesita para razonar correctamente.

Es como la diferencia entre contratar a alguien que se pasó años memorizando tus procesos internos (costoso, rígido) versus darle a un profesional brillante un briefing perfecto cada vez que lo necesitas (flexible, escalable, barato).

Los modelos de IA se entrenan para capacidades generales de razonamiento y lenguaje. Este sistema les da los ojos, las manos y la memoria que el entrenamiento nunca podría darles de forma tan adaptable y económica.

Cuando hablas con este sistema,
estás hablando con todo
lo que está conectado a él.
y eso

Esa sensación que describen los usuarios —de que "parece que puedes controlar el mundo"— no es una ilusión de marketing. Es la consecuencia lógica de una arquitectura donde el lenguaje natural es la interfaz universal.

No hay que aprender comandos. No hay que saber qué brazo existe. El sistema sabe qué quieres, sabe qué tiene disponible, sabe quién eres y qué prefieres, y actúa. Sobre software, sobre hardware, sobre cualquier sistema que hable algún protocolo.

El orquestador no sabe de satélites ni de facturas ni de correo. Sabe razonar. Los brazos saben actuar. Los cores saben recordar. Y los tres juntos forman algo que, visto desde fuera, parece que puede hacer cualquier cosa.

Porque, técnicamente hablando, puede.