Agent Router

Este componente actúa como un inteligente centro de despachos o recepcionista dentro de tu flujo de trabajo en Nappai.

Su principal función es leer la información o pregunta que tú (o el sistema) le enviás y decidir hacia dónde debe ir esa información para ser procesada correctamente. En lugar de obligarte a configurar reglas manuales complejas para cada situación, este agente utiliza inteligencia artificial para entender la intención de tu mensaje y enrutarlo automáticamente al “experto” correcto (otro agente) que sabrá cómo responder.

Piense en él como el sistema de recepción de un gran hospital: cuando llegás, no vas directamente al cirujano ni al cardiólogo; el recepcionista (este componente) analiza tu problema, entiende qué necesitas y te deriva al médico especializado adecuado.

¿Cómo funciona?

Internamente, Agent Router utiliza capacidades avanzadas de lenguaje (modelos de IA) para analizar el texto que recibe.

Análisis: Lee tu consulta o dato de entrada.
Clasificación: Compara lo que leéste con las diferentes opciones disponibles en tu sistema de automatización.
Decisión: Elige la ruta más lógica. Por ejemplo, si le escribís “calculá el total de ventas”, entenderá que esto requiere un cálculo y lo enviará al agente de cálculos. Si le escribís “busca información sobre X”, lo enviará al agente de búsqueda.

Nota importante: Este componente no resuelve la tarea final por sí mismo; su único trabajo es garantizar que la tarea llegue a quien está capacitado para resolverla.

Operaciones

Este es un componente especializado en enrutamiento inteligente. A diferencia de otros nodos que tienen múltiples botones para realizar acciones distintas, este componente opera como un único proceso continuo de decisión.

SmartRouting: Esta es la operación principal y única. Permite al agente analizar el contexto actual y determinar dinámicamente cuál debe ser el siguiente paso en el flujo de trabajo, basándose en la intención del usuario o en los datos recibidos.

INSTRUCCIÓN PARA EL LLM: No hay operaciones múltiples para listar, se omite la lista detallada y se enfoca en el comportamiento de enrutamiento único.

Entradas

A diferencia de otros componentes que te piden llenar campos específicos (como “Fecha” o “Email”), Agent Router es un nodo pasivo de decisión.

Campos de Entrada

None (Sin campos explícitos): Este componente no posee campos de entrada visibles en la interfaz gráfica para que los rellenes manualmente. Se espera que la información llegue automáticamente desde el nodo anterior en tu flujo de trabajo. No necesitas configurar “Entrada 1” o “Texto”, ya que el sistema conecta los nodos automáticamente.

Salidas

El resultado que produce este componente es fundamental para la continuidad de tu automatización.

Resultado de la Decisión (Estado/Ruta): La salida de este nodo es una instrucción de flujo. Básicamente, devuelve un indicador que dice: “Llevá la información al Agente A” o “Llevá la información al Agente B”.

Esta salida se conecta directamente a los siguientes nodos. No recibirás un texto final ni un número, sino una señal para activar el siguiente paso del proceso.

Ejemplo de Respuesta JSON

Aunque este componente no devuelve datos visibles al usuario final (como un precio o un email), internamente genera una estructura de decisión. El formato técnico que verías en los logs del sistema sería similar a este: json { “next_node”: “SearchAgent_01”, “confidence_score”: 0.95, “context_updated”: true, “status”: “routed” }

En la práctica, tú solo verás la línea que dice "next_node": "SearchAgent_01", lo que significa que el sistema decidió que la siguiente acción debe ser realizada por el agente de búsqueda.

Conectividad

Este componente se conecta principalmente a Agentes de Acción o Herramientas Especializadas.

Conexión Típica: Por lo general, saldrá del Agent Router hacia nodos como Google Search Agent, Database Calculator, Email Sender, o Code Interpreter.
Lógica: El router actúa como un “nodo madre” que ramifica el flujo. Es lógico conectar su salida a múltiples agentes diferentes, ya que la belleza de este componente es la capacidad de enviar la misma entrada a destinos distintos según el caso.

Ejemplo de Uso

Imaginá que creás un sistema de atención al cliente automatizado en Nappai.

El usuario envía un mensaje a tu sistema.
Ese mensaje entra en el Agent Router.
El Router analiza el mensaje: “Quiero cambiar la fecha de mi vuelo”.
El Router detecta que esto requiere acceso a datos y cambios en reservas.
El Router enruta automáticamente esa información al Agente de Base de Datos.
Si el mensaje hubiese sido “¿Cuál es el clima hoy?”, el Router habría enviado la información al Agente de Clima.

Sin este componente, tendrías que programar manualmente todas las reglas de “Si dice A, ve a B; si dice C, ve a D”. Este componente hace ese trabajo de clasificación automáticamente.

Componentes Relacionados

LanggraphSmartRouterAgent - Es el “padre” técnico de este componente, conteniendo la lógica base de cómo se toman las decisiones de enrutamiento.
Router_base_agent - Representa la estructura fundamental de cualquier agente que se encarga de dirigir tráfico en el sistema.

Notas Importantes

Es importante que tengas en cuenta la siguiente información técnica sobre este componente:

⚠️ Componente de Legado (Legacy) Este componente está marcado oficialmente como “legacy” (anticuado/legado). Esto significa que:

Es una versión antigua del sistema de enrutamiento.
Podría ser reemplazado en el futuro por versiones más rápidas o potentes.
Se recomienda cautela si lo estás usando en proyectos nuevos o críticos. Verificá si existe una versión “v2” o “pro” del router en la biblioteca de Nappai para mejores resultados.

ℹ️ Funcionamiento Invisible Este componente no tiene campos de configuración visuales. Su comportamiento está definido internamente por la lógica de IA subyacente. No esperes ver opciones para “Ajustar sensibilidad” o “Elegir idioma”; su comportamiento es automático y autónomo una vez conectado al flujo.

Consejos y Mejores Prácticas

Prueba con ejemplos variados: Dado que usa IA para decidir, probá que el router reciba diferentes tipos de preguntas (peticiones, dudas, comandos) para ver si las enruta correctamente a los agentes adecuados.
Monitoreo de flujos: Si tu flujo se detiene, revisá qué ruta eligió el Agent Router. A veces, la IA puede “confundirse” y enviar una información compleja a un agente demasiado simple que no la puede procesar.
Actualización de versiones: Si el sistema te avisa que hay actualizaciones disponibles para componentes de enrutamiento, considerá migrar a esta nueva versión para evitar obsolescencia prematura.

Consideraciones de Seguridad

Validación de Inputs: Aunque este componente solo “lee” para decidir, asegúrate de que la información que le llegues proceda de fuentes confiables dentro de tu sistema de Nappai, ya que la decisión de enrutamiento se basa en el contenido de esos datos.