Solucion de Problemas

Esta guia cubre los problemas mas frecuentes al usar Rela AI y como resolverlos.

Problemas de Conexion WhatsApp

El codigo QR no aparece

Causa: El servidor de WhatsApp no puede generar la sesion, generalmente por un problema de red o porque ya existe una sesion activa.

Solucion:

Verifica que tu conexion a internet sea estable.
Si ya tenias una sesion activa, desconectala primero desde el panel de control.
Recarga la pagina y vuelve a solicitar el codigo QR.
Si el problema persiste, espera 2-3 minutos antes de reintentar. WhatsApp impone limites de frecuencia.

El agente se desconecta frecuentemente

Causa: WhatsApp cierra sesiones inactivas o cuando detecta multiples conexiones desde el mismo numero.

Solucion:

Asegurate de no tener WhatsApp Web abierto en otro navegador o dispositivo al mismo tiempo.
Verifica que tu telefono tenga conexion a internet estable.
Reconecta el agente desde el dashboard y escanea el QR nuevamente.

Los mensajes no llegan al agente

Causa: La sesion de WhatsApp esta desconectada o el webhook no esta configurado correctamente.

Solucion:

Revisa el estado de conexion del agente en el dashboard. Debe mostrar "Conectado".
Si aparece desconectado, reconecta escaneando el codigo QR.
Verifica que el numero de destino no este bloqueado.
Revisa los logs del agente para confirmar que los mensajes estan siendo recibidos.

Problemas de Email

La cuenta de email no se verifica

Causa: Los registros DNS (SPF, DKIM, MX) no estan configurados correctamente en tu dominio.

Solucion:

Ve a la configuracion del agente de email y copia los registros DNS requeridos.
Accede al panel de administracion de tu dominio (GoDaddy, Cloudflare, etc.).
Agrega los registros TXT para SPF y DKIM exactamente como se muestran.
Agrega el registro MX apuntando al servidor de Rela AI.
Espera hasta 48 horas para la propagacion DNS. Puedes verificar el estado con herramientas como MXToolbox.

Los registros DNS estan configurados pero la verificacion falla

Causa: Propagacion DNS incompleta o registros con formato incorrecto.

Solucion:

Verifica que no haya espacios extra ni caracteres invisibles en los registros.
Confirma que el TTL no sea excesivamente alto (recomendado: 3600 o menos).
Usa dig TXT tudominio.com o MXToolbox para confirmar que los registros son visibles.
Si usas Cloudflare, asegurate de que el proxy este desactivado para los registros de email.

Los emails enviados por el agente no llegan al destinatario

Causa: Los emails pueden estar siendo marcados como spam o los registros DNS no estan completos.

Solucion:

Pide al destinatario que revise su carpeta de spam/correo no deseado.
Verifica que SPF y DKIM esten correctamente configurados.
Revisa los logs del agente para confirmar que el email fue enviado exitosamente.
Si el dominio es nuevo, puede requerir tiempo para ganar reputacion. Envia emails de prueba primero.

Problemas de Eventos y Alarmas (Machine Agents)

Los eventos no se procesan

Causa: La conexion al broker MQTT o al servidor OPC UA esta interrumpida, o el formato del evento no es valido.

Solucion:

Verifica el estado de conexion del machine agent en el dashboard.
Confirma que las credenciales del broker MQTT (host, puerto, usuario, password) sean correctas.
Revisa que el topico MQTT al que esta suscrito el agente sea el correcto.
Verifica que el payload del evento sea un JSON valido.

La conexion MQTT falla

Causa: Puerto bloqueado por firewall, credenciales incorrectas o broker no disponible.

Solucion:

Verifica que el puerto 1883 (o 8883 para TLS) este abierto en tu firewall.
Prueba la conexion manualmente con un cliente MQTT como MQTTX o mosquitto_sub.
Confirma que el broker este en ejecucion y acepte conexiones externas.
Si usas TLS, verifica que los certificados sean validos y no esten expirados.

La conexion OPC UA falla

Causa: URL del endpoint incorrecta, certificados no confiables o politica de seguridad incompatible.

Solucion:

Verifica que la URL del endpoint OPC UA sea accesible desde el servidor de Rela AI.
Confirma que la politica de seguridad configurada coincida con la del servidor OPC UA.
Si el servidor requiere certificados, asegurate de que esten correctamente instalados.
Revisa los logs para mensajes de error especificos del protocolo OPC UA.

Problemas de Herramientas (Tools)

La herramienta no se ejecuta

Causa: El esquema de la herramienta esta mal definido, el endpoint no responde, o el agente no tiene la herramienta asignada.

