---
title: Dépannage de l'utilisation d'outils
url: https://platform.claude.com/docs/fr/agents-and-tools/tool-use/troubleshooting-tool-use
description: Corrigez les erreurs d'utilisation d'outils les plus courantes grâce à des tableaux de diagnostic symptôme-correctif.
---

Trouvez le symptôme ou l’erreur que vous constatez, puis appliquez le correctif indiqué.

## Claude appelle le mauvais outil

| Symptôme | Cause probable | Correctif |
| ----- | ----- | ----- |
| Claude appelle l’outil A alors que vous vouliez l’outil B | Ambiguïté de la description | Affinez les descriptions. Différenciez les outils selon QUAND les utiliser, et pas seulement selon CE qu’ils font. Consultez [Définir des outils](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/define-tools). |
| Claude n’appelle jamais votre outil | Collision de noms d’outils ou schéma trop générique | Vérifiez l’absence de noms en double dans votre liste d’outils. Ajoutez `input_examples` pour rendre l’usage prévu concret. |
| Claude effectue des appels avec des types de paramètres incorrects | Schéma ambigu | Ajoutez `strict: true` (si votre schéma fait partie du sous-ensemble pris en charge) ou ajoutez `input_examples`. |

## Claude invente des paramètres d’outil

| Symptôme | Cause probable | Correctif |
| ----- | ----- | ----- |
| Paramètre qui n’existe pas dans votre schéma | Surgénération du modèle sans mode strict | Ajoutez `strict: true` si votre schéma fait partie du [sous-ensemble pris en charge](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/strict-tool-use). |
| Valeurs de paramètres en dehors de votre enum | Mode strict absent ou enum trop grand | Réduisez l’enum ou ajoutez `input_examples` montrant les choix valides. |

## Les appels d’outils parallèles ne fonctionnent pas

| Symptôme | Cause probable | Correctif |
| ----- | ----- | ----- |
| Claude appelle les outils séquentiellement alors que le parallélisme serait préférable | Formatage de l’historique des messages | Envoyez plusieurs blocs `tool_result` dans UN SEUL message utilisateur, et non un par tour. Consultez [Utilisation d’outils en parallèle](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/parallel-tool-use). |
| `disable_parallel_tool_use` semble ignoré | Défini trop tard dans la conversation | Définissez-le sur la requête qui renvoie `tool_use`. Le définir sur une requête ultérieure n’a aucun effet sur les appels d’outils précédents. |

## Le cache ne cesse de s’invalider

