Las conexiones entre nodos llevan una condición escrita en lenguaje natural, y el modelo de IA (LLM) decide en tiempo real (runtime) cuál ruta corresponde tomar.
🎯 ¿Para qué sirven?
Las ramas son el elemento que permite que un flujo multi-nodo funcione de manera autónoma, sin necesidad de crear complejos nodos intermedios que tomen decisiones rígidas.
Cada Nodo Cortex conoce las condiciones de las ramas que salen de él y de sus nodos hermanos, y utiliza esa información para transferir la conversación al lugar adecuado. Esto significa que la calidad del enrutamiento depende casi por completo de qué tan bien escritas estén tus condiciones.
📍 ¿Cómo se crean?
El proceso es sumamente orgánico:
Al conectar dos Nodos Cortex en el lienzo, el sistema asigna automáticamente el tipo de "condición evaluada por LLM". No tienes que elegirlo manualmente.
Hacer clic sobre la línea de la rama abre el panel lateral derecho, donde se escribe la expresión de condición.
✍️ La expresión de condición
Es el texto que describe en lenguaje natural exactamente cuándo se debe activar esa transición.
Ejemplos de buenas condiciones:
"El usuario está molesto y pide hablar con una persona"
"El cliente manifiesta interés concreto en probar un vehículo específico y menciona el modelo"
"El cliente pregunta por el estado de un pedido que ya realizó"
🚨 Importante: Una rama sin expresión de condición se marca como un error de validación y bloqueará la compilación del flujo. No puedes dejar este campo vacío.
🧠 Cómo escribir buenas condiciones
Para que la inteligencia artificial no se confunda, tus condiciones deben cumplir con tres criterios clave (en orden de importancia):
Mutuamente excluyentes: Dos condiciones nunca deberían aplicar a la misma situación. Este es el motivo más frecuente por el que un LLM transfiere al nodo equivocado.
Concretas: Menciona la intención clara del cliente o el tema puntual, evita los estados emocionales vagos.
Testeables: Debes poder imaginar y escribir un mensaje de ejemplo del cliente que dispare esa rama. Si no puedes hacerlo, tu condición es demasiado abstracta.
✅ Conviene (Concreto y Testeable) | ❌ Conviene evitar (Vago y Abstracto) |
"El cliente manifiesta interés concreto en probar un vehículo específico y menciona el modelo" | "Cuando corresponde transferir a test drive" |
"El cliente reporta un problema técnico con un producto ya comprado" | "El cliente tiene un problema" |
🚨 Detección de condiciones similares
Cortex te ayuda a prevenir errores de diseño. El sistema analiza automáticamente la similitud semántica entre tus condiciones cada vez que agregas o editas una. Esta comparación se realiza entre las ramas que salen de un mismo nodo.
Si dos condiciones superan el 80% de similitud, se marcan como conflictivas y aparecerá una notificación roja en la sección de errores de tu panel: "Detectamos {N} condiciones de handoff muy similares entre subnodos. El LLM puede traspasar al nodo equivocado."
Ejemplo de conflicto:
Rama A: "El usuario tiene una consulta sobre cobranza"
Rama B: "El usuario pregunta sobre pagos pendientes"
Problema: La similitud es superior al 80%. El LLM no sabrá elegir de forma consistente.
Cómo resolverlo: El error no desaparecerá hasta que la similitud baje del umbral. Debes diferenciar mejor los casos o consolidar ambos caminos en un solo nodo.
💡 Tip: Esta misma detección de ambigüedad aplica a las ramas de finalización de los Nodos Fin, donde la confusión podría generar problemas operativos en Flowbuilder.
⚡ Qué pasa en runtime y Prevención de bucles
Ejecución en tiempo real
Las condiciones de todas las ramas conectadas a un Nodo Cortex se inyectan en su contexto de memoria, junto con las condiciones de sus hermanos. Con esa información, el nodo sabe qué rutas existen.
Cuando detecta que la consulta actual no le corresponde, la transfiere directamente al nodo adecuado, incluyendo una razón que justifica el traspaso para tu trazabilidad. Si no encuentra un hermano capaz de resolverlo (o no tiene hermanos), la conversación vuelve por defecto al nodo padre.
Prevención de bucles infinitos
Un flujo mal diseñado (con condiciones repetidas o mal planteadas) puede generar transferencias infinitas de un nodo a otro. Cortex detecta esto en runtime.
Si se producen más de cuatro traspasos consecutivos entre nodos del mismo nivel sin que la IA logre darle una respuesta efectiva al cliente, la ejecución se detiene por seguridad y la conversación sale hacia Flowbuilder por la rama de Error de contexto.
💡 Nota: Esta guardia existe para que el cliente no quede atrapado en una experiencia rota. Si se dispara seguido, no es que el límite esté mal calibrado, es una señal directa de que tus condiciones se solapan y debes revisar el diseño del flujo.
¡Dirige el tráfico conversacional como un experto! 🚀
Escribir condiciones claras, concretas y mutuamente excluyentes es el secreto principal para construir un agente inteligente que nunca se confunda y siempre lleve a tus clientes por la ruta correcta. ✅