MAXIQUEEN OS v2.0
Sistema Operativo Empresarial de Agentes Cognitivos. Manual técnico integrado y vivo — une el diseño fundacional v1.0 (navy #0A1931 / gold #C9A227) con la especificación completa v2.0.
Manifiesto
MAXIQUEEN OS no es un chatbot. Es el sistema operativo que convierte tu empresa en un organismo autónomo donde los LLMs son herramientas, no empleados. Los empleados son agentes especializados dirigidos por directores, orquestados por un kernel y gobernados por memoria, políticas y costos.
- Primero el negocio: cada agente nace con un KPI, un presupuesto y un SLA.
- Gobierno por políticas: privacidad, costo y latencia deciden qué cerebro usar.
- Memoria como activo: lo que aprende hoy, opera mañana sin reentrenar.
Visión
De SaaS a OS
Pasar de herramientas aisladas a un OS donde los procesos se ejecutan como hilos cognitivos orquestados, medibles y facturables.
Empresa Clonable
Blueprints versionados permiten replicar departamentos completos en minutos con memoria, políticas y métricas precargadas.
Arquitectura por Capas (5)
1. Interfaz
Control Center, APIs, Webhooks, SDK. Experiencia unificada para humanos y sistemas.
2. Orquestación (Kernel)
Scheduler DAG, Router de inferencia, Políticas, Seguridad.
3. Operacional
Directores y Agentes especializados con roles, memoria y herramientas.
4. Cognitiva
Proveedores abstractos A/B/C/Local. Los LLMs son herramientas.
5. Persistencia
Memoria jerárquica: RAM, corto plazo, vectorial, histórica.
Arquitectura Física y Topología de Red
Distribución edge-to-core con enrutamiento inteligente y observabilidad end-to-end.
Notas de despliegue
Edge termina TLS y aplica rate-limit. Vercel sirve UI y API routes stateless. El Director encola tareas en el Worker Runtime. El balanceador aplica la economía de inferencia antes de llamar a proveedores.
El Kernel del Sistema Operativo
El núcleo no ejecuta código binario tradicional; coordina hilos de ejecución cognitiva.
Planifica dependencias, paralelismo y reintentos con garantías idempotentes.
Crea, hidrata memoria, ejecuta herramientas, guarda estado, duerme y reactiva.
Enruta lecturas/escrituras entre RAM, corto plazo, vectorial e histórica.
Capa Operacional
Jerarquía operativa donde los LLMs son herramientas, no empleados:
Los directores definen objetivos y presupuestos; los agentes ejecutan; las herramientas (incluidos LLMs) amplifican capacidades.
Proveedores Cognitivos Abstractos
Se eliminan nombres de marca del núcleo. El router ve:
| Abstracción | Perfil | Uso típico |
|---|---|---|
| Proveedor A | Alta capacidad razonamiento | Análisis complejo, auditoría |
| Proveedor B | Equilibrio costo/latencia | Operación diaria, RAG |
| Proveedor C | Ultra económico | Clasificación, extracción simple |
| Local | Privacidad total | Datos sensibles, on-prem |
Enrutamiento por políticas
El router evalúa: criticidad, privacidad, latencia máxima, presupuesto por tarea y calidad histórica. Si falla, hace failover automático.
Protocolos de Comunicación
JSON-RPC over WebSockets
Comunicación bidireccional tipada entre UI, kernel y agentes. Ideal para streaming de tokens y eventos.
{ "jsonrpc":"2.0", "method":"agent.run", "params":{ "id":"auditor", "task":"conciliar" }, "id": 42 }MCP
Model Context Protocol para herramientas: descubrimiento, permisos y ejecución segura con esquemas.
Event-Driven
Bus de eventos para Signals → Events → Tasks. Desacopla productores y consumidores, habilita replay.
Jerarquía de Memoria
| Nivel | Tecnología | Contenido | TTL típico |
|---|---|---|---|
| 1. RAM (contexto inmediato) | Memoria de proceso | Ventana de conversación, scratchpad | segundos |
| 2. Corto Plazo | MongoDB / Redis | Estado de tareas, sesiones, locks | horas–días |
| 3. Vectorial | Supabase pgvector | Embeddings, RAG, conocimiento | semanas–meses |
| 4. Histórica | MongoDB Atlas | Auditoría, costos, trazas, aprendizajes | años |
Sistema Nervioso
Cada señal (webhook, email, cambio de dato) se normaliza a evento, se convierte en tarea DAG, consulta/escribe memoria y ejecuta acciones con herramientas.
Ciclo de Vida del Agente
MAXIQUEEN CONTROL CENTER
Facturación
Wallet por workspace con prepago y alertas. Desglose por agente, proveedor y tarea.
Estado de Plataforma
Vercel ● operativo · Supabase ● operativo · Ollama ● degradado · Groq ● operativo
Arquitectura Multi-Tenant
Aislamiento por workspace_id con RLS en Postgres y particionamiento lógico en Mongo. Cada workspace tiene wallet, políticas y claves propias.
- RLS: toda consulta filtra por workspace_id del JWT.
- Cuotas: tokens/min, concurrencia y almacenamiento por plan.
- Auditoría: traza inmutable por workspace.
Sistema de Blueprints y Clonación
Un blueprint es un JSON versionado que define rol, capacidades, memoria y políticas.
{
"id": "auditor_financiero",
"version": "2.0.3",
"parent": "director_financiero",
"rol": "Auditor Financiero",
"capacidades": ["conciliacion", "deteccion_anomalias", "reportes_sat", "n8n_trigger"],
"memoria": {
"corto_plazo": { "ttl": "7d" },
"vectorial": { "coleccion": "finanzas", "top_k": 8 },
"historica": { "retencion": "7y" }
},
"proveedores": { "preferidos": ["A","B"], "fallback": ["C","Local"] },
"politicas": { "privacidad": "alta", "costo_max_tarea_usd": 0.05, "latencia_p95_ms": 800 },
"herramientas": ["postgres", "sheets", "email", "storage"],
"kpis": { "precision_min": 0.97, "falsos_positivos_max": 0.02 }
}
Economía de Inferencia
Árbol de decisión
- ¿Privacidad alta o datos sensibles? → Local
- ¿Complejidad < 0.3 y costo crítico? → Proveedor C
- ¿Necesita razonamiento profundo? → Proveedor A
- Resto → Proveedor B con fallback
Algoritmo (JS)
function routeInference({tarea, complejidad, criticidad, presupuesto, privacidad}) {
if (privacidad === 'alta') return 'Local';
if (complejidad < 0.3 && presupuesto === 'bajo') return 'Proveedor C';
if (criticidad >= 0.8 || complejidad >= 0.7) return 'Proveedor A';
return 'Proveedor B'; // con fallback automático
}
// Uso:
const prov = routeInference({tarea:'conciliar', complejidad:0.65, criticidad:0.9, presupuesto:'medio', privacidad:'media'});
Separación Conceptual vs Implementación
| Componente Conceptual | Implementación Actual v2.0 | Notas |
|---|---|---|
| Gateway / Edge | Cloudflare + Vercel | TLS, WAF, rate limit |
| Kernel / Scheduler | Vercel Functions + Queue | DAG con reintentos |
| Memoria RAM | Proceso Node | context window |
| Memoria Corto Plazo | MongoDB / Redis | sesiones y locks |
| Memoria Vectorial | Supabase pgvector | RAG multi-tenant |
| Memoria Histórica | MongoDB Atlas | auditoría y costos |
| Proveedores | A/B/C/Local | enrutado por políticas |
| Observabilidad | Logs centralizados + métricas | Control Center |
Organigrama
Renombramiento
| v1.0 | v2.0 | Razón |
|---|---|---|
| Bot | Agente | Rol con memoria y KPI |
| Modelo | Proveedor Cognitivo | Abstracción multimarca |
| Base de conocimiento | Memoria Vectorial | Parte de jerarquía |
| Flujo | DAG de Tareas | Orquestación explícita |
Flujos
Onboarding Cliente
Signal (registro) → Event → Crear Workspace → Clonar Blueprints → Hidratar memoria → Activar agentes.
Conciliación Financiera
Job diario → Extraer movimientos → RAG políticas → Detectar anomalías → Reporte → Acción.
Escalabilidad
- Horizontal: workers sin estado, colas particionadas por workspace.
- Elástica: auto-scaling por backlog y latencia p95.
- Económica: cache semántico y batching reduce tokens ~30%.
Catálogo
Auditor Financiero
Conciliación, SAT, anomalías. SLA 800ms.
Closer Comercial
Califica, propone, agenda, hace follow-up.
Soporte Técnico
RAG sobre docs, crea tickets, cierra L1/L2.
Monetización
| Plan | Incluye | Desde |
|---|---|---|
| Starter | 3 agentes, 1 workspace, 500k tokens | $99/mes |
| Growth | 12 agentes, 3 workspaces, RLS, 5M tokens | $499/mes |
| Enterprise | Ilimitado, on-prem/Local, SSO, auditoría | Custom |
Roadmap
Manual Vivo
Este documento es la fuente de verdad operativa. Cada cambio de arquitectura actualiza el Control Center y versiona blueprints. Última actualización: Julio 2026.
Cómo proponer cambios
Abrir PR al repo del manual con diff de sección, impacto en costos/latencia y plan de rollback. Requiere aprobación de Director IA y Director Técnico.