Solucion:

Verifica que la herramienta este asignada al agente en la seccion de configuracion.
Confirma que la URL del endpoint sea accesible y responda correctamente.
Prueba el endpoint manualmente con una herramienta como Postman o curl.
Revisa que el esquema JSON de parametros sea valido.

Los parametros se envian incorrectamente

Causa: El esquema de parametros no coincide con lo que espera el endpoint, o la descripcion de la herramienta es ambigua para el modelo de IA.

Solucion:

Revisa la definicion del esquema de la herramienta. Cada parametro debe tener tipo, descripcion y si es requerido.
Mejora las descripciones de los parametros para que el modelo de IA pueda inferir los valores correctos.
Usa el campo description de la herramienta para explicar claramente cuando y como debe usarse.
Verifica los logs para ver que parametros esta enviando el agente al endpoint.

Problemas de Extraccion de Datos

El documento no se procesa

Causa: Formato de archivo no soportado, archivo corrupto o tamano excesivo.

Solucion:

Verifica que el archivo sea PDF, imagen (PNG, JPG) o un formato soportado.
Confirma que el tamano del archivo no exceda el limite (generalmente 10 MB).
Si es un PDF escaneado, asegurate de que la calidad de la imagen sea legible.
Intenta con una version diferente del documento o conviertelo a PDF.

Los campos no se detectan correctamente

Causa: La estructura del documento no coincide con la plantilla de extraccion o la calidad del documento es baja.

Solucion:

Revisa la estructura de extraccion (report_structure) y confirma que los key_value coincidan con las etiquetas del documento.
Si el documento tiene un formato no estandar, ajusta las descripciones de los campos en la plantilla.
Mejora la calidad del documento: mayor resolucion, sin marcas de agua, texto legible.
Prueba con documentos de ejemplo para validar la plantilla antes de usarla en produccion.

Problemas Generales

La sesion expira constantemente

Causa: El token de autenticacion tiene un tiempo de vida limitado o hay problemas con las cookies del navegador.

Solucion:

Cierra sesion y vuelve a iniciar sesion.
Limpia las cookies y cache del navegador para el dominio de Rela AI.
Verifica que tu reloj del sistema este sincronizado correctamente.
Si usas una VPN, intenta sin ella para descartar problemas de red.

Error de permisos ("No autorizado" o "Forbidden")

Causa: Tu rol en la organizacion no tiene los permisos necesarios para la accion solicitada.

Solucion:

Verifica tu rol actual en la seccion de Organizacion del dashboard.
Contacta al administrador de tu organizacion para solicitar los permisos necesarios.
Los roles disponibles son: Admin, Manager y Viewer. Solo Admin y Manager pueden modificar agentes.

Limites de la API (Rate Limiting)

Causa: Se ha excedido el numero maximo de solicitudes permitidas en un periodo de tiempo.

Solucion:

Espera unos minutos antes de reintentar. Los limites se resetean automaticamente.
Si usas la API directamente, implementa logica de reintentos con backoff exponencial.
Revisa los headers de respuesta X-RateLimit-Remaining y X-RateLimit-Reset para gestionar tus solicitudes.
Si necesitas limites mas altos, contacta al equipo de soporte.

Problemas de Mantenimiento

Plan ejecutado pero no se creo tarea

Causa: El plan de mantenimiento no tiene un departamento asignado, por lo que el sistema no puede determinar a quien asignar la tarea.

Solucion:

Ve al plan de mantenimiento en cuestion.
Verifica que el campo department_id este asignado correctamente.
Guarda el plan y espera a la proxima ejecucion programada.

Notificacion no enviada

Causa: La persona asignada no tiene un email o telefono configurado en su perfil.

Solucion:

Ve al perfil del usuario en la seccion de Organizacion.
Verifica que tenga un email o numero de telefono registrado.
Guarda los cambios y reintenta la accion que genera la notificacion.

Plan no ejecuta automaticamente

Causa: El plan esta deshabilitado o pausado.

Solucion:

Abre el plan de mantenimiento.
Verifica que el toggle de Habilitado este activo.
Confirma que el plan no este en estado Pausado.
Revisa que la programacion (cron o fecha) sea correcta y no haya pasado.

Counter no dispara

Causa: El valor de counter_threshold es 0 o no esta configurado.

Solucion:

Abre el plan de mantenimiento basado en contador.
Verifica que counter_threshold sea mayor a 0.
Confirma que el contador del activo se esta incrementando correctamente.

Problemas de LOTO (Lockout/Tagout)

"No tiene procedimiento aprobado"

