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:
| Tipo | Protocolo | Para qué sistemas |
|---|---|---|
| HTTP | REST API (GET, POST, PUT, DELETE) | ERPs, CMMs externos, APIs de proveedores, servidores web |
| MQTT | Mensajería IoT | Brokers de sensores, dispositivos IoT, gateways industriales |
| OPC UA | Protocolo industrial estándar | PLCs, 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:
- Ve a Herramientas y crea una nueva herramienta de tipo Conexión externa.
- Selecciona protocolo HTTP.
- Configura:
| Campo | Descripción | Ejemplo |
|---|---|---|
| URL del endpoint | La dirección del servicio externo | https://erp.empresa.com/api/inventario |
| Método | Tipo de operación | GET para consultar, POST para crear |
| Headers | Cabeceras de autorización | Authorization: Bearer tu-api-key |
| Timeout | Tiempo máximo de espera | 30 segundos |
- Agrega parámetros que el agente recopilará del usuario (código de parte, nombre del equipo, etc.).
- Guarda y asigna al agente.
Crear una conexión MQTT
Para enviar comandos o consultar datos de dispositivos IoT:
- Crea herramienta de tipo Conexión externa, protocolo MQTT.
- Configura:
| Campo | Descripción | Ejemplo |
|---|---|---|
| URL del broker | Dirección del broker MQTT | mqtt://192.168.1.100:1883 |
| Topic | El tema al que publicar o suscribirse | planta/compresores/C-01/control |
| QoS | Calidad del servicio (0=sin garantía, 1=al menos una vez, 2=exactamente una vez) | 1 para comandos importantes |
| Usuario / Contraseña | Credenciales del broker (si aplica) | — |
Crear una conexión OPC UA
Para leer o escribir valores directamente en PLCs y maquinaria industrial:
- Crea herramienta de tipo Conexión externa, protocolo OPC UA.
- Configura:
| Campo | Descripción | Ejemplo |
|---|---|---|
| URL del servidor | Dirección del servidor OPC UA | opc.tcp://192.168.1.10:4840 |
| ID del nodo | Identificador del dato a leer/escribir | ns=2;s=Temperatura_Compresor_C01 |
| Operación | Leer valor, Escribir valor, o Llamar método | Leer valor |
Las tres operaciones OPC UA disponibles:
| Operación | Cuándo usarla |
|---|---|
| Leer valor | Consultar el estado actual de un sensor o variable del PLC |
| Escribir valor | Cambiar un parámetro del equipo (setpoint, velocidad, etc.) |
| Llamar método | Ejecutar 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:
| Gateway | Protocolo expuesto | Cómo conectar |
|---|---|---|
| HMS Anybus (Modbus→HTTP) | HTTP POST | Configura la URL del gateway como endpoint HTTP |
| Siemens IOT2050 | MQTT | Conecta al broker MQTT del gateway |
| Moxa ioLogik | HTTP GET | Usa la API REST del dispositivo |
| Advantech WISE | HTTP REST | Usa 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:
- En la pantalla de configuración de la herramienta, haz clic en Probar conexión.
- Ingresa los valores de los parámetros para la prueba.
- El sistema ejecuta la conexión real y muestra: si fue exitosa, el tiempo de respuesta, y los datos recibidos.
- 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."
Herramientas de Acción Integradas
Acciones predefinidas que tus agentes de IA pueden ejecutar directamente desde una conversación: asignar tareas, enviar mensajes, generar reportes y más.
Protocolos Industriales (Modbus, S7, EtherNet/IP)
Conecta el agente directamente a PLCs y variadores mediante Modbus TCP, S7comm (Siemens S7-1200/1500) y EtherNet/IP (Allen-Bradley). Lectura y escritura sin gateways.