Saltar al contenido principal

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.

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.
Página de AI Routing en Ajustes con selector de proyecto, estrategia de despliegue y workflows configurados

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 %.

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.
Panel de configuración del nodo Start con pestaña AI Router y modal de probar enrutamiento

Pestaña AI Router

Configura el nombre y la descripción que el sistema usa para enrutar mensajes hacia este workflow.
CampoDescripciónLímite
NombreIdentificador corto del workflow. Debe describir de forma concisa qué hace.50 caracteres
DescripciónExplica 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 respaldoMarca 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.
1

Abre el panel de pruebas

Haz clic en Probar enrutamiento. Se abre el modal de evaluación.
2

Ingresa los mensajes a evaluar

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.
3

Interpreta los resultados

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.
Ventana de migración de proyecto con descripciones inferidas y control de porcentaje de despliegue
1

Abre la ventana de migración

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.
2

Revisa las descripciones inferidas

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.
3

Define el porcentaje de despliegue

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.
4

Confirma la migración

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 %.

Publicar versiones

Despliega tu proyecto con AI Routing configurado a producción.

Historial de versiones

Revisa y restaura versiones anteriores de tu configuración.

Ejecuciones de workflow

Monitorea cómo se ejecutan los workflows enrutados en producción.

Nodo AI Agent

Configura el AI Agent dentro de cada workflow para procesar los mensajes enrutados.