Arquitectura de Agentes

El Equipo de Agentes

Especialistas autónomos con memoria propia, herramientas propias y personalidad — coordinados por el Orquestador en su SovereignNode.

Fundamentos

¿Qué es un Agente AIMOS?

Un Agente AIMOS es un especialista autónomo que combina cuatro componentes clave:

M

Memory (Memoria)

Base de datos SQLite propia con memoria a largo plazo semántica, episódica y procedimental.

S

Skills (Herramientas)

Colección de herramientas especializadas: consultas SQL, llamadas REST, operaciones de archivos, funciones específicas del dominio.

L

LLM (Modelo de lenguaje)

Modelo local vía runtime LLM local. El agente construye el prompt completo a partir del system prompt, contexto de memoria y solicitud del usuario.

C

Connector (Conexión)

Canal de comunicación hacia el usuario: Telegram, e-mail, voz o panel de control.

AGENT Especialista autónomo Memory SQLite + Embeddings Skills SQL, REST, Archivo, Dominio LLM LLM Runtime (local) Connector Telegram, E-mail, Voz Memory + Skills + LLM + Connector = Agent

Modo de trabajo

El Agente como colaborador digital

Un Agente AIMOS no funciona como un chatbot — trabaja como un empleado con su propio escritorio, sus propios archivos y su propio ritmo diario.

Memoria

Recuerda hechos, correcciones, preferencias — permanentemente. La búsqueda semántica encuentra recuerdos incluso con otras palabras.

Notas & Archivo

Escribe resúmenes, resultados de investigación y notas de conversación en su propio espacio de trabajo — como un empleado que gestiona sus carpetas.

Calendario

Citas, plazos, seguimientos. El agente ve en cada interacción sus fechas pendientes y vencidas — y actúa de forma proactiva.

Lista de tareas

Tareas abiertas, delegaciones, listas de espera. Se actualiza automáticamente durante el ciclo Dreaming.

Ritmo diario

Una vez al día, el agente revisa autónomamente el calendario, los e-mails y las tareas abiertas — incluso sin que nadie le hable.

Dreaming

En periodos tranquilos, el agente procesa sus conversaciones: extrae hechos, actualiza notas y listas de tareas, consolida su memoria.

Trabajo en equipo

Los agentes se comunican entre sí — el Agente Financiero consulta al Agente de Logística sobre niveles de stock, sin molestar al usuario.

Escalamiento

Para preguntas complejas, el agente escala automáticamente a un modelo de IA más potente — anonimizado y registrado de forma auditable.

El resultado: Un Agente AIMOS tiene todo lo que un empleado necesita — memoria, notas, calendario, lista de tareas, colegas, un ritmo diario y la capacidad de pedir ayuda cuando la necesita. La única diferencia: Trabaja las 24 horas, no olvida nunca nada y está disponible en segundos.

SKILL_REGISTRY

18 Habilidades en la caja de herramientas

Cada agente recibe exactamente las habilidades que necesita — ensambladas de forma modular desde el registro central. Se pueden desarrollar y añadir habilidades personalizadas en cualquier momento — para cada sector, cada sistema ERP, cada flujo de trabajo.

Engineering

structural

9 Tools

Cálculo FEM, optimización de perfiles, procesamiento DXF, verificación de normas, exportación de listas de materiales.

file_ops

7 Tools

Leer, escribir, buscar, listar archivos. Gestión del espacio de trabajo con separación público/privado.

brave_search

1 Tool

Búsqueda web vía API de Brave Search. Información actual sin dependencia de la nube.

Communication

email

2 Tools

Enviar y recibir e-mails vía IMAP/SMTP. HTML y archivos adjuntos.

mail_monitor

3 Tools

Monitorización de buzón POP3. Detecta nuevos e-mails y activa acciones automáticamente.

voice_io

Kontext

Whisper STT + Piper TTS. Reconocimiento y síntesis de voz en todos los idiomas, procesados localmente.

Storage

shared_storage

3 Tools

Intercambio de archivos inter-agentes a través de la carpeta public/. Lectura, escritura, listado.

remote_storage

4 Tools

Acceso SFTP a máquinas remotas vía Tailscale VPN. Recuperar y depositar archivos desde el puesto de trabajo.

Planning

scheduler

2 Tools

Tareas programadas: ritmo diario, verificaciones recurrentes, recordatorios.

calendar

4 Tools

Crear, consultar, modificar, eliminar citas. Recordatorios proactivos para fechas de vencimiento.

