Nodo AI Agent n8nConfigura AI Agent en n8n.

Este selector indica de dónde saca el agente el mensaje del usuario. Es lo primero que se revisa cuando el nodo se ejecuta con el prompt vacío.

• Connected Chat Trigger Node (auto): busca el campo chatInput llegado de un Chat Trigger conectado directamente al agente.
• Connected Guardrails Node (guardrails): busca guardrailsInput desde un nodo Guardrails conectado directamente.
• Prompt (User Message): el campo obligatorio que abre define (Define below), donde escribes texto o una expresión como {{ $json.subject }}.

Actívalo cuando la respuesta tenga que ser legible por una máquina. El nodo abre entonces el puerto de output parser y deja de devolver un párrafo de prosa.

• Require Specific Output Format: un booleano. Activado, el agente debe producir la forma que describe el parser conectado; desactivado, recibes texto suelto.

Un seguro del lado del modelo. Activado, el agente queda configurado con un modelo de reserva además del principal, para que una llamada fallida tenga salida.

• Enable Fallback Model: un booleano, prescindible en un agente de pruebas, razonable en cuanto el flujo corre sin nadie delante.

Aquí se escribe la instrucción que se envía al agente antes de que empiece la conversación. Casi toda la calidad de un agente se juega en este campo, no en la elección del modelo.

• System Message: texto libre, enviado antes del mensaje del usuario. Describe el rol, el tono, qué hacer cuando una herramienta falla y cuándo conviene no responder en lugar de adivinar.

Un agente trabaja en bucles: pensar, llamar a una herramienta, leer el resultado, volver a pensar. Este número limita cuántos bucles tiene antes de parar.

• Max Iterations: el número máximo de iteraciones que ejecuta el agente antes de detenerse. Súbelo en tareas con varias consultas, bájalo cuando prefieras un fallo rápido a una espiral larga.

Por defecto el nodo devuelve solo la respuesta final. Con esta opción, la salida incluye además los pasos que el agente fue dando.

• Return Intermediate Steps: un booleano. Activado, la salida trae las llamadas a herramientas y sus resultados; desactivado, la carga se mantiene ligera.

Cuando un item llega con una imagen adjunta, esta opción se la entrega al agente como mensaje de tipo imagen en vez de dejarla fuera.

• Automatically Passthrough Binary Images: un booleano que decide si las imágenes binarias pasan automáticamente al agente.

Esta opción engancha tus propias etiquetas a los eventos de trazado de la ejecución, para localizar una pasada por algo que no sea su marca de tiempo.

• Key: el nombre de la etiqueta, por ejemplo un cliente o una campaña.
• Type: el tipo del valor, entre stringValue, numberValue, booleanValue, arrayValue y objectValue.
• Value: el contenido en sí, a menudo una expresión como {{ $json.customerId }}.

Los datos destacados son los que permiten filtrar la vista de ejecuciones por tus propios valores en lugar de recorrer una lista de pasadas.

• Auto-save highlighted data: un booleano, activado por defecto, disponible en los planes Pro y Enterprise de n8n Cloud, y en Enterprise o una Community Edition registrada si te autoalojas.

El streaming devuelve la respuesta mientras se escribe en vez de esperar a la última palabra, lo que cambia por completo cómo se vive una generación larga.

• Enable Streaming: un booleano, activado por defecto. Solo funciona si el flujo arranca con un trigger compatible, es decir un Chat Trigger o un nodo Webhook con Response Mode en Streaming.

Cuando cien items caen de golpe sobre el agente, aquí se frena el nodo a propósito para no salirse de los límites de ritmo del proveedor del modelo.

• Batch Size: cuántos items se procesan en paralelo. Ayuda contra los límites de ritmo, a cambio de que el orden del registro pueda moverse.
• Delay Between Batches: una pausa en milisegundos entre dos lotes, por el mismo motivo.