Skip to main content

Welcome to a Grasp lesson

Create a free account to keep studying and create your own study path.

Lesson 43

Agent à outil unique

Recommended resources

Bonjour ! Dans la leçon précédente, nous avons disséqué l'anatomie d'un agent IA dans n8n, en identifiant ses cinq composants essentiels et en voyant comment créer des outils personnalisés grâce aux sous-agents. Vous avez ainsi acquis les fondations théoriques nécessaires pour assembler des systèmes intelligents.

Aujourd'hui, nous mettons ces connaissances en pratique pour construire notre tout premier agent fonctionnel. L'objectif est de créer un assistant spécialisé, pertinent pour votre quotidien de développeur : un agent capable de prendre un morceau de code et de l'expliquer. Pour ce faire, nous allons appliquer directement l'architecture "orchestrateur/outil" que nous avons étudiée, en construisant un agent simple qui n'a qu'un seul "super-pouvoir" : son outil d'explication de code.

C'est votre premier pas dans la construction d'agents concrets qui vont, à terme, automatiser des parties significatives de votre travail.

1. La structure de notre agent "Code Explainer"

Avant de commencer, visualisons notre objectif. Nous allons créer un système en deux parties :

  1. Le Workflow "Outil" (Code Explainer Tool) : Un workflow dédié et spécialisé. Sa seule responsabilité est de recevoir un morceau de code, de le soumettre à un LLM avec un prompt spécifique pour obtenir une explication, et de retourner cette explication.
  2. Le Workflow "Orchestrateur" (Main Agent) : C'est le workflow principal avec lequel vous interagirez via un chat. Cet agent ne sait pas comment expliquer le code lui-même. Son rôle est de comprendre votre demande, de reconnaître qu'elle concerne l'explication de code, et de déléguer la tâche en appelant le workflow "Outil".

Cette séparation des responsabilités est un principe fondamental en ingénierie logicielle, et elle s'applique parfaitement à la conception d'agents robustes et maintenables.


2. Étape 1 : Construire l'outil "Code Explainer"

Commençons par créer l'outil spécialisé. Ce workflow est le cœur de la compétence de notre agent.

  1. Créez un nouveau workflow et nommez-le "Code Explainer Tool".
  2. Ajoutez un trigger Execute Workflow Trigger. C'est ce qui permet à ce workflow d'être appelé par un autre. Il agit comme un point d'entrée d'API interne à n8n.
  3. Connectez un nœud de modèle de chat (par exemple, OpenAI Chat Model ou Anthropic Chat Model).
  4. Rédigez un prompt système très spécifique. C'est ici que vous définissez l'expertise de l'outil. Par exemple :

    "Tu es un expert en analyse de code. Ta mission est d'expliquer le code qui te sera fourni, de manière claire et concise, comme tu le ferais à un autre ingénieur logiciel. Concentre-toi sur la logique, l'objectif du code et les points importants."

  5. Dans le champ "Message" du même nœud, insérez la variable qui contiendra le code à analyser. Le trigger Execute Workflow Trigger reçoit les données dans un objet JSON. Nous supposerons que notre agent enverra le code dans une propriété nommée code. La valeur du champ "Message" sera donc :
    {{ $json.body.code }}
    
  6. Sauvegardez et activez ce workflow. Il est maintenant prêt à être appelé.

Ce workflow est simple mais puissant. Il encapsule une seule tâche de manière très efficace.


3. Étape 2 : Construire l'agent orchestrateur

Maintenant, construisons l'agent principal qui saura comment utiliser notre nouvel outil.

  1. Créez un autre workflow et nommez-le "Main Code Explainer Agent".
  2. Ajoutez un trigger Chat Trigger. C'est l'interface de conversation.
  3. Ajoutez un nœud AI Agent. Nous allons maintenant configurer ses cinq composants.
    • Modèle de Chat : Connectez un nœud de modèle de chat. Pour l'orchestrateur, il est souvent judicieux de choisir un modèle performant (comme GPT-4o ou Claude 3 Sonnet), car il est responsable de la prise de décision.

    • Mémoire : Ajoutez un nœud Window Buffer Memory pour que l'agent se souvienne du contexte de la conversation.

    • Outil : C'est l'étape cruciale.

      • Connectez un nœud Execute Workflow à l'entrée Tool de l'agent.
      • Dans les paramètres du nœud Execute Workflow, sélectionnez le workflow "Code Explainer Tool" que vous venez de créer.
      • Dans la section "Source" des paramètres, choisissez "From Last Node's Output" et mappez l'entrée de l'outil. Nous devons dire à n8n comment passer le code de l'agent à l'outil. L'agent formulera sa demande dans un format JSON, nous pouvons utiliser une expression pour extraire le code : {{ $json.code }}. Le champ Key sera code (pour correspondre à ce que l'outil attend).
      • Très important : Allez dans l'onglet "Settings" du nœud Execute Workflow et rédigez une Description claire et précise. C'est ce texte que l'agent lira pour comprendre à quoi sert l'outil.

        "Utilise cet outil pour obtenir une explication détaillée d'un morceau de code. L'entrée de cet outil doit être uniquement le code source à analyser."

    • Prompt (System Message) : Dans le nœud AI Agent, ajoutez une propriété System Message. Définissez le rôle et les règles de l'agent.

      "Tu es un assistant IA spécialisé pour les développeurs. Ta seule et unique fonction est d'expliquer du code. Lorsque l'utilisateur te fournit du code et te demande de l'expliquer, tu dois impérativement utiliser l'outil Execute Workflow. Ne tente jamais d'expliquer le code par toi-même. Pour toute autre demande, réponds poliment que ce n'est pas dans tes capacités."

