Rela AIRela AI Docs
Agentes de Maquinas

Fuentes de Eventos / Conexiones

Fuentes de datos industriales que conectan sensores, PLCs y SCADA a los agentes de Rela AI mediante HTTP, MQTT y OPC UA.

Fuentes de Eventos — Conexiones Industriales

Una Fuente de Eventos es el puente entre tu equipo industrial y Rela AI. Es la conexión que permite que un sensor de vibración, un PLC de línea o un sistema SCADA envíen sus datos al agente para que este los analice y reaccione. Sin fuentes configuradas, el agente no tiene información que procesar.

¿Para qué sirve?

Las plantas industriales generan miles de señales y eventos en tiempo real: alarmas de temperatura, lecturas de presión, estados de válvulas, contadores de producción. Esa información normalmente queda atrapada en el sistema de control — solo la ve el operador que está frente al panel.

Las Fuentes de Eventos permiten que esa información salga del sistema de control y llegue al agente de IA para:

  • Analizarla con contexto y detectar patrones que los umbrales simples no capturan
  • Crear órdenes de trabajo automáticamente cuando hay un problema
  • Notificar al personal correcto en el momento adecuado
  • Guardarla en el historial para análisis posterior y RCA

¿Cómo funciona?

Cada fuente se configura con un protocolo de comunicación específico. Rela AI soporta los tres protocolos más comunes en entornos industriales:

ProtocoloCuándo usarlo
HTTP (Webhook)Sistemas SCADA, ERPs, plataformas IoT que pueden hacer llamadas HTTP. Es el más fácil de integrar — tu sistema envía un mensaje a una URL cuando ocurre algo.
MQTTSensores IoT, gateways industriales, redes de sensores. Protocolo ligero ideal para dispositivos que transmiten datos continuamente.
OPC UAPLCs industriales (Siemens, Allen-Bradley, etc.), servidores de automatización, sistemas SCADA que tienen servidor OPC UA. Es el estándar de la industria para comunicación PLC-to-software.

¿Cómo usarlo?

Crear una fuente de eventos

Las fuentes se crean dentro de un Agente de Máquinas:

  1. Abre o crea un Agente de Máquinas en Alarmas.
  2. En la sección Fuentes de eventos, haz clic en Agregar fuente.
  3. Asigna un ID único a la fuente — este identificador no puede cambiarse después.
  4. Selecciona el protocolo.
  5. Completa los campos específicos del protocolo (ver abajo).
  6. Define la severidad mínima — solo procesará eventos con esa severidad o mayor.
  7. Define el throttle — mínimo de segundos entre dos eventos del mismo origen (evita inundaciones).

Configuración HTTP (Webhook)

La opción más sencilla. Rela AI genera una URL única y una API Key:

CampoDescripción
URL del webhookURL generada automáticamente — la configuras en tu sistema como destino de eventos
API KeyClave de autenticación — la incluyes en el header de cada llamada

Tu sistema envía los eventos haciendo un POST a esa URL con el cuerpo del evento en formato JSON.

Ejemplo de evento enviado via HTTP:

Tu SCADA detecta temperatura alta en el horno H-01 y envía:

  • Tipo de evento: "TEMPERATURA_ALTA"
  • Severidad: "critical"
  • Mensaje: "Temperatura horno H-01: 245°C (límite: 220°C)"
  • Datos adicionales: temperatura actual, fecha de último mantenimiento

Rela AI recibe ese mensaje, lo pasa al agente, y el agente decide qué hacer.

Configuración MQTT

Ideal para redes de sensores y dispositivos IoT:

CampoDescripción
URL del brokerDirección del broker MQTT de tu red (ej: mqtt://192.168.1.50:1883)
TopicEl canal al que está publicando tu sensor (ej: planta/linea1/bomba-c12/vibración)
QoSNivel de garantía de entrega: 0 = sin garantía, 1 = al menos una vez, 2 = exactamente una vez
Usuario / ContraseñaCredenciales del broker si tiene autenticación

Rela AI se suscribe al topic y procesa cada mensaje publicado por el sensor.

Configuración OPC UA

Para conectar directamente a PLCs y servidores OPC UA industriales:

CampoDescripción
URL del servidorDirección del servidor OPC UA (ej: opc.tcp://192.168.1.10:4840)
Node IDEl identificador del nodo a monitorear en el servidor OPC UA
Política de seguridadSin seguridad o con cifrado Basic256Sha256
Usuario / ContraseñaCredenciales del servidor OPC UA

El Node ID identifica la variable específica que quieres monitorear dentro del PLC. Tu programador de PLC o el documentación del sistema OPC UA lo tiene definido.

Gateways industriales compatibles

Si tienes equipos que usan protocolos más antiguos (Modbus RTU, Profibus, S7, EtherNet/IP) que no hablan directamente HTTP, MQTT u OPC UA, necesitas un gateway industrial que haga la traducción. Gateways compatibles probados:

GatewayProtocolos que convierte
HMS AnybusModbus, Profibus, PROFINET, EtherNet/IP → HTTP/MQTT/OPC UA
Siemens IOT2050S7, Modbus → HTTP/MQTT/OPC UA
Moxa ioThinxModbus, RS-485 → HTTP/MQTT/OPC UA
Advantech WISEModbus → HTTP/MQTT/OPC UA

Campo de mapeo de datos (Field Mapping)

El field mapping es cómo le dices a Rela AI qué significa cada campo del mensaje que llega del sensor. Esto es especialmente importante cuando cada equipo envía los datos en un formato diferente.

Por ejemplo:

  • Un sensor puede enviar la temperatura como "temp" en grados Fahrenheit
  • Otro sensor la envía como "temperatura_celsius" en grados Celsius

Con el field mapping configuras: "el campo temp es la temperatura, en Fahrenheit, conviértelo a Celsius". Así el agente siempre trabaja con datos normalizados independientemente del origen.

Estados de la fuente

Cada fuente muestra su estado en tiempo real:

EstadoColorQué significa
ConectadoVerdeRecibiendo eventos correctamente
ConectandoAmarillo (pulsante)Intentando establecer conexión
ErrorRojoProblema de conexión — revisar configuración
EsperandoAzulWebhook HTTP configurado, esperando primer evento

Severidades de eventos

SeveridadDescripciónAcción típica
InfoDato informativo, todo normalRegistrar, sin acción
WarningAlgo fuera del rango habitualRegistrar, monitorear
CriticalProblema que requiere atenciónCrear tarea, notificar técnico
EmergencySituación de emergenciaNotificación inmediata, escalamiento

Beneficios clave

  • Un solo lugar para gestionar todas las conexiones de tu planta
  • Soporte para los tres protocolos industriales más comunes
  • Throttle automático que evita inundaciones de alarmas
  • Filtrado por severidad mínima — solo procesa lo que importa
  • Estado en tiempo real de cada conexión para diagnóstico rápido
  • Compatible con los principales gateways industriales del mercado

Casos de uso comunes

Escenario 1: Conectar un sistema SCADA via Webhook El SCADA de la planta ya tiene una función para enviar alertas por HTTP cuando hay una alarma. Configuras una fuente HTTP en Rela AI, copias la URL y la API Key generadas, las pegas en la configuración del SCADA, y en minutos los eventos del SCADA empiezan a llegar al agente.

Escenario 2: Red de sensores IoT con MQTT Tienes 12 sensores de temperatura distribuidos en la planta, todos publicando en un broker MQTT local. Creas 12 fuentes MQTT en Rela AI (una por sensor con su topic específico) y el agente empieza a procesar las lecturas de todos en tiempo real.

Escenario 3: PLC Siemens con OPC UA Tu línea de producción tiene un PLC Siemens S7-1500 con servidor OPC UA habilitado. Configuras una fuente OPC UA con la dirección IP del PLC y el Node ID de la variable de alarma de parada de línea. Cada vez que el PLC activa esa variable, Rela AI recibe el evento y el agente crea automáticamente una tarea de mantenimiento.

En esta página