Pasos de IA
Un paso de IA es el especialista de tu línea de montaje: mientras todos los demás bloques siguen reglas fijas, un agente lee, entiende y decide. Los agentes son realmente poderosos — un solo paso de agente puede llevar un trabajo completo de varias partes por sí mismo: investigar algo, crear los archivos que necesite, llamar varias herramientas y coordinar el trabajo de principio a fin. Así se construían las automatizaciones clásicas, y siguen funcionando muy bien. El equilibrio es simple: los pasos de IA son los únicos bloques que usan créditos, y su resultado varía de ejecución en ejecución. Por eso el arte está en elegir por paso — bloques gratuitos donde las reglas son estrictas y predecibles, pasos de agente donde el trabajo necesita criterio o dinamismo: archivos dinámicos, coordinación flexible, manejar los datos lleguen con la forma que lleguen.
Paso de agente
Un agente, un trabajo. Haz clic en el bloque para configurar:
| Ajuste | Qué hace |
|---|---|
| Agente | Qué agente ejecuta este paso — el agente Nirvai por defecto o cualquier agente que puedas usar. Elige especialistas para trabajo de especialistas. |
| Instrucciones | Qué hacer, escrito como un encargo a un colega capaz. Usa {{variables}} para entregarle los datos de pasos anteriores — se rellenan con valores reales cuando el paso se ejecuta. |
| Salida | Adónde va el resultado, para que los pasos posteriores puedan usarlo. |
Ejemplo de instrucciones
Lee el negocio de abajo y escribe un correo de bienvenida corto y amable para el nuevo cliente. Nombre del negocio:
{{trigger.dealname}}— Monto:{{trigger.amount}}Mantenlo por debajo de 120 palabras y firma como "El equipo de Nirvai".
Salida libre vs. estructurada
Por defecto un agente responde libremente — genial para prosa, correos, resúmenes. Si un bloque posterior necesita meterse dentro del resultado (digamos, extraer score y reason por separado), cambia el paso a salida estructurada y define los campos que esperas. Es la diferencia entre pedir un ensayo y entregar un formulario para rellenar: con un formulario, cada paso posterior sabe exactamente qué casilla leer, y el selector de variables marca esos campos como Estructura verificada. Si el agente termina sin rellenar el formulario correctamente, Nirvai se lo devuelve para que lo corrija antes de que la ejecución continúe.
Router
Un router es un jefe parado en una bifurcación: mira lo que produjo el paso anterior y decide qué camino toma la ejecución. Le das la pregunta a juzgar ("¿Este mensaje es una queja, una pregunta o un elogio?") y un camino de salida por cada respuesta. Como un router piensa, usa créditos — cuando tu decisión es una comparación simple ("¿monto mayor que 1000?"), usa en su lugar el bloque gratuito Condición o Selector.
¿Un paso de agente grande o varios pequeños?
Ambos son válidos — es una decisión de costo y control, no un límite de capacidad:
| Forma | Cuándo gana |
|---|---|
| Un paso de agente haciendo un trabajo de varias partes | El trabajo es dinámico — investigar + escribir + coordinar, archivos cuya forma no puedes predecir, criterio en cada paso. Un agente capaz lo resuelve de una sola vez. |
| Varios pasos: bloques gratuitos alrededor de pasos de agente pequeños | La mayor parte del trabajo es mecánica y de reglas fijas. Los bloques gratuitos hacen las partes fijas gratis, y cada paso de agente pequeño es más barato y más fácil de inspeccionar. |
Esta elección es exactamente el motivo de la mejora de las automatizaciones: las automatizaciones clásicas de solo agentes siguen funcionando bien — los bloques gratuitos simplemente te permiten dejar de pagar por las partes que nunca necesitaron inteligencia.
Errores comunes
| Error | Mejor enfoque |
|---|---|
| Usar un agente para una regla fija ("si monto > 1000") | Eso es una Condición gratuita — guarda los créditos para el criterio de verdad. |
| Partir un trabajo genuinamente dinámico en muchos bloques rígidos | Si el flujo necesita flexibilidad más que reglas estrictas, un solo paso de agente coordinando todo el trabajo es la mejor (y más simple) construcción. |
| Instrucciones que no mencionan los datos entrantes | Referéncialos explícitamente con {{variables}} para que el agente sepa exactamente con qué trabajar. |
| Esperar que pasos posteriores lean campos de una respuesta libre | Activa la salida estructurada y define los campos. |
Qué sigue
- Bloques de lógica y acción — los bloques gratuitos que rodean tus pasos de IA
- Datos entre pasos — cómo las
{{variables}}llevan datos de paso en paso