Donner des mains à notre IA pour qu’elle puisse agir sur nos outils du quotidien.
📖 COURS
1) L'IA COMME ORCHESTRATEUR D'OUTILS (TOOL CALLING)
Le concept clé de ce module est le **"Tool Calling"** ou **"Function Calling"**. C'est une capacité avancée des grands modèles de langage (LLM) qui leur permet de comprendre quand une demande de l'utilisateur nécessite l'utilisation d'un outil externe.
Voici comment cela fonctionne :
1) **Déclaration des Outils** : Au début de la conversation, nous décrivons à l'IA les "outils" qu'elle a à sa disposition. Par exemple, nous lui disons : "Tu as un outil nommé `ajouter_contact_crm` qui prend un `nom`, un `email` et un `telephone` en paramètres."
2) **Détection d'Intention** : Quand l'utilisateur envoie un message (ex: "Peux-tu ajouter Jean Dupont, email jean@test.com, au CRM ?"), le LLM ne génère pas de réponse textuelle. Il reconnaît que cette demande correspond à l'outil `ajouter_contact_crm` et il extrait les paramètres nécessaires (`nom: "Jean Dupont"`, `email: "jean@test.com"`).
3) **Exécution de l'Outil** : Le LLM renvoie cette information structurée à n8n. N8n se charge alors d'exécuter la véritable action via le nœud approprié (ex: le nœud "HubSpot" ou "Airtable").
4) **Confirmation** : Une fois l'action terminée, n8n peut informer le LLM du résultat (ex: "Le contact a été ajouté avec succès").
5) **Réponse à l'Utilisateur** : Le LLM formule alors une réponse finale en langage naturel à l'utilisateur (ex: "C'est fait, j'ai bien ajouté Jean Dupont à votre CRM.").
2) POURQUOI EST-CE SI PUISSANT ?
Cette approche est beaucoup plus fiable que d'essayer de "deviner" l'intention de l'utilisateur avec des mots-clés. Le LLM utilise sa compréhension profonde du langage pour faire le lien entre une phrase et une action concrète, rendant les interactions beaucoup plus fluides et naturelles.
🗝️ POINTS CLÉS
1) TOOL CALLING
- C'est la capacité de l'IA à reconnaître quand utiliser un outil externe et à extraire les informations nécessaires pour le faire.
2) DESCRIPTION DES OUTILS
- Le succès de cette technique repose sur une description claire et précise des outils disponibles pour l'IA.
3) N8N COMME "MAINS" DE L'IA
- n8n est la plateforme qui exécute les actions réelles (appels API vers le CRM, Notion, etc.) demandées par l'IA.
4) AUTOMATISATION STRUCTURÉE
- Le Tool Calling apporte une fiabilité et une structure robustes à l'automatisation pilotée par le langage naturel.
💪 PRATIQUE
PRÉREQUIS
- Votre workflow n8n fonctionnel.
- Vos identifiants OpenAI.
- **Un compte Notion** : Créez une nouvelle base de données simple dans Notion avec deux colonnes : `Tâche` (type Titre) and `Statut` (type Statut).
- **Une clé d'intégration Notion** : Allez sur [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations) pour créer une nouvelle intégration. Notez le "Internal Integration Token".
- **Partagez la base de données** : Sur votre base de données Notion, cliquez sur les trois points `...` -> "Add connections" et ajoutez votre intégration pour lui donner l'accès.
1) AJOUTER LES IDENTIFIANTS NOTION DANS N8N
1) Allez dans **"Credentials"** -> **"Add Credential"**.
2) Cherchez **"Notion API"** et sélectionnez-le.
3) Donnez-lui un nom et collez votre "Internal Integration Token". Sauvegardez.
2) CONFIGURER LE NŒUD OPENAI POUR LE TOOL CALLING
1) Dans votre workflow, ajoutez un nouveau nœud **"OpenAI Chat"**. Renommez-le "Détection d'Action".
2) **Ajouter les Outils (Tools)**:
- En bas des paramètres du nœud, cliquez sur **"Add Tool"**.
- **Name**: `creer_tache_notion`
- **Description**: `Utilise cet outil pour créer une nouvelle tâche dans Notion. Tu dois fournir une description de la tâche.`
- Dans la section **"Parameters"**, cliquez sur **"Add Parameter"**:
- **Name**: `description_tache`
- **Type**: `String`
- **Description**: `La description claire et complète de la tâche à créer.`
- **Required**: Cochez cette case.
3) ROUTER ET EXÉCUTER L'ACTION
1) Ajoutez un nœud **IF** après le nœud "Détection d'Action".
2) Ce nœud va vérifier si l'IA a décidé d'utiliser notre outil.
- **Value 1**: `{{$json.tool_calls[0].function.name}}`
- **Operation**: `String` -> `Exists`.
3) Sur la branche `true`, ajoutez un nœud **Notion**.
4) Configurez-le :
- **Credential**: Vos identifiants Notion.
- **Resource**: `Database/Page`, **Operation**: `Create`.
- **Database ID**: Sélectionnez votre base de données dans la liste.
- Pour la propriété `Tâche` (Titre), insérez la description extraite par l'IA : `{{JSON.parse($json.tool_calls[0].function.arguments).description_tache}}`
5) Après le nœud Notion, ajoutez un nœud **HTTP Request** pour envoyer un message de confirmation à l'utilisateur.
❓ FAQ
1) PUIS-JE AJOUTER D'AUTRES OUTILS COMME GOOGLE CALENDAR ?
Absolument ! Le processus est identique :
1) Ajoutez les credentials pour Google Calendar dans n8n.
2) Dans le nœud "Détection d'Action", décrivez un nouvel outil (ex: `creer_evenement_calendrier`) avec ses propres paramètres (`titre`, `date`, `heure`).
3) Dans le nœud IF qui route les actions, ajoutez une condition pour cet outil.
4) Sur la branche correspondante, ajoutez le nœud **Google Calendar**.
2) QUE SE PASSE-T-IL SI L'UTILISATEUR NE DONNE PAS TOUTES LES INFOS ?
Les LLM récents (comme GPT-4) sont capables de poser des questions de suivi. Si vous décrivez bien vos paramètres, et que l'utilisateur dit juste "Ajoute un RDV au calendrier", l'IA peut répondre automatiquement "Bien sûr, pour quel jour et quelle heure ?".
3) COMMENT PUIS-JE GÉRER DES ACTIONS PLUS COMPLEXES, COMME LA MODIFICATION ?
Vous pouvez définir des outils distincts pour chaque action (`modifier_tache_notion`, `supprimer_contact_crm`, etc.). Chaque outil aura ses propres paramètres (par exemple, `modifier_tache_notion` pourrait nécessiter un `id_tache` et un `nouveau_statut`).
🧠 QUIZ
1) QUEL EST LE RÔLE DE L'IA DANS LE "TOOL CALLING" ?
* a) Exécuter directement l'action dans l'outil externe.
* b) Détecter l'intention de l'utilisateur et extraire les paramètres nécessaires pour appeler un outil.
* c) Stocker les données de l'utilisateur.
* d) Envoyer le message de confirmation.
...
Réponse : B
2) QUEL NŒUD N8N EST RESPONSABLE DE L'EXÉCUTION RÉELLE DE L'ACTION ?
* a) Le nœud OpenAI Chat.
* b) Le nœud IF.
* c) Le nœud spécifique à l'application (ex: Notion, Google Calendar).
* d) Le nœud Webhook.
...
Réponse : C
3) QUE FAUT-IL FOURNIR DANS LA CONFIGURATION DU NŒUD OPENAI POUR LUI APPRENDRE À UTILISER UN OUTIL ?
* a) Uniquement le nom de l'outil.
* b) Le nom de l'outil, une description de ce qu'il fait, et les paramètres qu'il attend.
* c) L'URL de l'API de l'outil.
* d) Un exemple de code.
...
Réponse : B