Nœud AI Agent n8nConfigurer AI Agent dans n8n.

Ce sélecteur indique où l'agent va chercher le message de l'utilisateur. C'est la première chose à vérifier quand le nœud tourne sur un prompt vide.

• Connected Chat Trigger Node (auto) : cherche le champ chatInput venu d'un Chat Trigger branché directement sur l'agent.
• Connected Guardrails Node (guardrails) : cherche guardrailsInput depuis un nœud Guardrails branché directement.
• Prompt (User Message) : le champ requis ouvert par define (Define below), où tu saisis du texte ou une expression comme {{ $json.subject }}.

À activer quand la réponse doit être lisible par une machine. Le nœud expose alors le port d'output parser et cesse de renvoyer un paragraphe de prose.

• Require Specific Output Format : un booléen. Activé, l'agent doit produire la forme décrite par le parser branché ; désactivé, tu récupères du texte brut.

Une sécurité côté modèle. Activé, l'agent est configuré avec un modèle de repli en plus du principal, pour qu'un appel en échec ait une porte de sortie.

• Enable Fallback Model : un booléen, inutile sur un agent de test, pertinent dès que le workflow tourne sans personne devant.

C'est ici qu'on écrit l'instruction envoyée à l'agent avant le début de la conversation. L'essentiel de la qualité d'un agent se joue dans ce champ, pas dans le choix du modèle.

• System Message : du texte libre, transmis avant le message utilisateur. Décris le rôle, le ton, la conduite à tenir quand un outil échoue, et les cas où il vaut mieux ne rien répondre que deviner.

Un agent travaille en boucles : réfléchir, appeler un outil, lire le résultat, réfléchir encore. Ce nombre plafonne les boucles auxquelles il a droit avant l'arrêt.

• Max Iterations : le nombre maximal d'itérations avant que l'agent s'arrête. Monte-le pour une tâche à plusieurs recherches, baisse-le quand tu préfères un échec rapide à une longue spirale.

Par défaut le nœud ne rend que la réponse finale. Avec cette option, la sortie contient aussi les étapes par lesquelles l'agent est passé.

• Return Intermediate Steps : un booléen. Activé, la sortie inclut les appels d'outils et leurs résultats ; désactivé, la charge utile reste légère.

Quand un item arrive avec une image attachée, cette option la transmet à l'agent sous forme de message de type image au lieu de la laisser de côté.

• Automatically Passthrough Binary Images : un booléen qui décide si les images binaires sont passées automatiquement à l'agent.

Cette option accroche tes propres étiquettes aux événements de traçage de l'exécution, pour retrouver un passage autrement que par son horodatage.

• Key : le nom de l'étiquette, par exemple un client ou une campagne.
• Type : le type de la valeur, parmi stringValue, numberValue, booleanValue, arrayValue et objectValue.
• Value : le contenu lui-même, souvent une expression comme {{ $json.customerId }}.

Les données mises en avant permettent de filtrer la vue des exécutions sur tes propres valeurs, au lieu de faire défiler une liste de passages.

• Auto-save highlighted data : un booléen, activé par défaut, disponible sur les offres Pro et Enterprise de n8n Cloud, ainsi que sur Enterprise ou une Community Edition enregistrée en auto-hébergé.

Le streaming renvoie la réponse au fil de l'écriture au lieu d'attendre le dernier mot, ce qui change complètement la perception d'une génération longue.

• Enable Streaming : un booléen, activé par défaut. Il ne fonctionne que si le workflow démarre sur un trigger compatible, c'est-à-dire un Chat Trigger ou un nœud Webhook dont Response Mode est réglé sur Streaming.

Quand une centaine d'items arrivent d'un coup sur l'agent, c'est ici qu'on ralentit volontairement le nœud pour rester dans les limites de débit du fournisseur du modèle.

• Batch Size : le nombre d'items traités en parallèle. Utile contre les limites de débit, au prix d'un ordre de journal qui peut bouger.
• Delay Between Batches : une pause en millisecondes entre deux lots, pour la même raison.