Rela AIRela AI Docs
Herramientas

Conexiones Externas

Las herramientas de conexión externa permiten al agente comunicarse con sistemas fuera de Rela AI: APIs de otros sistemas, dispositivos IoT por MQTT, y maquinaria industrial por OPC UA.

Conexiones Externas

Los datos que necesita el agente no siempre están en las colecciones de Rela AI. A veces están en el ERP de la empresa, en un servidor de historial de procesos, en el broker MQTT de los sensores de campo, o directamente en el PLC del compresor. Las herramientas de conexión externa son el canal que permite al agente consultar y actuar en esos sistemas sin intermediarios.

¿Para qué sirve?

En una planta industrial, los datos están distribuidos en múltiples sistemas: el SCADA tiene las lecturas en tiempo real, el ERP tiene las órdenes de compra y el inventario, el servidor OPC UA tiene los estados de los PLCs. Las conexiones externas permiten que el agente acceda a todos esos sistemas desde una misma conversación — sin que el técnico tenga que ir de pantalla en pantalla buscando información.

Las conexiones externas permiten al agente:

  • Consultar datos de sistemas externos en tiempo real durante una conversación
  • Leer valores directamente de PLCs y maquinaria industrial por OPC UA
  • Publicar comandos a dispositivos IoT por MQTT
  • Integrar con ERP, CMMS externos, o APIs de proveedores
  • Recibir datos de gateways industriales como HMS Anybus, Siemens IOT2050, Moxa o Advantech

¿Cómo funciona?

Hay tres tipos de conexión disponibles según el protocolo del sistema externo:

TipoProtocoloPara qué sistemas
HTTPREST API (GET, POST, PUT, DELETE)ERPs, CMMs externos, APIs de proveedores, servidores web
MQTTMensajería IoTBrokers de sensores, dispositivos IoT, gateways industriales
OPC UAProtocolo industrial estándarPLCs, SCADA, DCS, maquinaria con servidor OPC UA

El agente llama a la herramienta cuando lo necesita, el sistema hace la conexión en tiempo real, y devuelve el resultado al agente para que lo incorpore en su respuesta.

¿Cómo usarlo?

Crear una conexión HTTP (REST API)

Para conectar con cualquier sistema que tenga una API web:

  1. Ve a Herramientas y crea una nueva herramienta de tipo Conexión externa.
  2. Selecciona protocolo HTTP.
  3. Configura:
CampoDescripciónEjemplo
URL del endpointLa dirección del servicio externohttps://erp.empresa.com/api/inventario
MétodoTipo de operaciónGET para consultar, POST para crear
HeadersCabeceras de autorizaciónAuthorization: Bearer tu-api-key
TimeoutTiempo máximo de espera30 segundos
  1. Agrega parámetros que el agente recopilará del usuario (código de parte, nombre del equipo, etc.).
  2. Guarda y asigna al agente.

Crear una conexión MQTT

Para enviar comandos o consultar datos de dispositivos IoT:

  1. Crea herramienta de tipo Conexión externa, protocolo MQTT.
  2. Configura:
CampoDescripciónEjemplo
URL del brokerDirección del broker MQTTmqtt://192.168.1.100:1883
TopicEl tema al que publicar o suscribirseplanta/compresores/C-01/control
QoSCalidad del servicio (0=sin garantía, 1=al menos una vez, 2=exactamente una vez)1 para comandos importantes
Usuario / ContraseñaCredenciales del broker (si aplica)

Crear una conexión OPC UA

Para leer o escribir valores directamente en PLCs y maquinaria industrial:

  1. Crea herramienta de tipo Conexión externa, protocolo OPC UA.
  2. Configura:
CampoDescripciónEjemplo
URL del servidorDirección del servidor OPC UAopc.tcp://192.168.1.10:4840
ID del nodoIdentificador del dato a leer/escribirns=2;s=Temperatura_Compresor_C01
OperaciónLeer valor, Escribir valor, o Llamar métodoLeer valor

Las tres operaciones OPC UA disponibles:

OperaciónCuándo usarla
Leer valorConsultar el estado actual de un sensor o variable del PLC
Escribir valorCambiar un parámetro del equipo (setpoint, velocidad, etc.)
Llamar métodoEjecutar una función del servidor (arrancar, detener, resetear)

Las operaciones de escritura y llamada de métodos en OPC UA modifican el comportamiento de la maquinaria. Úsalas solo con agentes cuyo prompt incluya las restricciones de seguridad apropiadas y requiera confirmación explícita del operador antes de ejecutar.

Gateways industriales compatibles

Los gateways que convierten protocolos industriales legacy (Modbus, Profibus, EtherNet/IP) a protocolos que Rela AI soporta nativo:

GatewayProtocolo expuestoCómo conectar
HMS Anybus (Modbus→HTTP)HTTP POSTConfigura la URL del gateway como endpoint HTTP
Siemens IOT2050MQTTConecta al broker MQTT del gateway
Moxa ioLogikHTTP GETUsa la API REST del dispositivo
Advantech WISEHTTP RESTUsa los endpoints de la API REST del gateway

Probar la conexión antes de asignar al agente

Antes de asignar la herramienta al agente, prueba que funcione:

  1. En la pantalla de configuración de la herramienta, haz clic en Probar conexión.
  2. Ingresa los valores de los parámetros para la prueba.
  3. El sistema ejecuta la conexión real y muestra: si fue exitosa, el tiempo de respuesta, y los datos recibidos.
  4. Si hay error, muestra el mensaje del sistema externo para diagnosticar el problema.

Probar antes de activar evita que el agente responda con errores confusos cuando los técnicos lo usen en producción.

Beneficios clave

  • El agente accede a datos en tiempo real de cualquier sistema de la planta
  • Tres protocolos que cubren prácticamente toda la infraestructura industrial existente
  • Lecturas OPC UA directas desde PLC sin necesidad de exportar datos manualmente
  • Integración con gateways industriales que ya están instalados en la planta
  • Prueba de conexión incluida en la configuración para validar antes de activar
  • El agente combina datos de múltiples conexiones externas en una sola respuesta

Casos de uso comunes

Escenario 1: Agente que consulta el ERP para piezas El técnico pregunta al agente: "¿Cuántas unidades del filtro Baldwin B7144 hay en el almacén?" El agente llama a la herramienta HTTP apuntando a la API del ERP con el código de parte. El ERP responde: 8 unidades en almacén central, 2 en almacén planta norte. El agente le responde al técnico directamente con esas cantidades y ubicaciones, sin necesidad de que el técnico entre al ERP.

Escenario 2: Agente que lee temperatura en tiempo real del PLC El supervisor le pregunta al agente: "¿Cuál es la temperatura actual del compresor C-01?" El agente llama a la herramienta OPC UA configurada con el nodo de temperatura del compresor. Lee el valor directamente del PLC: 68.4°C. Compara con la línea base del activo y responde: "Temperatura actual del C-01: 68.4°C. Está dentro del rango normal (línea base 65°C ± 5°C)."

Escenario 3: Agente que publica comando de reinicio por MQTT El operador le dice al agente: "Necesito reiniciar la bomba dosificadora B-09." El agente reconoce que esta acción requiere confirmación explícita (según su prompt de seguridad) y pregunta: "¿Confirmas que quieres reiniciar la bomba B-09? Esta acción detendrá el dosificado por aproximadamente 30 segundos." El operador confirma. El agente publica el comando en el topic MQTT correspondiente. La bomba recibe el comando, ejecuta el reinicio, y el agente confirma: "Comando de reinicio enviado a B-09. El equipo debería estar operativo en 30 segundos."

En esta página