⚙️ Diagnóstico: Verifica la salud de tu Bot Agente antes de publicar
Cómo usar el diagnóstico de Studio para detectar problemas en la configuración de tu bot antes de publicarlo.
🔍 ¿Qué es el Diagnóstico?
El Diagnóstico es una herramienta dentro de Adereso Studio que revisa automáticamente la configuración draft (borrador) de tu Bot Agente. Analiza componentes, herramientas, reglas de comportamiento y configuración general para detectar errores, inconsistencias o posibles mejoras.
Cada vez que ejecutas el diagnóstico, el sistema evalúa tu configuración y genera un reporte con hallazgos clasificados por severidad. También calcula un indicador de salud del bot que te permite saber de un vistazo si tu agente está listo para publicarse.
🚪 Cómo acceder al Diagnóstico
- Ingresa a Adereso Studio.
- Selecciona el Bot Agente que deseas diagnosticar.
- En el menú lateral izquierdo, haz clic en Diagnóstico (ícono de escáner).
▶️ Ejecutar el Diagnóstico
Al ingresar a la sección, verás un mensaje indicando que no se ha ejecutado ningún análisis. Haz clic en el botón Ejecutar diagnóstico para iniciar el análisis de tu configuración actual.
El análisis se ejecuta sobre la versión draft de tu bot — es decir, la configuración que estás editando actualmente, no la versión publicada en producción.
📊 Entender los resultados
🩺 Salud del bot
El indicador de salud resume el estado general de tu configuración en una de cuatro categorías:
- Excelente — No se encontraron advertencias. El bot está listo para producción.
- Saludable — No hay advertencias altas ni medias, pero sí de severidad baja. Se recomienda revisar y corregir cuando sea posible.
- Moderada — Se detectaron advertencias de severidad media. Se recomienda publicar bajo monitoreo constante.
- Crítica — Se detectaron advertencias de severidad alta. Se recomienda resolver todas las advertencias de criticidad alta antes de publicar.
⚠️ Severidad de los hallazgos
Cada hallazgo tiene un nivel de severidad que indica su impacto potencial:
- Alta (triángulo rojo) — Problemas críticos que requieren atención inmediata. Pueden causar fallos en el comportamiento del bot.
- Media (círculo amarillo) — Problemas importantes que pueden impactar el rendimiento o la experiencia del usuario.
- Baja (círculo azul) — Observaciones menores con impacto reducido. Buenas prácticas que se recomiendan corregir.
🔎 Detalle de cada hallazgo
Haz clic en cualquier hallazgo para expandirlo y ver la información completa:
- Descripción — Explica en detalle qué problema se detectó.
- Sugerencia — Indica cómo corregir el problema.
- Elementos afectados — Muestra qué componentes o herramientas específicas del bot están involucradas.
🔔 Indicador de salud en el menú lateral
Después de ejecutar el diagnóstico, un indicador compacto aparece al pie del menú lateral de Studio. Este muestra de un vistazo el estado de salud del bot y la cantidad de hallazgos por severidad.
Haz clic en el indicador para expandir la lista de hallazgos sin necesidad de entrar a la sección de Diagnóstico. Desde ahí puedes hacer clic en cualquier hallazgo para ver su detalle en un popup y navegar a los elementos afectados.
🗺️ Flujo recomendado
- Configura tu Bot Agente (componentes, herramientas, comportamiento).
- Antes de publicar, ve a Diagnóstico y ejecuta el análisis.
- Revisa los hallazgos, priorizando los de severidad alta.
- Haz clic en los elementos afectados para ir directamente al componente o herramienta a corregir.
- Corrige y vuelve a ejecutar el diagnóstico hasta alcanzar una salud Excelente o Saludable.
- Publica tu versión con confianza.
🔧 Solución de problemas
❓ "No se pudo cargar la configuración del bot"
Esto puede ocurrir si:
- La conexión a internet es inestable.
- El bot fue eliminado o no existe.
Intenta recargar la página. Si el problema persiste, contacta a soporte.
❓ "No se pudo ejecutar el diagnóstico"
El servicio de análisis puede estar temporalmente no disponible. Espera unos minutos y vuelve a intentar.
❓ Los hallazgos no cambian después de corregir
Recuerda que debes volver a ejecutar el diagnóstico después de hacer cambios. El análisis no se actualiza automáticamente al editar componentes.
📚 Artículos relacionados
- Guía paso a paso: Crea tu primer Bot Agente — Si aún no tienes un bot creado, empieza por aquí.
- Componentes de comportamiento: Personaliza tu bot — Aprende sobre los componentes que el diagnóstico evalúa.
- Herramientas: Las acciones que ejecuta tu bot — Entiende las herramientas que aparecen como elementos afectados.
- Conversaciones: Monitoreo en tiempo real de tus bots — Complementa el diagnóstico previo a publicar con el monitoreo posterior.
🔍 Niveles de severidad explicados
🔴 Alta Problemas críticos. Pueden causar fallos en producción. Resolver ANTES de publicar.
🟡 Media Problemas importantes. Impactan la experiencia. Resolver antes o publicar con monitoreo.
🔵 Baja Buenas prácticas. Impacto reducido. Corregir cuando sea posible.
✅ Excelente Sin advertencias. El bot está listo para producción.
❓ ¿Cuándo puedo publicar con advertencias?
❓ ¿El diagnóstico se actualiza automáticamente?
No. Debes ejecutarlo manualmente cada vez que modifiques la configuración del bot. Haz clic en 'Ejecutar diagnóstico' para obtener resultados frescos.