contacts

3 Tools

Gestión de contactos: personas, empresas, números de teléfono, direcciones de e-mail, notas.

persistence

3 Tools

Almacenamiento permanente de notas y pares clave-valor. Base de conocimiento propia del agente.

Intelligence

hybrid_reasoning

1 Tool

Escalamiento a modelo más potente. Solicitud anonimizada a LLM en la nube para análisis complejos.

tr_calendar_awareness

3 Tools

Festivos turcos, Ramadán, noches de Kandil. Conciencia del contexto cultural.

football_observer

2 Tools

Resultados de fútbol y calendarios. Notificaciones proactivas para partidos importantes.

Accounting

eta_firebird

4 Tools

Contabilidad ETA V8 vía Firebird/InterBase. Consulta de cuentas, facturas abiertas, resumen diario.

eta_mssql

4 Tools

Contabilidad ETA V8 vía Microsoft SQL Server. Mismas funciones, diferente backend de base de datos.

web_automation

2 Tools

Automatización de navegador para portales web sin API. Rellenar formularios, extraer datos.

Conexión

Conectores actualmente disponibles

El agente se comunica a través de conectores — interfaces estandarizadas hacia usuarios, sistemas y otros agentes. Se desarrollan nuevos conectores continuamente y se pueden añadir en cualquier momento para su infraestructura IT específica.

Telegram

Texto, mensajes de voz, documentos. Mensajes proactivos para recordatorios, alarmas y resultados. Shared Listener para todos los agentes.

E-Mail

IMAP/SMTP para envío y recepción. Monitorización POP3 para buzones de entrada. Formato HTML y archivos adjuntos.

Voice

Whisper STT + Piper TTS — completamente local. Reconocimiento y síntesis de voz en todos los idiomas, sin servicios en la nube.

SFTP

Acceso a archivos en el puesto de trabajo vía Tailscale VPN. Carpeta compartida para DXF, PDF, Excel — cifrada y sin puertos abiertos.

Bases de datos SQL

PostgreSQL, MSSQL, Firebird — exclusivamente consultas SELECT. Sin acceso de escritura a datos de producción. Read-Only by Design.

REST / SOAP API

Conexión API universal para ERP, CRM, gestión de mercancías. GET, POST, PUT con autenticación configurable.

3-Tier Memory

Memoria a largo plazo

Tres tipos de memoria, búsqueda híbrida y un ciclo Dreaming para la consolidación.

Semántico Hechos & Conocimiento "Stahlpreis Q1: 850 EUR/t" "Uyumsoft API: /api/v2/stock" "Lieferant X: 14 Tage Vorlauf" Episódico Experiencias & Conversaciones "2026-03-15: Bestandsabfrage" "2026-03-18: Preisvergleich" "2026-03-20: CAD-Analyse" Procedimental Procesos & Patrones "Bestellung: Prüfen→Freigabe→Buchen" "BOM-Export: DWG→Parse→CSV" "Inventur: SQL→Diff→Report" Hybrid-Suche: FTS5 + Vektor-Embeddings + RRF Fusion El ranking de relevancia combina resultados por palabras clave y semánticos

Dreaming — Consolidación de memoria por llamada LLM

En reposo, el agente analiza sus conversaciones con una llamada LLM, extrae hechos, actualiza notas y listas de tareas, consolida su memoria y genera informes semanales.

Como el cerebro humano durante el sueño — el agente condensa experiencias en conocimiento, elimina entradas redundantes y refuerza conexiones importantes. El resultado: respuestas más precisas con menor consumo de tokens.

Ciclo Dreaming (Consolidación)

Como el cerebro humano durante el sueño, AIMOS consolida recuerdos en reposo:

Recopilar episodios Todas las conversaciones Reconocer patrones Análisis LLM Condensar Extraer hechos Almacenar semánticamente Memoria a largo plazo

Optimización de tokens

Cognitive Balance

Equilibrio dinámico entre profundidad de memoria y longitud de respuesta — dentro de la ventana de contexto limitada.

Profundidad Memoria Longitud Respuesta 1 2 3 4 5 System Prompt Memory Respuesta Ventana de contexto (ej. 32k Tokens) Más Memory = menos espacio para respuesta (y viceversa)
Level Memory Respuesta
1 Minimal Muy larga
2 Reducida Larga
3 Equilibrada Media
4 Profunda Corta
5 Maximum Minimal

Coordinación

Agentes en equipo

