Router Inteligente

El **Router Inteligente ** actúa como un interruptor o “switch” inteligente dentro de la plataforma NappAI. Su función principal es analizar la entrada del usuario o un conjunto de datos y determinar, mediante razonamiento de IA, cuál es la intención predominante para redirigir el flujo hacia la rama de ejecución más adecuada.

A diferencia de un router basado en palabras clave rígidas, este componente utiliza modelos de lenguaje para entender el contexto y los matices semánticos, lo que permite una clasificación mucho más precisa y flexible. Cada intención configurada genera su propia salida física en el nodo, permitiendo bifurcar la lógica del grafo de manera limpia y eficiente.

Casos de Uso Principales

Utilice el Smart Router Agent para desarrollar soluciones que requieran:

Soporte Multicanal Inteligente: Clasificar si un ticket de entrada es una queja, una duda técnica o un agradecimiento, enviándolo al departamento correcto.
Menús de Voz o Chat Natales: Sustituir los menús numéricos por una interfaz de lenguaje natural que entiende qué quiere el usuario.
Procesamiento Condicional de Datos: En flujos de procesamiento por lotes, decidir qué registros deben ser auditados y cuáles pueden ser aprobados automáticamente.
Filtrado de Seguridad: Identificar intenciones maliciosas o fuera de contexto antes de que lleguen a agentes más costosos o sensibles.

Configuración Fundamental

Estos parámetros definen la lógica de clasificación y el motor de inteligencia.

Parámetro	Descripción Técnica	Propósito en el Flujo
`Data Input`	El objeto o mensaje que el router debe analizar para clasificar.	Es la fuente de información sobre la cual se realizará el análisis de intención.
`Model (llm)`	La conexión al Modelo de Lenguaje (LLM) que realizará la clasificación.	Actúa como el motor cognitivo que interpreta la entrada frente a las descripciones de las intenciones.
`Number of Intentions`	Cantidad de rutas de salida que el agente debe habilitar.	Determina cuántas opciones de bifurcación tendrá el nodo (ej. 3 intenciones crearán 3 salidas).
`Intention [X] Name`	Nombre identificador de la ruta (ej. `soporte_tecnico`).	Define la etiqueta de la salida y el nombre de la categoría para el LLM.
`Intention [X] Description`	Descripción detallada de cuándo debe elegirse esta ruta.	Nota Crítica: Proporcione descripciones claras; el LLM utiliza este texto para decidir si la entrada encaja aquí o no.

Funcionalidades Avanzadas

El Smart Router incluye capacidades para ajustar la precisión y manejar grandes volúmenes de datos.

Intention Accuracy: Control de Certeza

Confidence Threshold: Define el nivel de certeza mínimo (0.0 - 1.0) para clasificar una intención. Si el modelo tiene una seguridad inferior al umbral (ej. 0.7), el router puede evitar tomar una decisión errónea o enviar la consulta a una ruta por defecto.

Batch Mode: Procesamiento Masivo

Batch Mode (mapping_mode): Permite procesar una lista de elementos de forma individual y paralela. Cada item de la lista se clasifica y se envía a su salida correspondiente.
Parallel Executions: Define cuántos elementos del lote se procesan simultáneamente (Rango 1-5). Optimiza el tiempo de ejecución en tareas de clasificación masiva.
Skip if Empty Batch Input: Evita errores deteniendo la ejecución del componente si la lista de entrada está vacía.

️ Run Conditions: Control de Flujo

Skip Branch if Empty Output: Si el router no encuentra una clasificación válida o la salida es nula, detiene las ramas de ejecución siguientes para evitar fallos en cadena en componentes posteriores.

Context and Memory: Gestión de Estado

Use Memory (use_checkpointer): Permite al router considerar interacciones previas para clasificar la intención actual, ideal para conversaciones donde la intención se aclara a lo largo del diálogo.

Salidas del Componente

El nodo generará dinámicamente tantas salidas como se hayan definido en el parámetro Number of Intentions.

Intention 1...X: Los datos originales se redirigen a la salida específica que coincida con la intención detectada.
Default: (Opcional) Ruta de escape cuando ninguna intención cumple con el umbral de confianza mínimo.

Consejos y Mejores Prácticas

Descripciones Excluyentes: Asegúrese de que las descripciones de las intenciones no se solapen. Cuanto más distintas sean entre sí, mejor será el rendimiento del router.
Umbral de Confianza: Un valor de 0.7 es ideal para la mayoría de los casos. Súbalo a 0.9 para tareas críticas donde no se permiten errores de enrutamiento.
Uso como Herramienta: Al completar el Agent Description, este router puede ser invocado por un Supervisor Agent para que este último sepa que puede usarlo para clasificar usuarios.

Puedes ver un video que muestra la potencia del Router Inteligente aquí.