> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Routing
> Configura el enrutamiento inteligente de conversaciones para que cada mensaje llegue al workflow correcto automáticamente.
Cuando un proyecto tiene varios workflows, el **AI Routing** decide automáticamente cuál ejecutar para cada mensaje entrante. En lugar de enrutar por palabras clave exactas, el sistema compara semánticamente el mensaje con el nombre y descripción de cada workflow y elige la mejor coincidencia — similar a un coordinador que lee el contexto completo antes de asignar una tarea.
## Cómo funciona
Los mensajes iniciales se comparan automáticamente con el nombre y descripción de todos los workflows del proyecto. El sistema elige el workflow cuyo propósito más se acerca a lo que el usuario está preguntando y lo ejecuta. Si ningún workflow encaja bien, se ejecuta el **workflow de respaldo**.
El AI Routing se configura en dos niveles: a nivel de proyecto (estrategia general y habilitación) y a nivel de workflow (nombre, descripción y reglas de ejecución individuales).
## Configuración por proyecto
La página de **AI Routing** en Ajustes centraliza la configuración de enrutamiento para cada proyecto. Selecciona el proyecto en el selector del lado izquierdo para ver todas las tarjetas de configuración.
### Estrategia de despliegue
Esta sección solo aparece si el proyecto todavía tiene intenciones legacy configuradas.
Define cómo se distribuye el tráfico hacia el AI Routing. Elige entre dos modos:
**Porcentaje activo** — usa el slider o el campo numérico para definir qué porcentaje de usuarios usará AI Routing. El resto continúa con las intenciones legacy.
* `0 %` → todo el tráfico usa intenciones legacy
* `100 %` → todo el tráfico usa AI Routing
* Útil para hacer una migración progresiva sin cortar el sistema anterior de golpe
**Número de teléfono** — ingresa una lista de números específicos que podrán probar el AI Routing. Los demás usuarios continúan con el sistema legacy. Ideal para validar el enrutamiento con un grupo controlado antes de abrirlo al 100 %.
### Toma de control
Define cuándo el AI Router toma el control de la conversación. Es útil para manejar usuarios que inician la conversación con un saludo antes de exponer su consulta real.
Elige entre dos modos:
**Ruteo inmediato** — el AI Router intenta derivar al usuario desde su primer mensaje. Ideal cuando tus usuarios suelen escribir directamente su consulta sin preámbulos.
**Filtrar saludos** — el sistema ignora mensajes cortos de cortesía como "Hola" o "Buenos días" y espera a detectar una intención real antes de enrutar al usuario. Con este modo activo, puedes configurar dos valores adicionales:
| Campo | Descripción |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| **Tiempo de espera** | Segundos que el sistema aguarda sin detectar intención antes de enviar un mensaje al usuario. |
| **Mensaje por defecto** | Texto que se envía al usuario cuando el tiempo de espera vence sin que se haya detectado una intención. |
### Workflow de respaldo
Selecciona en el desplegable el workflow que se ejecutará cuando el AI Routing no pueda determinar una intención clara, o cuando el AI Routing esté deshabilitado. Haz clic en **Guardar** para aplicar el cambio.
### Exportar descripciones
Descarga un archivo con el listado de todos los workflows del proyecto y sus descripciones actuales. Elige entre formato **Markdown** o **Excel** según tu flujo de trabajo. Útil para revisar o auditar la calidad de las descripciones que el AI Routing usa para enrutar.
### Workflows con AI Router
La tarjeta inferior muestra todos los workflows del proyecto separados en dos grupos — los que ya tienen AI Routing configurado y los que aún no — con un indicador de estado:
* **Punto verde** — el workflow tiene descripción y el AI Routing puede usarlo para enrutar.
* **Punto naranja** — el workflow no tiene descripción; el AI Routing no podrá seleccionarlo correctamente.
Haz clic en cualquier workflow para abrirlo directamente en el canvas y configurarlo.
Los workflows sin descripción no se enrutan correctamente. Si ves puntos naranjas, agrega una descripción clara a esos workflows desde el nodo Start.
## Configuración por workflow
Accede al panel de configuración desde el nodo **Start** de cualquier workflow. El panel tiene tres pestañas.
### Pestaña AI Router
Configura el nombre y la descripción que el sistema usa para enrutar mensajes hacia este workflow.
| Campo | Descripción | Límite |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Nombre** | Identificador corto del workflow. Debe describir de forma concisa qué hace. | 50 caracteres |
| **Descripción** | Explica en detalle cuándo debe ejecutarse este workflow y qué tipo de mensajes atiende. Cuanto más específica, más preciso el enrutamiento. | 5 000 caracteres |
| **Workflow de respaldo** | Marca este workflow como destino predeterminado cuando ningún otro coincide con el mensaje. Solo puede haber un workflow de respaldo por proyecto. | — |
Escribe descripciones claras y específicas: qué tipo de solicitudes atiende el workflow, qué problemas resuelve y en qué contextos debe ejecutarse. Cuanto más detallada sea la descripción, más preciso será el enrutamiento.
#### Probar enrutamiento
Antes de publicar, verifica que los mensajes se enruten al workflow correcto desde esta misma pestaña.
Haz clic en **Probar enrutamiento**. Se abre el modal de evaluación.
Escribe una o varias frases en el campo de texto, o descarga la plantilla, complétala con los mensajes que quieres evaluar y súbela para probar en volumen.
Para cada mensaje evaluado verás:
* **Workflow seleccionado**: el workflow al que se enrutaría el mensaje.
* **Razonamiento**: explicación breve de por qué se eligió ese workflow.
* **Indicador de coincidencia**: verde si el mensaje coincide con el workflow que se está probando, gris si coincide con otro workflow del proyecto, ámbar si no hubo ninguna coincidencia y se ejecutará el workflow de respaldo.
### Pestaña Avanzado
Configura restricciones de ejecución que limitan cuándo y para quién se activa el workflow.
**Ocultar workflow** — excluye este workflow del AI Routing. Cuando está oculto, el sistema nunca lo seleccionará automáticamente; solo puede ejecutarse mediante un redireccionamiento forzado desde otro workflow.
No puedes ocultar el workflow de respaldo. Desactívalo primero como workflow por defecto antes de ocultarlo.
Las siguientes reglas restringen la ejecución del workflow a usuarios o contextos específicos:
Restringe el workflow a un grupo específico de números de teléfono. Solo los usuarios de la lista podrán activarlo, independientemente del contenido del mensaje.
* Formato requerido: E.164 (ej. `+593999123456`, `+5215512345678`)
* Máximo **20 entradas** por workflow
* Cada entrada incluye número de teléfono y nombre opcional para identificación
Si activas esta regla y un usuario fuera de la lista envía un mensaje, el workflow no se ejecutará aunque el contenido coincida semánticamente. El mensaje se enruta al workflow de respaldo.
Limita el workflow a usuarios que se comuniquen desde ciertos países, usando el prefijo telefónico internacional.
* Ejemplos: `+593` (Ecuador), `+57` (Colombia), `+52` (México), `+55` (Brasil)
* Puedes seleccionar múltiples prefijos simultáneamente
* Si el número del usuario no coincide con ningún prefijo, se enruta al workflow de respaldo
### Pestaña Intenciones Legacy
Esta pestaña solo aparece si la cuenta todavía tiene intenciones configuradas.
Si el 100 % del tráfico ya usa AI Routing, las intenciones legacy no tienen efecto. Puedes mantenerlas como respaldo durante la transición.
Gestiona las frases clave del sistema de enrutamiento anterior. Estas intenciones activaban el workflow antes de que el AI Routing estuviera disponible y se mantienen para proyectos que migran gradualmente usando la estrategia de despliegue por porcentaje.
## Migrar desde intenciones legacy
Los proyectos que todavía usan el sistema de intenciones legacy verán el botón **Migrar proyecto** en la página de **AI Routing** en Ajustes. Al abrirse la ventana de migración, el sistema usa las intenciones configuradas en cada workflow para inferir automáticamente una descripción inicial — la misma que el AI Routing empleará para enrutar mensajes.
En la página de **AI Routing**, haz clic en el botón **Migrar proyecto**. La ventana muestra todos los workflows del proyecto junto con la cantidad de intenciones legacy asociadas a cada uno.
El listado muestra cada workflow con su cantidad de intenciones y la descripción inferida a partir de ellas. Revisa cada descripción y ajústala si no refleja con precisión el propósito del workflow — cuanto más clara sea, más preciso será el enrutamiento.
Ajusta el slider para determinar qué porcentaje del tráfico comenzará a usar AI Routing. El tráfico restante seguirá usando las intenciones legacy. Empieza con un valor bajo —entre 10 % y 20 %— para validar el enrutamiento antes de escalar.
Haz clic en **Migrar**. El porcentaje configurado entra en efecto de inmediato. Puedes ajustarlo en cualquier momento desde la sección **Estrategia de despliegue**.
Antes de aumentar el porcentaje, usa **Probar enrutamiento** desde el nodo Start de cada workflow para verificar que los mensajes se enrutan correctamente con AI Routing.
Las intenciones legacy no se eliminan durante la migración. Permanecen activas para el porcentaje del tráfico que todavía no usa AI Routing.
## Casos de uso
Un proyecto con workflows de soporte (devoluciones, reclamos), ventas (catálogo, precios) y pagos (facturación, métodos de pago): el AI Routing analiza el mensaje del usuario y lo dirige al workflow correcto sin menús ni botones de selección. El workflow de respaldo maneja consultas ambiguas con una respuesta genérica.
Una empresa con tres líneas de producto configura un workflow por línea, cada uno con una descripción detallada de los problemas que atiende. Los mensajes que mencionan síntomas específicos llegan directamente al workflow especializado sin que el usuario deba indicar el producto.
Un equipo de atención al cliente activa la lista de usuarios permitidos en su workflow de soporte premium. Solo los números registrados como VIP acceden a ese workflow; el resto de los usuarios es atendido por el workflow estándar.
Un equipo que ya tiene intenciones configuradas usa la estrategia de despliegue por porcentaje para migrar gradualmente. Comienza con un 20 % del tráfico en AI Routing, valida los resultados con el panel de pruebas y sube el porcentaje semana a semana hasta llegar al 100 %.
Despliega tu proyecto con AI Routing configurado a producción.
Revisa y restaura versiones anteriores de tu configuración.
Monitorea cómo se ejecutan los workflows enrutados en producción.
Configura el AI Agent dentro de cada workflow para procesar los mensajes enrutados.
### Estrategia de despliegue
### Pestaña AI Router
Configura el nombre y la descripción que el sistema usa para enrutar mensajes hacia este workflow.
| Campo | Descripción | Límite |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Nombre** | Identificador corto del workflow. Debe describir de forma concisa qué hace. | 50 caracteres |
| **Descripción** | Explica en detalle cuándo debe ejecutarse este workflow y qué tipo de mensajes atiende. Cuanto más específica, más preciso el enrutamiento. | 5 000 caracteres |
| **Workflow de respaldo** | Marca este workflow como destino predeterminado cuando ningún otro coincide con el mensaje. Solo puede haber un workflow de respaldo por proyecto. | — |
