Conexiones externas

Como funciona

Una herramienta de conexion externa permite que tu agente se comunique con sistemas fuera de la plataforma durante una conversacion. Soporta tres protocolos:

• HTTP — Llamadas a APIs REST (GET, POST, PUT, PATCH, DELETE)
• MQTT — Mensajes a dispositivos IoT o brokers de mensajeria
• OPC UA — Comunicacion directa con maquinaria industrial (PLCs, SCADA, DCS)

Configuracion HTTP

Plantilla del body

La plantilla del body define la estructura base de la solicitud. Los parametros que el agente obtiene del usuario se combinan con esta plantilla. Esto permite incluir campos fijos (como API keys o identificadores) sin que el agente tenga que solicitarlos.

Configuracion MQTT

Configuracion OPC UA

Operaciones OPC UA

Pool de conexiones

La plataforma mantiene un pool de conexiones OPC UA reutilizables. Esto significa que las conexiones no se abren y cierran en cada operacion, sino que se reutilizan automaticamente. El pool esta optimizado para:

• Maximo 5 conexiones por servidor
• Conexiones inactivas se cierran despues de 5 minutos
• Reconexion automatica si la conexion expira

Ejemplo: API REST

Escenario: Un agente que consulta el clima en una API externa.

1. Crea una herramienta de conexion externa.
2. Configura:
   • URL: https://api.weather.com/current
   • Metodo: GET
   • Headers: {"Authorization": "Bearer tu-api-key"}
3. Agrega un parametro city para que el agente pregunte la ciudad.
4. Asigna la herramienta al agente.

Ejemplo: Dispositivo IoT (MQTT)

Escenario: Un agente de voz que enciende o apaga maquinas via MQTT.

1. Crea una herramienta de conexion externa con protocolo MQTT.
2. Configura:
   • Broker: mqtt://192.168.1.100:1883
   • Topic: factory/machines/control
   • QoS: 1
3. Agrega parametros para machine_id y action (on/off).
4. Cuando el usuario dice "enciende la maquina 5", el agente publica el comando MQTT correspondiente.

Ejemplo: Maquinaria industrial (OPC UA)

Escenario: Un agente de voz que lee la temperatura de un sensor industrial en un PLC Siemens.

1. Crea una herramienta de conexion externa con protocolo OPC UA.
2. Configura:
   • Servidor: opc.tcp://192.168.1.10:4840
   • Nodo: ns=2;s=Temperature
   • Operacion: Leer valor
3. No necesitas parametros — el agente leera el valor directamente.
4. Cuando el usuario dice "cual es la temperatura actual", el agente lee el nodo OPC UA y responde con el valor.

Ejemplo: Escribir un valor en un PLC

1. Configura la herramienta con operacion Escribir valor.
2. Agrega un parametro temperatura_objetivo (tipo number).
3. Cuando el usuario dice "ajusta la temperatura a 75 grados", el agente escribe el valor en el nodo OPC UA.

IoT Gateways

Los gateways IoT (HMS Anybus, Siemens IOT2050, Moxa ioLogik, Advantech WISE) ya estan soportados nativamente — estos dispositivos exponen APIs REST o brokers MQTT que puedes conectar directamente usando los protocolos HTTP o MQTT:

Probar la conexion

Antes de asignar la herramienta a un agente, puedes probar la conexion directamente desde el formulario de creacion. El panel de prueba:

1. Muestra que flujo de datos se ejecutara segun el protocolo y operacion configurados.
2. Permite especificar parametros de prueba en formato JSON.
3. Ejecuta la conexion real y muestra el resultado (exito/error, tiempo de respuesta, datos recibidos).