Glosario

Referencia alfabética de los términos técnicos que se utilizan en la plataforma Rela AI.

---

Ably — Servicio de mensajería en tiempo real utilizado por Rela AI para entregar actualizaciones instantáneas al dashboard (eventos, alarmas, estados de tareas) a través de WebSocket.

Agente — Asistente de inteligencia artificial configurado para operar en un canal específico (WhatsApp, Email o HTTP). Cada agente tiene su propio prompt de sistema, herramientas asignadas y reglas de comportamiento.

AHI (Asset Health Index) — Puntuación de 0 a 100 que mide la condición general de un activo. Combina 5 sub-índices: condition, alarm_health, maintenance_compliance, trend_stability y anomaly_pressure. Los pesos son configurables por tenant.

Alert Aggregator — Servicio que consolida las detecciones de los 3 sistemas (anomaly, energy, prognostics) en una sola fila por activo dentro de la ventana alert_dedup_window_minutes. Ver Inbox Unificado.

anomaly_pressure — Uno de los 5 sub-índices del AHI (peso default 0.20). Penaliza por detecciones ML recientes (ventana 7d) según severidad canónica. Piso en 10 puntos.

Backlog — Lista de tareas pendientes que aún no han sido programadas o iniciadas.

Baseline — Parámetros normales de operación aprendidos a partir de datos históricos. Sirve como referencia para detectar desviaciones y anomalías en el comportamiento de un activo.

Canal — Medio de comunicación a través del cual un agente interactúa con los usuarios. Los canales soportados son WhatsApp, Email y HTTP (API REST).

CBM (Condition-Based Maintenance) — Estrategia de mantenimiento que se dispara según la condición real del equipo (vibraciones, temperatura, desgaste), en lugar de seguir un calendario fijo.

Colección — Conjunto de datos estructurados almacenados en la plataforma que un agente puede consultar para responder preguntas o ejecutar acciones basadas en información específica.

CSAT (Customer Satisfaction) — Encuesta corta que el agente WhatsApp o email envía automáticamente al cerrar una conversación (timeout de inactividad). Soporta 4 tipos de pregunta: scale_1_5, scale_1_10, yes_no, open_text. Ver features/csat para el flujo completo y agregados.

Digital Twin — Representación virtual de un activo físico que agrega todos los datos de diagnóstico, historial de mantenimiento, eventos y métricas en un solo punto de consulta.

config_version — Contador monotónico per-tenant del motor predictivo que se incrementa atómicamente en cada update_config. Cada snapshot persistido lleva el config_version activo en el momento del cálculo, habilitando trazabilidad de auditoría.

Drift — Cambio gradual de una métrica a lo largo del tiempo que se desvía del baseline establecido. Indica un posible deterioro progresivo del equipo. Detectable con Page-Hinkley sobre residuales.

Embedding — Representación vectorial de un fragmento de texto que permite realizar búsquedas semánticas. Se utiliza internamente para encontrar información relevante dentro de colecciones y documentos.

EPP (Equipo de Protección Personal) — Elementos de seguridad que debe usar un técnico: casco, guantes, lentes, etc.

Escalación — Cadena de notificaciones configurada para alarmas industriales que no han sido reconocidas dentro de un plazo determinado. Sigue los principios del estándar ISA 18.2.

Evento — Señal generada por una máquina o sistema industrial que es recibida por la plataforma a través de una fuente de eventos. Puede representar alarmas, mediciones o cambios de estado.

Evolution API — Conector de la API de WhatsApp Business utilizado por Rela AI para vincular números de WhatsApp, enviar y recibir mensajes a través de agentes conversacionales.

Extracción — Proceso automatizado mediante el cual la IA analiza documentos (PDF, imágenes, etc.) y extrae datos estructurados según un template predefinido.

Fuente de eventos — Punto de entrada de datos industriales hacia la plataforma. Puede ser un HTTP webhook, un broker MQTT o un servidor OPC UA.

Herramienta (Tool) — Capacidad específica que se asigna a un agente para que pueda ejecutar acciones concretas, como consultar una colección, crear una tarea o generar un reporte.

ISA 18.2 — Estándar internacional de gestión de alarmas industriales. Rela AI implementa sus principios para la priorización, escalación y ciclo de vida de alarmas.

ISO 13374 — Estándar internacional para monitoreo de condición y diagnóstico de máquinas. Define 6 niveles (L1-L6): adquisición de datos, manipulación, detección de estado, evaluación de salud, pronóstico y asesoría.

Kanban — Método visual para gestionar tareas usando un tablero con columnas (pendiente, en progreso, completada).

LOTO (Lock Out / Tag Out) — Procedimiento de seguridad que consiste en bloquear y etiquetar las fuentes de energía de un equipo antes de realizar tareas de mantenimiento, para prevenir arranques accidentales.

MQTT — Protocolo de mensajería ligero diseñado para dispositivos IoT y redes con ancho de banda limitado. Se utiliza como fuente de eventos para recibir datos de sensores y PLCs.

MTBF (Mean Time Between Failures) — Tiempo promedio entre fallas de un equipo. Mayor MTBF = mayor confiabilidad.

MTTR (Mean Time To Repair) — Tiempo promedio que toma reparar un equipo después de una falla. Menor MTTR = mejor capacidad de respuesta.

