Herramienta de Acción
Las herramientas de acción permiten al agente ejecutar tareas dentro del sistema: crear órdenes de trabajo, enviar notificaciones por WhatsApp o email, generar reportes PDF, y localizar al técnico más cercano.
Herramienta de Acción
Un agente de IA que solo puede responder preguntas es útil. Pero un agente que también puede crear una orden de trabajo, enviar un WhatsApp al técnico asignado, y generar el reporte PDF del turno — todo desde la misma conversación — es transformador. Las herramientas de acción son las que hacen posible que el agente no solo responda, sino que actúe.
¿Para qué sirve?
Las herramientas de acción conectan al agente con las funciones operativas del sistema. El técnico reporta una falla por WhatsApp, el agente la registra como tarea, la asigna al departamento correcto, notifica al técnico de guardia, y confirma al usuario que todo está en proceso — sin que ningún humano haya tocado el teclado del dashboard.
Las herramientas de acción permiten al agente:
- Crear y asignar tareas de mantenimiento automáticamente
- Enviar mensajes de WhatsApp a técnicos o supervisores
- Enviar emails con o sin archivos adjuntos
- Generar reportes PDF con branding corporativo
- Localizar al técnico más cercano a una ubicación específica
¿Cómo funciona?
Cada herramienta de acción está vinculada a una función del sistema. Cuándo el agente decide que necesita ejecutar una acción — porque el usuario lo pidió, o porque la situación lo requiere según su prompt — llama a la herramienta con los parámetros necesarios. La función se ejecuta en el backend y el agente recibe la confirmación para incluirla en su respuesta.
El agente combina parámetros de dos fuentes:
- Lo que el usuario dijo en la conversación (nombre del equipo, descripción del problema, prioridad)
- Los valores predeterminados configurados en la herramienta (departamento, cuenta de email, branding del reporte)
Esto permite que el agente actúe con contexto completo sin tener que preguntar al usuario información que ya está configurada.
Acciones disponibles
Las acciones están agrupadas por categoría. Todas las que aparecen aquí son seleccionables al crear una herramienta de acción, salvo las marcadas como automáticas (se inyectan en todos los agentes del canal sin configuración adicional).
Gestión de tareas
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
assign_task | Crea una orden de trabajo en el Kanban y notifica al responsable | Cuándo el usuario reporta una falla o solicita mantenimiento |
update_task | Actualiza el estado, prioridad o campos de una tarea existente | Para cerrar tareas, cambiar estado o reasignar |
get_task | Consulta los detalles de una tarea por ID o código | Para que el usuario consulte el estado de su solicitud |
locate_nearest_personnel | Encuentra al técnico más cercano a una ubicación geográfica | Para asignación por proximidad en emergencias |
Mensajería WhatsApp
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
send_whatsapp_message | Envía un mensaje a un número de WhatsApp configurado | Para notificaciones a técnicos o supervisores desde cualquier canal |
send_file | Envía un PDF, imagen u otro archivo vía WhatsApp | Para compartir reportes o planos directamente al celular |
send_message_to (automática en agentes WhatsApp) | Envía un mensaje a un número diferente al remitente | Para reenviar información o notificar a un tercero |
send_contact (automática en agentes WhatsApp) | Envía una tarjeta de contacto al usuario actual | Para compartir los datos de contacto del técnico asignado |
send_location (automática en agentes WhatsApp) | Envía una ubicación geográfica al usuario actual | Para indicar dirección de taller, cliente o activo |
Mensajería Email
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
send_email | Envía un email vía una cuenta Postmark registrada | Para comunicaciones formales o envío de reportes por correo |
attach_file (automática en agentes Email) | Adjunta un archivo al email de respuesta en curso | Para incluir un reporte generado en la misma respuesta |
send_email_to (automática en agentes Email) | Envía un email a un destinatario diferente al remitente | Para reenviar o notificar a un tercero en nombre del usuario |
Reportes
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
generate_report | Genera un PDF estructurado con el branding de la empresa | Para reportes de turno, resúmenes de inspección, informes ejecutivos |
Búsqueda web
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
web_search | Busca en internet usando Brave Search (web o noticias) | Para consultas de contexto externo que el agente no tiene en su base de datos |
Autenticación
| Acción | Qué hace | Cuándo usarla |
|---|---|---|
authenticate_conversation | Autentica al usuario contra un registro de la base de datos | Para verificar identidad antes de dar acceso a información sensible |
send_verification_otp | Envía un código OTP por WhatsApp o email | Para verificación en dos pasos después de la autenticación inicial |
verify_otp | Valida el código OTP ingresado por el usuario | Para completar el flujo de autenticación con OTP |
Consultas de mantenimiento
| Acción | Qué hace |
|---|---|
query_maintenance_plans | Planes de mantenimiento preventivo programados |
query_overdue_maintenance | Mantenimientos vencidos o próximos a vencer |
query_compliance | Cumplimiento de planes de mantenimiento |
Consultas de activos e indicadores
| Acción | Qué hace |
|---|---|
query_asset_health | Estado de salud de activos industriales |
query_asset_prognostics | Pronóstico de vida útil restante de activos |
get_asset_kpis | KPIs de rendimiento de un activo específico |
query_underperforming_assets | Activos con rendimiento por debajo del umbral |
query_benchmark_groups | Grupos de comparación para benchmarking |
get_asset_ranking | Ranking de activos por rendimiento |
Consultas de energía
| Acción | Qué hace |
|---|---|
query_energy_consumption | Consumo energético por período y activo |
get_energy_anomalies | Anomalías detectadas en el consumo de energía |
Consultas de calidad (SPC)
| Acción | Qué hace |
|---|---|
query_spc_charts | Gráficas de control estadístico del proceso |
get_spc_chart_status | Estado actual de una carta de control específica |
Consultas de seguridad industrial
| Acción | Qué hace |
|---|---|
query_inspections | Inspecciones de seguridad registradas |
get_inspection_details | Detalles completos de una inspección específica |
query_loto_procedures | Procedimientos de bloqueo/etiquetado (LOTO) activos |
check_loto_status | Estado de bloqueo de un equipo específico |
Consultas de inventario
| Acción | Qué hace |
|---|---|
query_inventory | Stock de materiales y repuestos |
check_stock_level | Nivel de stock de un ítem específico |
Consultas de SLA
| Acción | Qué hace |
|---|---|
get_sla_metrics | Métricas agregadas de SLA: tiempos, cumplimiento, brechas |
get_sla_breaches | Tareas con incumplimiento de SLA activo |
Consultas de anomalías
| Acción | Qué hace |
|---|---|
query_anomalies | Anomalías detectadas en activos industriales |
get_anomaly_summary | Resumen estadístico de anomalías por período |
Para ver los parámetros detallados de cada acción, consulta la referencia completa de acciones integradas.
¿Cómo usarlo?
Crear una herramienta de acción
- Ve a Herramientas en la barra lateral.
- Haz clic en Nueva Herramienta.
- Selecciona el tipo Acción interna.
- Elige la acción de la lista.
- Configura los valores predeterminados (ver sección siguiente).
- Haz clic en Guardar y asigna la herramienta al agente.
Configurar la acción "Crear y asignar tarea"
Esta es la acción más usada en agentes de mantenimiento industrial:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Departamento | A qué departamento va la tarea por defecto | Mantenimiento Mecánico |
| Prioridad por defecto | La prioridad inicial si el usuario no la especifica | Media |
| Notificar por email | Enviar email al asignado cuando se crea la tarea | Activado |
| Notificar por WhatsApp | Enviar WhatsApp al asignado cuando se crea la tarea | Activado |
El agente recoge del usuario el título, la descripción, y la urgencia. Con los valores predeterminados y lo que obtuvo del usuario, crea la tarea completa. El técnico asignado recibe la notificación automáticamente.
Configurar la acción "Generar reporte PDF"
El reporte sale con el branding corporativo configurado en los valores predeterminados:
| Campo | Descripción |
|---|---|
| Nombre de la empresa | Aparece en el encabezado del reporte |
| Logo | URL del logo corporativo |
| Líneas de encabezado | Información adicional del encabezado (planta, área, contacto) |
| Texto de pie de página | Nota legal o de confidencialidad |
El agente construye el contenido del reporte con los datos que recopiló durante la conversación — lecturas del técnico, observaciones, hallazgos — y los combina con el branding predeterminado para generar el PDF.
Configurar la acción "Localizar personal más cercano"
Esta acción busca al técnico más cercano a una ubicación geográfica en orden de proximidad: primero en la misma ciudad, luego en el mismo estado, luego en el mismo país. Puedes filtrar por departamento para que solo busque técnicos del área correcta.
Útil para empresas de servicios con técnicos distribuidos en múltiples ciudades que necesitan asignar el trabajo al técnico más cercano al cliente.
Beneficios clave
- El agente actúa sin depender de que un humano abra el dashboard
- Los valores predeterminados eliminan preguntas innecesarias al usuario
- Las notificaciones automáticas garantizan que el técnico asignado siempre sea informado
- Los reportes PDF salen con branding corporativo sin configuración adicional por reporte
- Una sola conversación puede encadenar múltiples acciones: crear tarea + enviar WhatsApp + generar reporte
- El agente confirma al usuario qué acciones ejecutó y con qué resultado
Casos de uso comunes
Escenario 1: Reporte de falla automático El operador de turno escribe al agente de WhatsApp: "El compresor C-02 está vibrando fuerte, creo que tiene un problema con los rodamientos." El agente crea una tarea "Inspección de rodamientos — Compresor C-02" con prioridad alta en el departamento de Mantenimiento Mecánico, envía un WhatsApp al técnico de turno con los detalles, y responde al operador: "Tarea #MAN-0924 creada con prioridad alta. El técnico Miguel Torres fue notificado y confirmará en los próximos 15 minutos." Todo en menos de 10 segundos.
Escenario 2: Reporte de turno generado por el agente Al final del turno, el supervisor le dice al agente: "Genera el reporte del turno tarde." El agente consulta las tareas completadas, las alarmas del período, y los equipos que generaron alertas. Genera un PDF con el logo de la empresa, las tablas de actividades del turno, y lo envía al email del gerente de mantenimiento. El supervisor no necesita escribir el reporte manualmente.
Escenario 3: Asignación inteligente para empresa de servicios Una empresa de servicios de mantenimiento recibe una solicitud de cliente en Monterrey. El agente ejecuta "localizar personal más cercano" con ciudad "Monterrey" y departamento "Mantenimiento Industrial". Encuentra que hay 2 técnicos en Monterrey, 1 en Saltillo. Crea la tarea asignada al técnico más cercano, le envía el WhatsApp con los detalles del cliente, y confirma al cliente la asignación con el nombre del técnico y el tiempo estimado de llegada.
Herramienta de Consulta
Las herramientas de consulta permiten al agente buscar información en tus colecciones de datos. El agente puede encontrar fichas técnicas, historial de mantenimiento, inventario de piezas, o cualquier dato almacenado, usando búsqueda inteligente o coincidencia exacta.
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.