La vidéo suivante, bien qu'elle montre la création d'un agent email, illustre parfaitement la méthodologie que nous venons de suivre : créer un outil (un sous-agent), lui donner une description, et l'intégrer dans le prompt système d'un agent principal.

Construis ton ARMÉE d'Agents IA hyper facilement sur N8N !

Cette vidéo de Julien Sanson détaille la bonne pratique pour structurer un agent et ses outils.

Observez attentivement ces trois phases qui correspondent à ce que nous venons de faire : Définition du rôle de l'agent (segment) : Voyez comment le System Message est utilisé pour établir le rôle de l'agent et lister ses outils. Création et description de l'outil (segment) : Notez l'importance de la description de l'outil lui-même (Ce sous-agent est un expert...) et de la description de ses propres outils internes (Utilise cet outil pour envoyer un email). C'est cette hiérarchie de descriptions qui guide l'IA. Intégration de l'outil dans l'agent principal (segment) : C'est l'étape finale où l'agent principal est explicitement informé de l'existence et de la fonction de son nouvel outil.


4. Étape 3 : Tester notre agent

Votre système est maintenant prêt. Il est temps de le tester.

  1. Dans le workflow "Main Code Explainer Agent", cliquez sur le bouton "Chat" en bas de l'écran.
  2. Test 1 : Une demande hors-sujet.
    • Envoyez : Bonjour, comment vas-tu ?
    • L'agent devrait répondre quelque chose comme : "Bonjour ! Je suis un assistant spécialisé dans l'explication de code. Je ne peux pas répondre à cette demande."
  3. Test 2 : La tâche principale.
    • Envoyez : Peux-tu m'expliquer ce code s'il te plaît ? function somme(a, b) { return a + b; }
    • Observez le panneau d'exécution. Vous devriez voir le chemin vert passer par le Chat Trigger, l'AI Agent, puis activer le nœud Execute Workflow. Dans l'exécution du workflow "Code Explainer Tool", vous verrez qu'il a bien reçu le code et interrogé le LLM.
    • L'agent principal recevra ensuite l'explication de l'outil et vous la présentera dans le chat.

Cet exemple simple, où un agent utilise un seul outil, est très similaire dans son principe à l'agent de création de contact que vous pouvez voir dans la vidéo ci-dessous.

Créer un agent IA avec n8n — Formation complète

Dans cette courte démonstration, Shubham SHARMA montre un agent qui n'a qu'un outil : créer un contact Google.

Regardez ce passage de la création d'un contact. Tout comme cet agent comprend qu'il doit utiliser son outil "créer un contact" lorsqu'on lui donne un nom et un numéro, notre agent a compris qu'il devait utiliser son outil "Code Explainer" lorsqu'on lui a donné du code.

Le processus de test est itératif. Si l'agent ne se comporte pas comme prévu, la première chose à vérifier et à affiner est la description de l'outil et le prompt système de l'agent. C'est le cœur du "prompt engineering" appliqué aux agents.


Conclusion

Félicitations ! Vous venez de construire votre premier agent IA fonctionnel dans n8n. Ce n'est pas juste un chatbot, c'est un système capable de raisonner et d'utiliser un outil spécialisé pour accomplir une tâche.

Les points clés à retenir de cette leçon sont :

  • L'architecture Orchestrateur/Outil est une méthode robuste et scalable pour construire des agents.
  • Un "outil" peut être un workflow complet, déclenché par le nœud Execute Workflow.
  • La description de l'outil et le prompt système de l'agent sont les deux leviers les plus importants pour guider le comportement de l'agent. C'est la qualité de ces instructions qui détermine si l'agent utilisera ses outils correctement.
  • Le test et l'itération sont essentiels pour affiner le comportement de l'agent.

Maintenant que vous savez comment donner un super-pouvoir à un agent, la prochaine étape logique est de lui en donner plusieurs. Dans notre prochaine leçon, nous allons construire un agent avec deux outils distincts et le mettre dans une situation où il devra choisir le bon outil, ou même les enchaîner, pour résoudre un problème plus complexe.