Herramientas para Agentes de IA

Las Herramientas son lo que convierte a un agente de IA de un chatbot que solo conversa en un asistente industrial que puede buscar datos, crear tareas, generar reportes y conectarse a sistemas externos. Sin herramientas, el agente responde con conocimiento general. Con herramientas, responde con los datos reales de tu planta.

¿Para qué sirve?

Imagina que configuras un agente de WhatsApp para el equipo de mantenimiento. Sin herramientas, el agente puede responder preguntas generales pero no sabe nada de tu planta en específico. Con herramientas configuradas, puede:

• Buscar en tu base de datos de activos y fichas técnicas
• Crear órdenes de trabajo directamente en el tablero Kanban
• Generar un reporte PDF en el momento
• Consultar el stock de un repuesto en el inventario
• Llamar a tu API de ERP para registrar una orden de compra
• Publicar un mensaje MQTT a un controlador de planta

Cada herramienta es una capacidad específica que defines tú — el agente decide automáticamente cuándo y cómo usarla según la conversación.

¿Cómo funciona?

Cuándo asignas herramientas a un agente, el modelo de IA recibe la descripción de cada herramienta. Durante una conversación, el modelo analiza el mensaje del usuario y decide si necesita usar alguna herramienta para responder correctamente.

Por ejemplo: si el usuario pregunta "¿qué rodamiento usa la bomba B-07?", el agente reconoce que necesita buscar en la base de datos de activos, activa la herramienta de consulta, ejecuta la búsqueda, y usa el resultado para responder con precisión.

La clave está en la descripción de la herramienta: el agente la lee para entender cuándo debe usarla. Una descripción clara y específica produce un agente que sabe cuándo activar cada herramienta.

Los 4 tipos de herramientas

1. Query — Consulta semántica

Para qué sirve: Buscar información en las colecciones de registros de Rela AI usando lenguaje natural.

Cómo funciona: Usa búsqueda vectorial (semántica) — no busca solo por palabras exactas, sino por significado. La consulta "falla hidráulica compresor" puede encontrar registros que hablan de "avería sistema neumático compresor central".

Cuándo usarla:

• Buscar fichas técnicas de equipos
• Consultar historial de mantenimiento en registros
• Buscar proveedores o repuestos en el inventario
• Consultar manuales de equipos digitalizados

Configuración: Selecciona la colección de registros donde buscar. El sistema sugiere automáticamente los parámetros basados en los campos de la colección.

2. Action — Función interna del sistema

Para qué sirve: Ejecutar acciones dentro de Rela AI: crear tareas, generar reportes, localizar personal, asignar trabajo.

Cuándo usarla: Cuándo el agente necesita hacer algo en el sistema, no solo consultar.

Acciones disponibles:

Ejemplo de uso: El técnico escribe "hay una fuga en la bomba B-12, crea una tarea urgente". El agente activa la acción assign_task con título "Fuga detectada — Bomba B-12", prioridad "urgent", departamento "Mantenimiento-Mecanico".

3. HTTP — Conexión a APIs externas

Para qué sirve: Conectar el agente a cualquier sistema externo que tenga una API REST: ERPs, sistemas de inventario, plataformas de proveedores, servicios de información industrial.

Cuándo usarla: Cuándo los datos que necesitas no están en Rela AI sino en otro sistema de tu empresa.

Configuración: Define la URL del endpoint, el método HTTP (GET, POST, PUT), los headers necesarios (autenticación, Content-Type), y los parámetros que el agente debe enviar.

Ejemplo de uso: Conectar al ERP de la empresa para consultar el stock de un repuesto específico, o registrar una orden de compra directamente desde el chat de WhatsApp.

4. MQTT / OPC UA — Protocolos industriales

Para qué sirve: Publicar mensajes directamente a equipos industriales o leer valores en tiempo real desde PLCs y sensores.

Cuándo usarla: Cuándo el agente necesita interactuar con equipos de planta — enviar un comando a un controlador, leer un valor actual de un sensor, o disparar una acción en un PLC.

Ejemplo de uso: El operador escribe "activa el modo de bajo consumo en la línea B". El agente publica un mensaje MQTT al controlador de la línea B con el parámetro de modo bajo consumo.

¿Cómo crear una herramienta?

1. Ve a Herramientas en la barra lateral.
2. Haz clic en Crear Herramienta.
3. Define el nombre (sin espacios, ej: buscar_activo o crear_tarea_urgente).
4. Escribe una descripción clara que explique qué hace y cuándo usarla. Esta es la instrucción que el agente lee para decidir si activar la herramienta.
   • Usa el botón Optimizar con IA para mejorar la descripción automáticamente.
5. Selecciona el tipo (Query, Action, HTTP, MQTT/OPC UA).
6. Configura los parámetros — qué información debe recopilar el agente del usuario antes de ejecutar.
7. Define los mensajes de respuesta: qué decirle al usuario cuando la herramienta tiene éxito, cuando falla, o cuando no encuentra resultados.
8. Guarda la herramienta.

Parámetros de la herramienta

Los parámetros son los datos que el agente necesita recopilar para ejecutar la herramienta. Por ejemplo, para la herramienta "buscar_activo":

• nombre_activo (texto, requerido): "El nombre o código del equipo a buscar"
• planta (texto, opcional): "En qué planta está el equipo"

El agente pedirá estos datos al usuario antes de ejecutar la herramienta si no están en el contexto de la conversación.

Asignar herramientas a un agente

Las herramientas se asignan al crear o editar un agente (WhatsApp, Email o Máquinas). Un agente puede tener múltiples herramientas. Para cada herramienta asignada, puedes agregar instrucciones adicionales específicas para ese agente — por ejemplo: "usa esta herramienta solo cuando el usuario pregunte específicamente por el historial de un equipo, no para consultas generales".

Beneficios clave

• Convierte agentes conversacionales en asistentes industriales con capacidades reales
• La descripción de la herramienta controla cuándo se activa — sin programación
• Cuatro tipos cubren todos los casos de uso: consulta, acción interna, API externa y protocolo industrial
• Parámetros configurables para que el agente recopile exactamente los datos necesarios
• Mensajes de respuesta personalizados para una comunicación clara con el técnico
• Una herramienta puede asignarse a múltiples agentes con instrucciones diferentes en cada uno

Casos de uso comunes

Escenario 1: Agente que puede consultar y actuar El agente de WhatsApp del equipo de mantenimiento tiene 3 herramientas: "buscar_activo" (Query en la colección de activos), "consultar_historial" (Query en la colección de mantenimiento), y "crear_tarea" (Action: assign_task). Cuándo el técnico reporta un problema, el agente consulta el historial del equipo y crea la tarea automáticamente, todo en el mismo chat.

Escenario 2: Agente conectado al ERP La empresa tiene un ERP con API REST para consultar inventario. Se crea una herramienta HTTP apuntando al endpoint de consulta de stock. El agente de WhatsApp del almacén puede responder "¿cuántos rodamientos SKF 6205-2Z hay en stock?" consultando directamente el ERP — sin que el almacenista tenga que buscar en otro sistema.

Escenario 3: Diferentes herramientas para diferentes agentes La misma herramienta "consultar_activo" está asignada a 3 agentes diferentes: el agente de técnicos de planta (con instrucción: "úsala cuando pregunten por especificaciones técnicas"), el agente de supervisores (con instrucción: "úsala para consultas de estado y alertas activas"), y el agente de gerencia (con instrucción: "úsala para consultas de disponibilidad y KPIs"). La misma capacidad, comportamiento diferente según el contexto.