El sistema valida el flujo en segundo plano de forma continua y bloquea la publicación cuando encuentra errores que romperían la ejecución.
⚙️ Cómo funciona la validación continua
La validación se ejecuta automáticamente en segundo plano, sin necesidad de activación manual. ¡No hay un botón de "Validar"! El resultado se actualiza en tiempo real y se refleja en un botón flotante ubicado en la esquina inferior derecha del canvas.
Estado del botón | Significado |
Azul | El flujo es válido. Al hacer clic, se compila y abre el simulador. |
Rojo con badge | Hay errores críticos. El badge (indicador numérico) muestra cuántos. Al hacer clic se despliega la lista detallada. |
Cargando | El sistema está compilando el flujo en ese instante. |
🚫 Errores que bloquean la compilación
Estas tres reglas estructurales impiden compilar el flujo. Si no se cumplen, no podrás simularlo ni publicarlo.
Regla | Qué valida | Mensaje de error mostrado |
V-01 | Todo Nodo Cortex debe tener un prompt (Instrucciones). | "El nodo '{etiqueta}' no tiene un objetivo de conversación" |
V-02 | Toda rama conectora debe tener una expresión de condición. | "La condición '{etiqueta}' no tiene expresión de condición" |
V-03 | Todo nodo "hoja" (el final del camino) debe ser un Nodo Fin. | "El nodo '{etiqueta}' debe conectarse a un nodo End" |
🚀 Validaciones exclusivas al presionar "Publicar"
Además de las reglas de compilación, al intentar publicar tu agente, el sistema realiza verificaciones adicionales de seguridad:
1. Nombre del flujo
El flujo no se puede publicar con el nombre por defecto ni con un nombre de menos de 3 caracteres. El sistema te pedirá: "Antes de publicar, dale un nombre a tu agente que lo identifique claramente", y moverá el foco al campo correspondiente para que lo edites.
💡 Tip operativo: El motivo no es estético. Un flujo llamado "Nuevo agente" es imposible de identificar después en el listado general, en los reportes de métricas y en la trazabilidad.
2. WhatsApp Flows sin configurar correctamente
La publicación se bloquea si activaste el formato de WhatsApp Flow pero no agregaste ningún formulario a la lista, o si agregaste un Flow pero dejaste su "descripción de uso" vacía.
3. Referencias rotas en integraciones
El sistema te alertará y bloqueará la publicación si un MCP Server hace referencia a una variable de entorno o conexión de autenticación que no existe. Lo mismo ocurre si un Code Tool intenta usar un campo de guardado eliminado. (Esto suele pasar frecuentemente al importar un flujo desde otro workspace).
🔗 Validación del lado de Flowbuilder
Un flujo Cortex puede estar impecable estructuralmente, pero aun así fallar en producción si el nodo que lo invoca desde Flowbuilder está mal configurado.
Al intentar publicar un flow completo en Flowbuilder, el sistema valida rigurosamente que todos los Nodos Cortex tengan un agente seleccionado, que ese agente exista y que esté publicado. Si falta alguno, la publicación se bloquea con el siguiente detalle:
"Los siguientes nodos no tienen agente seleccionado: {Nodo A}, {Nodo B}. Selecciona un agente en cada uno antes de publicar."
Cada ítem de la lista tendrá un botón de "Ir al nodo" para ubicarlo rápido en el canvas.
(Nota: Esta misma validación ocurre al "Guardar", pero solo como un aviso no bloqueante, permitiéndote seguir trabajando).
💡 Importancia: Sin esta validación cruzada, el error solo aparecería cuando un cliente real intenta interactuar, provocando la temida "falla silenciosa".
⚠️ Avisos que NO bloquean (pero debes atender)
Estos avisos te permiten seguir trabajando y publicando, pero ignorarlos es la causa más frecuente de comportamientos erráticos en tu Inteligencia Artificial.
Aviso en pantalla | Por qué importa corregirlo |
Condiciones de rama con >80% de similitud | El LLM se confundirá y transferirá al nodo equivocado de forma inconsistente. |
Ramas de finalización muy similares | La conversación se cerrará y derivará por la salida operativa equivocada. |
Descripciones de uso de WA Flows similares | El nodo enviará un formulario que no corresponde a la situación del cliente. |
Condición que referencia un campo inexistente | Esa condición jamás se cumplirá, dejando una parte de tu flujo inaccesible. |
¡Lanza a producción con total tranquilidad! 🚀
Las validaciones de Cortex actúan como tu red de seguridad personal, asegurándose de que tu flujo esté estructuralmente sano, no rompa las reglas de los canales y esté perfectamente conectado con Flowbuilder antes de que el primer cliente diga "Hola". ✅