Mensajería inter-agentes, archivos compartidos y protección de datos impuesta por la arquitectura.

Comunicación inter-agentes

Agente de Construcción Análisis CAD Listas de materiales Agente de Logística Verificación de stock Acceso ERP PostgreSQL Relay Tabla message_relay "Necesito stock de acero" Reenvío Límite Ping-Pong: máx. 3 rondas

Connector Families

Los agentes de la misma Connector Family comparten un canal de comunicación. Los mensajes a la familia se enrutan automáticamente al agente competente.

Protección Ping-Pong

Máximo 3 rondas de ida y vuelta entre dos agentes por solicitud. Evita bucles infinitos y consumo descontrolado de tokens.

Espacio de trabajo & protección interna de datos

Cada agente tiene su propio espacio de trabajo — como un escritorio cerrado con llave. Solo los archivos compartidos explícitamente son visibles para los demás.

Ingeniero Privado (bloqueado) notes/, calendar.json contacts.json, todo.txt steel_profiles.json public/ (compartido) stueckliste.pdf report_projekt_X.dxf Agente Financiero Privado (bloqueado) notes/, calendar.json market_prices.json contacts.json public/ (compartido) kalkulation_projekt_X.pdf read_public bloqueado public/ — todos los agentes pueden leer privado — solo el agente propietario Intercambio de archivos vía read_public Acceso denegado

public/ — Compartición deliberada

Informes, exportaciones, listas de materiales — todo lo que otros agentes necesitan. El agente decide por sí mismo qué comparte.

Zona privada — Invisible

Notas, calendario, contactos, listas de tareas, bases de datos de perfiles. Ningún otro agente tiene acceso — impuesto por la arquitectura, no por política.

Ejemplo: El Agente de Construcción lee un archivo DXF del puesto de trabajo del ingeniero, crea una lista de materiales y la coloca en public/. El Agente Financiero lee la lista de materiales y calcula los costes de material — sin acceso a las notas de construcción.

Seguridad

Execution Rings

Tres niveles de confianza determinan qué herramientas puede usar un agente. Como en un núcleo de sistema operativo.

Ring 2 — Full Access Ring 1 — Standard Ring 0 Read Only sql_query, rest_get memory_search, file_read file_write, sql_execute rest_post, email_send shell_exec memory_recall config_read
0

Ring 0 — Read Only

Riesgo mínimo. El agente solo puede leer: consultar memoria, ver configuración. Sin acceso a sistemas externos, sin acceso de escritura.

memory_recall config_read time_now
1

Ring 1 — Standard

Acceso de lectura a sistemas externos. SQL-SELECT, REST-GET, lectura de archivos. Sin acceso de escritura a datos de producción. Ring estándar para la mayoría de los agentes.

sql_query rest_get file_read memory_search brave_search
2

Ring 2 — Full Access

Acceso completo incluyendo operaciones de escritura. Requiere activación explícita por el administrador. Human-in-the-Loop para acciones críticas.

file_write sql_execute rest_post email_send shell_exec

Ejemplos prácticos

Agentes de ejemplo

Tres tipos de agentes preconfigurados para entornos industriales típicos.

Agente de Construcción

Ring 1 — Standard

Calcula estructuras portantes con motor FEM integrado (PyNite), optimiza perfiles de acero por peso y coste, verifica normas sísmicas (TBDY 2018, Eurocode). Crea listas de materiales como borrador — el ingeniero revisa y aprueba.

Skills
fem_calc profile_optimize seismic_check bom_generate
Conectores
PyNite FEM DXF TBDY 2018 Eurocode

Agente de Logística

Ring 1 — Standard

Integra Uyumsoft, SAP, Navision y otros sistemas ERP. Monitoriza el inventario en tiempo real, reporta umbrales críticos y automatiza solicitudes de aprovisionamiento vía conectores SQL y REST.

Skills
sql_query rest_get stock_check alert_send
Conectores
Uyumsoft SAP RFC Navision REST

Agente Financiero

Ring 1 — Estándar (Escritura: Ring 2)

Integra ETA V8, DATEV y otros sistemas contables. Analiza el flujo de caja, prepara asientos y proporciona saldos actualizados. Validación de asientos solo por empleados autorizados.

Skills
sql_query cashflow_calc booking_prep datev_export
Conectores
ETA V8 DATEV Firebird MSSQL

Estos son ejemplos. Los agentes AIMOS se configuran individualmente por empresa — cada agente se adapta a los sistemas y requisitos específicos.