Message à un agent
n8n : Message an AgentToutes les offres1 entrée · 1 sortie
Envoie un message à un agent de l'organisation (workflow publié commençant par un déclencheur de chat) et transmet sa réponse.
Fonctionnement
Un message par élément reçu : une exécution de l'agent (mode Sous-workflow, environnement de l'exécution), attendue sans occuper de worker. La conversation de l'agent (sa mémoire) est celle de la clé choisie.
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Agent (workflow)obligatoire | workflow | Workflow commençant par un déclencheur de chat, publié dans l'environnement de l'exécution. |
| Messageobligatoire | texte long | — |
| Conversation | choix | Valeurs : Celle de l'élément reçu (sessionId), sinon une nouvelle, Clé choisie, Toujours une nouvelle conversation. |
| Clé de conversationselon les autres paramètres | texte | — |
| Attente maximale de la réponse (secondes) | nombre | — |
| En cas d'échec de l'agent | choix | Valeurs : Arrêter le workflow, Continuer avec l'erreur dans l'élément. |
Données reçues et renvoyées
- EntréeListe d'éléments.
- Sortie{ text, structuredOutput, session, usage, toolCalls, status, executionId } par élément ; « text » est la réponse de l'agent.
Erreurs
Agent introuvable, non publié dans l'environnement, sans déclencheur de chat ; échec ou délai dépassé (l'exécution de l'agent est alors annulée).
À savoir. Chaque message compte comme une exécution. La profondeur d'appels est limitée à 3.
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"message": "Résume la commande {{ $json.id }}",
"sessionMode": "custom",
"sessionKey": "commande-{{ $json.id }}"
}Voir aussi
- Garde-fousContrôle un texte (message d'un utilisateur, réponse d'une IA) : données personnelles, secrets, adresses, mots interdits, contournement, hors sujet… ou masque ce qui doit l'être.
- Chat : répondreÉcrit un message dans la conversation du chat en cours, et peut attendre la réponse de la personne ou son approbation.
- Outil MCPConfie à un agent IA les outils d'un serveur MCP externe, avec les mêmes contrôles que les autres outils (droits, limites, approbation).