Corriger vos propres outils
Sur cette page
Objectifs
À l’issue de cette leçon, vous serez capable de :
- Associer chaque symptôme de votre agent à la correction qui lui convient
- Savoir où chercher pour aller plus loin
Le bon remède pour chaque symptôme
| Symptôme | Correction | Leçon |
|---|---|---|
| Claude demande un outil, puis ne répond jamais avec le résultat | Un tool_result par tool_use, avec le bon tool_use_id, et une boucle tant que stop_reason vaut "tool_use" | 3 |
tool_choice forcé renvoie une erreur 400 | auto, consigne explicite, strict: true, vérification qu’un appel a eu lieu | 5 |
| Votre parseur JSON casse sur les réponses de Claude | Sorties JSON (output_config.format) | 6 |
| Claude choisit le mauvais outil, ou multiplie les appels pour un seul fait | Descriptions de trois ou quatre phrases, regroupement des outils, évaluation avant/après | 7 |
| Votre backend rejette des appels produits par Claude | strict: true, schéma généré depuis le validateur | 8 |
| L’utilisateur attend la somme de plusieurs recherches | Appels parallèles, résultats dans un seul message | 9 |
| L’écran reste figé pendant que Claude travaille | Streaming, statut affiché au content_block_start | 10 |
| Les calculs sur des fichiers sont faux ou approximatifs | Outil d’exécution de code et Files API | 11 |
| Les réponses sont périmées ou sans source | Outil de recherche web, allowed_domains, citations | 12 |
| Un logiciel indispensable n’a aucune API | Computer use, dans un environnement isolé | 13 |
| La facture grimpe à chaque appel d’outil | Mesure de usage.input_tokens, appel programmatique, mise en cache des outils | 14 |
Retournez à votre code et commencez par le problème qui gêne le plus vos utilisateurs, ou vous-même ; appliquez la correction de la leçon correspondante. Les leçons restent disponibles pendant que vous travaillez.
À vous de jouer
Votre plan de correction. Relevez les trois symptômes qui gênent le plus les utilisateurs de votre agent. Pour chacun, notez la ligne du tableau qui lui correspond, la mesure qui prouvera l’amélioration (taux de bons choix d’outil, rejets du backend, jetons d’entrée, délai avant le premier affichage), et sa valeur actuelle. Appliquez une correction à la fois, et remesurez après chacune.
Pour aller plus loin
- Un problème que le cours n’a pas traité : la page Troubleshooting tool use associe chaque symptôme à sa cause probable et à sa correction.
- Les autres outils fournis par Anthropic, au-delà des trois du cours (récupération web, mémoire, éditeur de texte, recherche d’outils…) : la référence des outils.
- Des exemples de code : le Claude Cookbook.
- Connecter Claude à des services sans définir chaque outil vous-même : le cours Introduction au MCP.
- Un agent hébergé, avec ses outils et sa mémoire : les agents gérés, dans Claude Platform 101.
Sources officielles : Tool use overview · Troubleshooting tool use · Tool reference · cours officiel Tool use with the Messages API
Points clés à retenir
- Chaque symptôme a sa correction : partez du problème qui gêne le plus
- La documentation de dépannage et la référence des outils prolongent le cours
- Pour aller plus loin : le MCP et les agents gérés