Rela AIRela AI Docs
Primeros Pasos

Conceptos clave

Terminología y conceptos fundamentales de la plataforma Rela AI: agente, herramienta, colección, activo, alarma, tarea, plan, pipeline predictivo y maturity levels.

Conceptos clave

Esta página es el glosario operativo de Rela AI — los términos que van a aparecer en el dashboard, en las conversaciones con el agente y en los reportes. Dominar estos 10 conceptos te permite leer cualquier otra página de la doc sin perderte.

¿Para qué sirve?

  • Alinear vocabulario entre operación, mantenimiento e IT antes de la implementación.
  • Evitar confusiones entre términos parecidos (activo vs equipo vs máquina; alarma vs evento vs alerta).
  • Establecer el modelo mental que el resto de la documentación asume.

¿Cómo funciona?

La plataforma conecta todos estos conceptos en un único flujo: un activo con sensores emite eventos; los eventos pueden disparar alarmas; una alarma crea una tarea; la tarea la ejecuta un técnico guiado por un agente IA que usa herramientas. La información fluye entre colecciones y los planes regulan la cadencia. Entender esta cadena es entender Rela AI.

Agente

Un agente es una IA conversacional configurada para interactuar con usuarios a través de un canal específico. Rela AI soporta dos tipos de agentes:

CanalMotor de IAIntegración
WhatsAppMotor de IAEvolution API (WhatsApp Business)
EmailMotor de IAPostmark (envío de correos)

Cada agente tiene:

  • Nombre — Identificador único.
  • Prompt del sistema — Instrucciones organizadas en secciones editables que definen la personalidad y comportamiento.
  • Herramientas — Capacidades que el agente usa durante la conversación (buscar datos, generar reportes, llamar APIs).
  • Configuración — Parámetros específicos del canal (modelo de IA, idioma, timeouts).

Herramienta (Tool)

Una herramienta le da capacidades a tu agente más allá de solo conversar. Hay tres tipos:

  • Consulta de datos — Busca información en tus colecciones usando búsqueda semántica (por significado) o exacta (por código/serial). Configuras la colección, los campos de búsqueda y los resultados máximos.
  • Acción interna — Ejecuta funciones predefinidas del sistema: generate_report (PDF), assign_task (tareas), send_whatsapp_message, send_email, locate_nearest_personnel, send_file. Cada acción acepta parámetros con valores por defecto opcionales.
  • Conexión externa — Conecta con sistemas fuera de la plataforma usando HTTP (APIs REST), MQTT (protocolo ligero de mensajería para dispositivos IoT) u OPC UA (protocolo estándar para comunicación con maquinaria industrial) como PLCs Siemens, Beckhoff, Allen-Bradley.

El agente decide automáticamente cuándo usar cada herramienta basándose en la conversación y la descripción de la herramienta.

Colección

Una colección es un conjunto de datos estructurados con campos tipados (string, float, int, boolean, date, list, file). Se crean de dos formas:

  • Por extracción — La IA extrae datos de documentos (PDF, imágenes) automáticamente según una plantilla de campos.
  • Manual — Defines los campos y agregas registros directamente.

Cada registro genera automáticamente un embedding (una representación numérica que permite búsquedas inteligentes) que habilita la búsqueda semántica. Por ejemplo, buscar "laptop para diseño" encuentra registros como "MacBook Pro para diseño gráfico" aunque las palabras no coincidan exactamente.

Las colecciones también soportan búsqueda exacta para campos como códigos, seriales o DNI, donde necesitas coincidencia precisa.

Prompt del sistema

El prompt del sistema define cómo se comporta tu agente. Está organizado en secciones independientes que puedes editar, reordenar y optimizar individualmente:

SecciónPropósito
IdentidadQuién es el agente — nombre, rol, personalidad, tono
InstruccionesQué debe hacer — flujo de conversación, pasos, información a recopilar
ReglasLímites y restricciones — qué NO debe hacer, políticas de escalamiento
HerramientasCómo usar las herramientas — cuándo invocarlas, qué parámetros pedir, cómo presentar resultados

Cada sección tiene un botón Mejorar con IA que optimiza el contenido para el canal específico (WhatsApp: texto con formato, email: texto profesional). Además, puedes agregar secciones personalizadas adicionales para FAQs, horarios, procedimientos especiales, etc.

Extracción

Proceso donde la IA analiza documentos y extrae datos estructurados. Usa visión artificial para PDFs escaneados e imágenes, y procesamiento de texto para documentos con texto seleccionable. Soporta:

  • Extracción individual — Un registro por documento.
  • Extracción por lotes — Múltiples registros de un solo documento (tablas, catálogos, inventarios).
  • Auditoría — Genera imágenes anotadas mostrando dónde se encontró cada dato en el documento original.

Tenant

Rela AI es multi-tenant. Cada organización (tenant) tiene aislamiento completo de datos: sus propios agentes, colecciones, herramientas, departamentos, personal, historial de conversaciones y reportes. Ningún tenant puede acceder a los datos de otro.

Activos (Equipos)

Un activo es cualquier equipo físico que tu organización necesita mantener: bombas, compresores, motores, transportadores, etc. Cada activo tiene un perfil con su información técnica, ubicación, historial de eventos y estado de salud. Los activos se organizan en una jerarquía: planta → área → línea → equipo.

Alarmas y Eventos

Cuándo un sensor detecta algo inusual (temperatura alta, vibración excesiva, presión fuera de rango), genera un evento. Los eventos se clasifican por severidad: informativo, advertencia, crítico o emergencia. Un agente de IA puede analizar el evento, diagnosticar la causa probable y tomar acciones automáticas como crear una orden de trabajo o notificar al técnico de guardia.

Tareas y Órdenes de Trabajo

Las tareas son las acciones que tu equipo debe realizar: reparaciones, inspecciones, mantenimiento preventivo, etc. Se organizan en un tablero Kanban con estados (pendiente, en progreso, completada) y se asignan a personal específico. Las tareas pueden crearse manualmente o generarse automáticamente desde alarmas, planes de mantenimiento o conversaciones con agentes de IA.

Planes de Mantenimiento

Los planes de mantenimiento preventivo programan tareas recurrentes para tus equipos: cada 30 días, cada 500 horas de operación, etc. El sistema crea automáticamente la tarea cuando toca, la asigna al técnico responsable y envía la notificación por email o WhatsApp.

Beneficios clave

  • Vocabulario canónico compartido entre operación, mantenimiento, IT y comercial.
  • Menos malentendidos en reuniones ("¿alarma? ¿evento? ¿alerta?") — cada término tiene una definición estable.
  • Base para leer cualquier otra página de la doc: todos los términos se refieren a estas definiciones.
  • Alineado con el glosario técnico (glossary) para términos avanzados (AHI, RUL, Page-Hinkley, config_version).

En esta página