Causa: Se intenta iniciar una ejecucion LOTO pero no existe un procedimiento aprobado para el activo.

Solucion:

Ve a la seccion de LOTO y crea un procedimiento para el activo.
Completa todos los pasos requeridos del procedimiento.
Envia el procedimiento para aprobacion y espera a que sea aprobado.
Una vez aprobado, podras iniciar la ejecucion LOTO.

Activo sigue bloqueado

Causa: La ejecucion LOTO no fue finalizada correctamente.

Solucion:

Ve a /loto/executions/{id} donde {id} es el ID de la ejecucion activa.
Haz clic en Desbloquear para liberar el activo.
Verifica que todos los pasos de desbloqueo se hayan completado.

No puedo abortar ejecucion

Causa: La peticion de abortar requiere un cuerpo (body) con el motivo de la cancelacion.

Solucion:

Al hacer la peticion de abortar, incluye un body con el campo reason.
Ejemplo: {"reason": "Emergencia resuelta, ya no es necesario"}.
El motivo es obligatorio por razones de auditoria.

Problemas de Inspecciones

Checkpoints no se guardan

Causa: Los checkpoints se pierden si no se guarda el progreso antes de completar o salir.

Solucion:

Haz clic en Guardar periodicamente mientras completas los checkpoints.
No cierres la pagina sin guardar primero.
Si perdiste datos, deberas volver a completar los checkpoints afectados.

No puedo completar la inspeccion

Causa: Todos los checkpoints deben tener una marca de pass o fail antes de poder completar la inspeccion.

Solucion:

Revisa todos los checkpoints de la inspeccion.
Marca cada uno como Pass o Fail.
Una vez que todos esten marcados, el boton de Completar se habilitara.

Template sin checkpoints

Causa: La plantilla de inspeccion fue creada sin agregar checkpoints.

Solucion:

Edita la plantilla de inspeccion.
Agrega los checkpoints necesarios en la seccion correspondiente.
Guarda la plantilla antes de usarla para crear inspecciones.

Problemas de Anomalias ML

"Insufficient data" al entrenar

Causa: El modelo de deteccion de anomalias necesita un minimo de datos historicos para entrenarse.

Solucion:

Asegurate de que el activo tenga al menos 10 lecturas historicas registradas (idealmente 100 o mas).
Espera a que se acumulen suficientes datos antes de intentar el entrenamiento.
Verifica que las lecturas esten llegando correctamente al sistema.

Modelo no detecta nada

Causa: La sensibilidad del modelo esta configurada demasiado baja para los datos actuales.

Solucion:

Ve a la configuracion del modelo de anomalias.
Cambia la sensibilidad a high para detectar desviaciones mas pequenas.
Re-entrena el modelo si es necesario.
Verifica que los datos de entrada tengan suficiente variabilidad.

Muchos falsos positivos

Causa: La sensibilidad del modelo esta demasiado alta, detectando variaciones normales como anomalias.

Solucion:

Reduce la sensibilidad a low en la configuracion del modelo.
Re-entrena el modelo con un conjunto de datos mas representativo.
Revisa y descarta las anomalias falsas para mejorar el aprendizaje del modelo.

Problemas de SPC (Control Estadistico de Procesos)

"Invalid chart_type"

Causa: El tipo de carta SPC debe usar el formato con underscores, no guiones ni espacios.

Solucion:

Usa los valores validos: x_bar_r, x_bar_s, i_mr.
No uses formatos como x-bar-r, xBarR o X Bar R.
Verifica el valor exacto en la documentacion de la API.

Sin limites de control

Causa: El sistema necesita un minimo de datos para calcular los limites de control (UCL, LCL).

Solucion:

Registra al menos 10 subgrupos de datos antes de esperar limites calculados.
Idealmente, usa 25 o mas subgrupos para limites mas estables.
Los limites se calculan automaticamente una vez que hay suficientes datos.

Capability (Cp/Cpk) muestra "—"

Causa: Los limites de especificacion (USL y LSL) no estan definidos en la carta SPC.

Solucion:

Edita la carta SPC.
Define el USL (Upper Specification Limit) y el LSL (Lower Specification Limit).
Guarda los cambios. Los indices Cp y Cpk se calcularan automaticamente.

Necesitas mas ayuda?

Si el problema no esta cubierto en esta guia:

Revisa los logs del agente en el dashboard para obtener detalles del error.
Contacta al equipo de soporte a traves del chat en la plataforma.
Envia un email a soporte@rela-ai.com con una descripcion del problema, capturas de pantalla y los logs relevantes.

Solucion de Problemas

En esta página