Référence des outils

Cette page est une référence pour les outils fournis par Anthropic et les propriétés optionnelles que vous pouvez définir sur toute définition d'outil. Pour une introduction conceptuelle à l'utilisation d'outils, consultez Utilisation d'outils avec Claude. Pour des conseils sur l'implémentation de l'utilisation d'outils dans votre application, consultez Définir des outils.



Outils fournis par Anthropic

Anthropic fournit deux types d'outils : les outils serveur qui s'exécutent sur l'infrastructure d'Anthropic, et les outils client pour lesquels Anthropic définit le schéma mais dont votre application gère l'exécution. Les deux types apparaissent dans le tableau tools de votre requête aux côtés de tous les outils définis par l'utilisateur.

Pour la compatibilité des modèles, consultez la page de chaque outil. Les modèles pris en charge varient selon l'outil et la version de l'outil.



Gestion des versions des outils

La plupart des outils fournis par Anthropic portent un suffixe _YYYYMMDD dans la chaîne type. Une nouvelle version est publiée lorsque le comportement, le schéma ou la prise en charge des modèles de l'outil change. Les versions plus anciennes restent disponibles afin que les intégrations existantes continuent de fonctionner.

Lorsqu'un outil a plusieurs versions actives, la relation entre elles varie :

• Basée sur les capacités : web_search_20260209 et web_fetch_20260209 ajoutent le filtrage de contenu dynamique par rapport à leurs prédécesseurs ; web_fetch_20260309 ajoute une option de contournement du cache ; web_search_20260318 et web_fetch_20260318 ajoutent le contrôle de l'inclusion des réponses. code_execution_20260120 ajoute l'appel d'outils programmatique depuis l'intérieur du bac à sable ; code_execution_20260521 divulgue la limite de temps par cellule dans la description de l'outil. Dans chaque cas, les nouvelles et anciennes versions sont toutes deux actuelles ; celle que vous utilisez dépend de votre besoin de la nouvelle capacité.
• Basée sur le modèle : text_editor_20250728 est destiné à Claude 4 et aux modèles ultérieurs et text_editor_20250124 est destiné aux modèles antérieurs. La version que vous utilisez dépend du modèle que vous ciblez.
• Variante, pas version : tool_search_tool_regex_20251119 et tool_search_tool_bm25_20251119 sont deux algorithmes de recherche publiés ensemble. Aucun ne remplace l'autre.
• Héritée : code_execution_20250522 ne prend en charge que Python. code_execution_20250825 ajoute Bash et les opérations sur les fichiers.

Le type mcp_toolset n'est pas versionné par date ; la gestion des versions est portée par l'en-tête anthropic-beta à la place.



Propriétés de définition d'outil

Chaque outil du tableau tools, y compris les outils définis par l'utilisateur, accepte des propriétés optionnelles qui contrôlent la façon dont l'outil est chargé, qui peut l'appeler et comment ses entrées sont validées. Ces propriétés se composent : vous pouvez définir defer_loading et cache_control et strict sur le même outil.



Valeurs de allowed_callers

allowed_callers est un tableau qui accepte toute combinaison de :

"code_execution_20260120" et "code_execution_20260521" sont tous deux acceptés dans allowed_callers et sont interchangeables : une requête utilisant l'une ou l'autre version de l'outil d'exécution de code satisfait les outils qui listent l'un ou l'autre appelant. Les blocs de réponse étiquettent toujours l'appelant comme code_execution_20260120, quelle que soit la version déclarée par la requête.

Omettre "direct" du tableau (par exemple, "allowed_callers": ["code_execution_20260120"]) guide Claude pour qu'il n'appelle l'outil que depuis l'intérieur de l'exécution de code. Le bloc tool_use de la réponse inclut un champ caller qui identifie quel appelant a appelé l'outil. Consultez Appel d'outils programmatique pour le traitement complet, y compris la forme de la réponse caller et le comportement en cas d'erreur.



defer_loading et mise en cache des prompts

Les outils avec defer_loading: true sont retirés de la section des outils rendue avant que la clé de cache ne soit calculée. Ils n'apparaissent pas du tout dans le préfixe de l'invite système. Lorsque la recherche d'outils découvre un outil différé et renvoie un tool_reference pour celui-ci, la définition complète de l'outil est développée en ligne à ce point du corps de la conversation, pas dans le préfixe.

Cela signifie que defer_loading: true préserve votre cache de prompt. Vous pouvez ajouter des outils différés à une requête sans invalider une entrée de cache existante, et le cache reste valide à travers le tour où l'outil est découvert et le tour où il est appelé.

Pour savoir comment combiner defer_loading avec les points de rupture cache_control, consultez les conseils de mise en cache des prompts de l'outil de recherche d'outils.