Sous le capot : anatomie d'un appel d'outil

Choisir → appeler → lire → synthétiser : la boucle que Claude déroule à chaque connecteur. La comprendre, c'est savoir débugger.

🧠 Concept — Les 4 temps du moteur

Quand tu demandes « prépare mon brief de réunion », Claude ne « sait » pas magiquement : il déroule une boucle en 4 temps.

Choisir : parmi tous les outils branchés, lesquels sont pertinents ? (calendrier d'abord, puis mails, puis Drive)
Appeler : il invoque chaque outil avec des paramètres précis (une requête de recherche, une plage de dates).
Lire : il analyse les résultats bruts renvoyés par le serveur.
Synthétiser : il assemble le tout en réponse — ou décide qu'il lui faut un appel de plus.

Chaque résultat peut déclencher un nouvel appel : c'est la boucle d'agent du Module 0, version branchée.

Trace d'exécution annotée (pseudo-trace lisible)

TOI > "Prépare le brief de ma réunion de 14h"

[1. CHOISIR]  outils pertinents : google_calendar, gmail, drive
[2. APPELER]  google_calendar.list_events(date="aujourd'hui", heure="14:00")
[3. LIRE]     → "Comité déploiement — Hub Annecy" · 4 participants
              → l'agent découvre le SUJET : il peut affiner la suite

[2. APPELER]  gmail.search(query="Hub Annecy", periode="14 derniers jours")
[3. LIRE]     → 6 mails · dont 1 alerte : "retard raccordement Enedis"
[2. APPELER]  drive.search(query="Annecy comité déploiement")
[3. LIRE]     → "Business case Annecy v3.xlsx" · "CR visite foncier.pdf"

[4. SYNTHÉTISER]
   Brief : ordre du jour probable, point chaud (retard Enedis),
   2 docs à relire, 3 questions à poser en séance.

>> Note : à l'étape [3], si la recherche Gmail avait renvoyé 0 résultat,
>> l'agent aurait retenté avec d'autres mots-clés ("Annecy", "raccordement")
>> — ou t'aurait dit qu'il n'a rien trouvé. C'est LÀ que tu peux l'aider.

💡 Réflexe pro — Comprendre la trace = savoir débugger

Quand « il n'a pas trouvé », ce n'est presque jamais mystique. Trois suspects, dans l'ordre :

Les mots-clés : l'outil a cherché « Hub Annecy » mais le thread s'appelle « Station 74 ». → Reformule, donne les termes exacts.
La période : la recherche portait sur 14 jours, la décision date de mars. → Précise la plage de dates.
Les droits : Claude ne voit que ce que TON compte voit. Canal privé, dossier non partagé = invisible. → Vérifie tes accès.

Demande-lui « montre-moi quels outils tu as appelés et avec quels paramètres » : la trace est ta jauge de diagnostic.

🎯 Quiz de debugging : la panne est où ?

0/4 répondue · 0 juste

1.« Résume les échanges Slack sur la panne de Bordeaux » → Claude répond qu'il ne trouve rien. Le thread existe, dans un canal privé où tu n'es pas membre. Le problème ?

2.« Retrouve la décision sur les tarifs roaming » → rien. Le doc existe, il s'appelle « Pricing partenaires eMSP Q2 ». Ton meilleur coup ?

3.« Analyse les tickets Intercom sur les échecs de paiement » → Claude ne remonte que 3 tickets récents alors qu'il y en a eu 40 sur le trimestre. L'hypothèse la plus probable ?

4.Réflexe universel quand un appel d'outil déçoit ?

← Précédent Checkpoint du module 🏆 →