Pasos de Agente y Routers
Construir una automatización es como montar una línea de ensamblaje: algunas estaciones hacen el trabajo real y otras deciden hacia dónde debe ir el producto a continuación. En Nirvai, los trabajadores son los pasos de agente y los que toman decisiones son los routers. Cada uno es un nodo -- un solo bloque en el espacio de trabajo. Esta página explica cómo configurar cada uno y cómo fluye la información entre ellos.
Pasos de Agente
Un paso de agente le entrega una tarea a uno de tus agentes IA. El agente lee sus instrucciones, hace el trabajo y guarda el resultado para que el siguiente paso lo pueda usar.
Image: Un panel de configuracion de paso de agente mostrando selector de agente, campo de instrucciones y configuracion de archivo de salida
Configurar un paso de agente
Cada paso de agente tiene tres partes:
1. Qué agente realiza la tarea
Elige de los agentes disponibles en tu automatización:
- Agente Nirvai Predeterminado — de propósito general, siempre disponible
- Tus agentes personalizados — agentes que creaste con su propio conocimiento, herramientas e instrucciones
Elige el agente cuyas habilidades mejor coincidan con la tarea. Por ejemplo, usa un agente con herramientas de búsqueda web para investigación, o un agente con acceso a bases de datos para buscar datos.
2. Instrucciones — qué hacer
Escribe instrucciones claras diciéndole al agente qué hacer con la información que recibe. Piensa en ello como instruir a un compañero de equipo.
| Calidad de la Instrucción | Ejemplo |
|---|---|
| Buena | "Busca artículos de noticias sobre Tesla publicados en las últimas 24 horas. Enfócate en noticias financieras y anuncios de productos. Resume las 5 historias principales en viñetas." |
| Demasiado vaga | "Encuentra noticias de Tesla" |
| Buena | "Lee el feedback del cliente a continuación. Clasifica el sentimiento como positivo, negativo o neutral. Extrae la queja o elogio principal. Califica la urgencia de 1-5." |
| Demasiado vaga | "Analiza este feedback" |
Escribe instrucciones como si estuvieras hablando con un compañero de equipo inteligente que nunca ha hecho esta tarea antes. Sé específico sobre lo que quieres, qué formato usar y en qué enfocarse.
3. Dónde guardar el resultado
Cada paso guarda su trabajo en un archivo (por ejemplo, ./outputs/step1_result.json -- un archivo simple que contiene los resultados del paso). Ese archivo se convierte en el material de inicio para el siguiente paso de la cadena.
Cómo se encadenan los pasos
Cada paso de agente lee el resultado del paso anterior y produce su propio resultado para el siguiente.
- El Paso 1 recibe la información del trigger (el contexto del horario, la información que envió otra app, o lo que tú escribiste a mano)
- El Paso 2 recibe el resultado guardado del Paso 1 como su material de inicio
- El Paso 3 recibe el resultado del Paso 2, y así sucesivamente
Apuntas a resultados anteriores en tus instrucciones simplemente describiendo la información que el agente debería buscar. Nirvai se encarga de pasar los archivos entre pasos por ti.
Comportamiento de éxito y fallo
Cada paso de agente tiene configuraciones opcionales para lo que sucede cuando termina:
| Configuración | Qué Hace |
|---|---|
| En éxito | A qué paso ir a continuación cuando el agente termina exitosamente |
| En fallo | Qué hacer si el agente encuentra un error — saltar a un paso diferente, intentar de nuevo o detenerse |
Pasos de Router
Un router lee el resultado de un paso anterior y envía la automatización por diferentes caminos según condiciones — como un gerente que lee un reporte y decide quién lo maneja a continuación.
Image: Un panel de configuracion de router mostrando el prompt de entrada y una lista de condiciones con sus pasos objetivo
Configurar un router
1. La pregunta para evaluar
Dile al router qué juzgar. Esto usualmente es una pregunta sobre el resultado del paso anterior.
Ejemplo: "Basándote en los resultados del análisis de sentimiento, decide si el feedback es positivo, negativo o neutral."
2. Condiciones y rutas
Define las respuestas posibles y a dónde conduce cada una:
| Condición | Descripción | Siguiente Paso |
|---|---|---|
positive | El cliente está contento | → Agente "Enviar Agradecimiento" |
negative | El cliente está descontento | → Agente "Escalar a Soporte" |
neutral | Sin sentimiento fuerte | → Agente "Registrar y Archivar" |
Ejemplo de router en el espacio de trabajo
Image: Un nodo router en el canvas con tres conexiones salientes a diferentes pasos de agente
Cuándo usar routers
- Diferentes respuestas según la entrada — feedback positivo vs. negativo, alta vs. baja prioridad
- Procesamiento condicional — ejecutar pasos costosos solo cuando se cumplen ciertos criterios
- Manejo de errores — enrutar a un paso de respaldo si el resultado del paso anterior apunta a un problema
Puedes encadenar varios routers en fila para árboles de decisión complejos, pero mantén tus automatizaciones lo más simples posible. Si tienes más de 2-3 routers, considera dividir en automatizaciones separadas.
Consolidación de Pasos
Cuando el mismo agente maneja varias tareas seguidas, combínalas en un solo paso con un conjunto detallado de instrucciones en lugar de crear pasos separados.
Correcto — un paso con instrucciones detalladas:
| Paso | Agente | Instrucciones |
|---|---|---|
| 1 | Agente de Calendario | "1. Obtén los eventos de esta semana del calendario. 2. Formátealos en un resumen HTML. 3. Envía el resumen por email al equipo." |
Incorrecto — tres pasos separados con el mismo agente:
| Paso | Agente | Instrucciones |
|---|---|---|
| 1 | Agente de Calendario | "Obtén los eventos de esta semana" |
| 2 | Agente de Calendario | "Formatea los eventos en HTML" |
| 3 | Agente de Calendario | "Envía el HTML por email" |
Solo divide en pasos separados cuando:
- Diferentes agentes manejan cada tarea
- Un router necesita bifurcarse entre ellos
- Los pasos se ejecutan en paralelo con diferentes entradas
AI Setup sigue esta regla por ti automáticamente. Si estás construyendo a mano, combina pasos que usan el mismo agente — reduce la sobrecarga y mantiene todo en un solo lugar.
Modo de Ejecución y Comportamiento de Pasos
El modo de ejecución que eliges afecta qué tan profundamente trabaja cada paso de agente:
| Modo | Comportamiento del Agente | Cuándo Usar |
|---|---|---|
| Agile | Los agentes trabajan rápido, con un nivel de análisis estándar | Tareas simples, ejecuciones frecuentes, automatizaciones sensibles al tiempo |
| Intensive | Los agentes toman más tiempo para un análisis más exhaustivo y profundo | Investigación compleja, reportes detallados, decisiones de alto impacto |
El modo Intensive da a los agentes más tiempo de trabajo por paso, lo que significa mejores resultados para tareas que requieren razonamiento profundo — pero una ejecución general más lenta.
El modo Intensive está disponible en planes PRO. AI Setup elige el modo adecuado según qué tan compleja es tu automatización.
Consejos para Pasos Efectivos
Usa agentes especializados
En lugar de hacer que un agente haga todo, crea agentes especializados para diferentes tareas:
| Agente | Especialidad |
|---|---|
| Agente de Investigación | Búsqueda web, recopilación de datos |
| Agente Escritor | Resumir, redactar contenido |
| Agente Analista | Análisis de datos, clasificación |
| Agente de Notificaciones | Enviar emails, publicar en canales |
Mantén los pasos enfocados
Cada paso debería hacer una cosa bien. Si las instrucciones de un agente son más largas que un párrafo corto, considera dividir la tarea en dos pasos.
Planifica tu flujo de datos
Antes de construir, esboza qué información necesita y produce cada paso:
- ¿Qué proporciona el trigger?
- ¿Qué necesita producir el Paso 1 para el Paso 2?
- ¿Dónde bifurcan los routers?
- ¿Cuál es el resultado final?
Solución de problemas
| Problema | Solución |
|---|---|
| El agente hace lo incorrecto | Haz las instrucciones más específicas — di exactamente qué hacer, qué formato usar y en qué enfocarse. Las instrucciones vagas dan resultados vagos. |
| El agente no puede hacer lo que pediste | Verifica que elegiste un agente con las herramientas correctas (por ejemplo, búsqueda web para investigación, o acceso a bases de datos para consultas). |
| Un paso no usa el resultado del paso anterior | Confirma que los pasos estén conectados en el espacio de trabajo y que tus instrucciones describan la información a buscar. |
| El router sigue eligiendo el camino equivocado | Haz cada condición más específica y sin superposiciones, y revisa el resultado del paso anterior para ver qué está juzgando el router. |
| Los resultados no son suficientemente exhaustivos | Cambia al modo Intensive (planes PRO) para que el agente tenga más tiempo para pensar. |
Qué sigue
Una vez que tus pasos y routers estén configurados, continúa a Pruebas y Ejecuciones para probar tu automatización, encenderla y observar cada ejecución en detalle.