NPS (Net Promoter Score) — Métrica derivada de preguntas CSAT scale_1_10: NPS = %promotores (9-10) − %detractores (0-6). Se calcula on-the-fly desde los agregados de una pregunta única sobre recomendación. Ver features/csat.

OEE (Overall Equipment Effectiveness) — Métrica de manufactura que combina tres factores: disponibilidad (uptime), rendimiento (velocidad real vs. ideal) y calidad (piezas buenas vs. totales). Se expresa como porcentaje.

OPC UA — Protocolo industrial de comunicación máquina-a-máquina. Permite la lectura de variables y suscripción a eventos desde servidores OPC UA directamente en la plataforma.

OTP — Código de verificación de un solo uso (One-Time Password) enviado por WhatsApp o Email para autenticar a un usuario antes de acceder a información sensible.

PLC — Controlador lógico programable (Programmable Logic Controller). Dispositivo industrial que controla procesos automatizados y puede enviar eventos a la plataforma.

PM (Mantenimiento Preventivo) — Intervenciones programadas antes de que ocurra una falla, basadas en tiempo o uso del equipo.

Postmark — Servicio de entrega de email transaccional utilizado por Rela AI para enviar notificaciones por correo electrónico (alertas de alarmas, tareas asignadas, reportes).

Page-Hinkley — Test estadístico de cambio de media aplicado a streams de residuales. En Rela AI detecta drift silencioso tanto de RUL (sobre residuales de prognostics) como de consumo energético (sobre residuales vs baseline). Persiste eventos en _drift_events.

Prognostics — Disciplina que predice la vida útil restante de un equipo y anticipa fallas futuras basándose en datos históricos, tendencias y modelos de degradación.

Protocolos industriales — Rela AI soporta nativamente HTTP, MQTT, OPC UA (incl. Reverse Connect), Modbus TCP, S7comm (Siemens) y EtherNet/IP (CIP) (Allen-Bradley) para lectura y escritura. Ver Protocolos industriales.

QoS (Quality of Service) — Nivel de garantía de entrega en el protocolo MQTT. Nivel 0: entrega a lo sumo una vez. Nivel 1: al menos una vez. Nivel 2: exactamente una vez.

Rate of Change — Velocidad a la que cambia el valor de una métrica por unidad de tiempo. Un rate of change alto puede indicar una degradación acelerada que requiere atención inmediata.

RCA (Root Cause Analysis) — Análisis de causa raíz. Proceso para identificar por qué ocurrió una falla, no solo qué falló.

Registro — Dato individual almacenado dentro de una colección. Cada registro contiene campos definidos por el esquema de la colección.

Reporte — Documento PDF generado dinámicamente a partir de bloques de contenido (texto, tablas, gráficos). Los agentes pueden crear reportes como parte de sus herramientas.

RUL (Remaining Useful Life) — Estimación de las horas o ciclos restantes antes de que un equipo falle o requiera mantenimiento. Se calcula a partir de datos de condición y modelos de degradación. La confianza se expresa como banda bootstrap + contador de snapshots.

Severidad canónica — Escala común a los 3 detectores del pipeline predictivo (anomaly, energy, prognostics): info < warning < high < critical. Implementada en app/services/shared/utils/severity.py con adapters desde anomaly score, z-score y RUL hours. Estas son las severidades que aparecen en el inbox unificado y en las reglas del agregador.

Severidad de eventos (Machine Events) — Escala usada por el gateway de eventos industriales (webhook HTTP + listeners MQTT/OPC UA/Modbus/S7/EtherNet-IP): info < warning < critical < emergency. Enum MachineEventSeverity en app/models/machine_events/machine_events.py. Esta escala es legacy — precede al aggregator unificado y se mantiene por compatibilidad con integraciones existentes. El aggregator traduce critical/emergency de esta escala al high/critical canónico antes de consolidar.

Sesión — Estado de autenticación asociado a una conversación entre un usuario y un agente. Determina el nivel de acceso y los datos visibles durante la interacción.

SLA (Service Level Agreement) — Tiempos objetivo de respuesta y resolución para tareas y alarmas. Permite medir si los equipos de mantenimiento cumplen con los compromisos de atención establecidos.

SPC (Statistical Process Control) — Métodos estadísticos para monitorear y controlar procesos. Utiliza gráficos de control con límites calculados para detectar variaciones anormales en métricas de producción o condición de equipos.

Tarea — Unidad de trabajo asignable a uno o más miembros del equipo. Las tareas tienen estados (backlog, todo, en progreso, hecho, cancelada) y se gestionan en un tablero Kanban.

Template — Plantilla que define los campos y la estructura de datos a extraer de documentos mediante el proceso de extracción con IA.

Tenant — Organización o empresa con un espacio aislado dentro de la plataforma. Todos los datos, agentes y configuraciones pertenecen a un tenant específico.

Threshold — Límite configurable que dispara una acción cuando una métrica lo cruza. Se usa en reglas de alarma para definir cuándo una lectura de sensor es anormal (ej: vibración > 5 mm/s).

Tiempo real — Actualizaciones instantáneas entregadas vía WebSocket que permiten visualizar cambios en el dashboard sin necesidad de refrescar la página.

Webhook — Endpoint HTTP configurado para recibir eventos de forma automática desde sistemas externos. Se utiliza como fuente de eventos y para integraciones con terceros.

Z-score — Número de desviaciones estándar que un valor está por encima o por debajo de la media. Un Z-score mayor a 3 o menor a -3 generalmente indica un valor anómalo que merece investigación.