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 tout outil défini 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.



Versionnage 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 anciennes versions restent disponibles afin que les intégrations existantes continuent de fonctionner.

Lorsqu'un outil possède plusieurs versions actives, la relation entre elles varie :

• Indexées par capacité : web_search_20260209 et web_fetch_20260209 ajoutent un filtrage dynamique du contenu par rapport à leurs prédécesseurs ; web_fetch_20260309 ajoute une option de contournement du cache ; web_search_20260318 et web_fetch_20260318 ajoutent un contrôle d'inclusion de la réponse. code_execution_20260120 ajoute l'appel d'outils programmatique depuis le bac à sable ; code_execution_20260521 divulgue la limite de temps par cellule dans la description de l'outil. Dans chaque cas, la nouvelle version et l'ancienne sont toutes deux actuelles ; celle que vous utilisez dépend de votre besoin de la nouvelle capacité.
• Indexées par modèle : text_editor_20250728 est destiné aux modèles Claude 4 et text_editor_20250124 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 fichiers.

Le type mcp_toolset n'est pas versionné par date ; le versionnage est porté 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 manière 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, 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 à appeler l'outil uniquement depuis 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 d'outils rendue avant le calcul de la clé de cache. 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 à cet endroit dans le corps de la conversation, et non 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 entre le tour où l'outil est découvert et le tour où il est appelé.

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