| Symptôme | Cause probable | Correctif |
| ----- | ----- | ----- |
| Chaque requête est un échec de cache | `tool_choice`, la configuration de réflexion ou `output_config.effort` varient d’une requête à l’autre | Gardez `tool_choice` stable ou placez le point d’arrêt `cache_control` avant le point de variation ; maintenez la configuration de réflexion et le niveau d’effort constants pendant toute la durée d’une conversation mise en cache. Consultez [Utilisation d’outils avec la mise en cache des prompts](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/tool-use-with-prompt-caching) et [Réflexion et mise en cache des prompts](https://platform.claude.com/docs/fr/build-with-claude/thinking#thinking-and-prompt-caching). |
| L’ajout d’un outil en cours de conversation casse le cache | Outil ajouté en tête du tableau des outils | Déclarez l’outil avec `defer_loading: true` dès la première requête et laissez la recherche d’outils le charger en ligne, au lieu de l’ajouter au tableau plus tard. |

## Erreurs au moment de la requête

La colonne Erreur affiche une partie de chaque message, et `...` représente un texte qui varie.

| Erreur | Cause | Correctif |
| ----- | ----- | ----- |
| `tool_use ids were found without tool_result blocks immediately after` | `tool_result` manquant pour certains identifiants `tool_use`, ou `tool_result` n’est pas le premier bloc de contenu du message utilisateur | Renvoyez un `tool_result` pour chaque bloc `tool_use` de la réponse de l’assistant. Placez les blocs `tool_result` avant tout texte. Consultez [Gérer les appels d’outils](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/handle-tool-calls) et [Utilisation d’outils en parallèle](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/parallel-tool-use). |
| `was found without a corresponding ... block` | La requête de suivi empêche un outil serveur en attente de s’exécuter | Consultez [Un appel d’outil serveur n’a pas de bloc de résultat](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/troubleshooting-tool-use#a-server-tool-call-has-no-result-block). |
| `Unsupported regex feature in pattern field: ...` | Le `pattern` d’un outil strict utilise une fonctionnalité d’expression régulière que le mode strict ne peut pas compiler, comme une référence arrière, une limite de mot ou une grande plage `{n,m}` | Simplifiez le motif. Consultez [Limitations de JSON Schema](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs#json-schema-limitations). |
| `Invalid regex in pattern field: ...` | Le `pattern` d’un outil strict contient une assertion avant (lookahead), une assertion arrière (lookbehind) ou une erreur de syntaxe | Supprimez toute assertion avant ou arrière et corrigez les éventuelles erreurs de syntaxe. Consultez [Limitations de JSON Schema](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs#json-schema-limitations). |
| `All tools have defer_loading: true` | Aucun outil visible pour le modèle | Au moins un outil doit être chargé immédiatement. L’outil de recherche d’outils lui-même ne doit jamais avoir `defer_loading: true`. |

### Un appel d’outil serveur n’a pas de bloc de résultat

Un [outil serveur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/server-tools) attend toujours de s’exécuter lorsque son bloc `server_tool_use` ou `mcp_tool_use` n’a pas de bloc de résultat. L’erreur `was found without a corresponding ... block` signifie que la requête de suivi empêche l’outil en attente de s’exécuter. Le message d’erreur et le `stop_reason` précédent en indiquent la raison. Appliquez le premier cas correspondant :

* **Le message se termine par ``but no `<name>` tool was provided`` ou `is not available after the last message` :** Ici, `<name>` est le nom de l’outil, par exemple `web_search`. La requête ne définit plus l’outil. Envoyez le même tableau `tools` qu’auparavant, ainsi que les mêmes `mcp_servers` pour un outil MCP.
* **Le `stop_reason` précédent était `tool_use` :** Votre message utilisateur contenait du contenu après les blocs `tool_result`. Envoyez uniquement les blocs `tool_result`, un pour chaque bloc `tool_use` client.
* **Le `stop_reason` précédent était `pause_turn` :** Vous avez ajouté un message utilisateur. Supprimez-le afin que la requête se termine par la réponse mise en pause sous forme de message `assistant`.

Pour les étapes complètes, consultez [Lorsqu’un outil serveur est encore en attente](https://platform.claude.com/docs/fr/build-with-claude/handling-stop-reasons#when-a-server-tool-is-still-waiting) et la [raison d’arrêt `pause_turn`](https://platform.claude.com/docs/fr/build-with-claude/handling-stop-reasons#pause-turn).

## Erreur : les blocs de réflexion ne peuvent pas être modifiés

Si une requête échoue avec une erreur 400 `invalid_request_error` dont le message contient `` `thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modified `` lors de la poursuite d’une conversation après un appel d’outil, votre application modifie les blocs de réflexion de l’assistant avant de les renvoyer. Renvoyez l’intégralité du message de l’assistant sans modification, puis ajoutez votre `tool_result`.

Consultez [Les blocs de réflexion ne peuvent pas être modifiés](https://platform.claude.com/docs/fr/api/errors#thinking-blocks-cannot-be-modified) pour l’erreur complète et les étapes de correction.

## Claude signale les résultats d’outils comme une injection de prompt

| Symptôme | Cause probable | Correctif |
| ----- | ----- | ----- |
| Claude refuse d’agir sur un résultat d’outil, ou demande à l’utilisateur de confirmer des instructions qui en proviennent | Vos propres instructions sont transmises à l’intérieur du contenu `tool_result` | Claude est entraîné à traiter les instructions contenues dans les résultats d’outils comme du contenu tiers potentiellement non fiable. Sortez vos instructions du résultat d’outil : envoyez-les dans un tour `user` après le bloc `tool_result`, ou, sur les modèles pris en charge, dans un [message système en cours de conversation](https://platform.claude.com/docs/fr/build-with-claude/mid-conversation-system-messages). Limitez le résultat d’outil aux seules données. Consultez [Atténuer les jailbreaks et les injections de prompt](https://platform.claude.com/docs/fr/test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks#indirect-prompt-injection). |

## Différences d’échappement JSON entre les versions de modèles

| Symptôme | Cause | Correctif |
| ----- | ----- | ----- |
| La comparaison de chaînes sur les entrées d’outils échoue avec les modèles plus récents | L’échappement Unicode et des barres obliques diffère selon les versions de modèle | Analysez avec `json.loads()` ou `JSON.parse()`. N’effectuez jamais de correspondance de chaînes brutes sur une entrée sérialisée. |

## Étapes suivantes

<CardGroup cols={3}>
  <Card title="Définir des outils" href="https://platform.claude.com/docs/fr/agents-and-tools/tool-use/define-tools">
    Rédigez des schémas et des descriptions qui orientent Claude vers le bon outil.
  </Card>

  <Card title="Gérer les appels d’outils" href="https://platform.claude.com/docs/fr/agents-and-tools/tool-use/handle-tool-calls">
    Exécutez des outils et renvoyez les résultats dans le format de message requis.
  </Card>

  <Card title="Référence des outils" href="https://platform.claude.com/docs/fr/agents-and-tools/tool-use/tool-reference">
    Répertoire complet des outils fournis par Anthropic et de leurs chaînes de version.
  </Card>
</CardGroup>
