Référence des outils

Cette page est une référence pour les outils qu'Anthropic fournit et les propriétés optionnelles que vous pouvez définir sur n'importe quelle définition d'outil. Pour une introduction conceptuelle à l'utilisation des outils, voir Utilisation des outils avec Claude. Pour des conseils sur la mise en œuvre de l'utilisation des outils dans votre application, voir Définir les 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 où Anthropic définit le schéma mais 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.

Versioning 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 du modèle de l'outil change. Les versions plus anciennes restent disponibles pour que les intégrations existantes continuent à 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 un filtrage dynamique du contenu par rapport à leurs prédécesseurs. code_execution_20260120 ajoute l'appel d'outils programmatique depuis le bac à sable. Dans chaque cas, les versions nouvelle et ancienne sont actuelles ; celle que vous utilisez dépend de si vous avez besoin de la nouvelle capacité.
• Basée sur le modèle : text_editor_20250728 est pour les modèles Claude 4 et text_editor_20250124 est pour les 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é : code_execution_20250522 prend en charge uniquement Python. code_execution_20250825 ajoute Bash et les opérations sur fichiers.

Le type mcp_toolset n'est pas versionné par date ; le versioning est porté dans 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 comment 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 n'importe quelle combinaison de :

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

defer_loading et mise en cache des prompts

Les outils avec defer_loading: true sont supprimés de la section des outils rendus avant le calcul de la clé de cache. Ils n'apparaissent pas du tout dans le préfixe du prompt système. Lorsque la recherche d'outils découvre un outil différé et retourne une 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 d'arrêt cache_control, voir les conseils de mise en cache des prompts de l'outil de recherche d'outils.