Claude Tool Use : Code Execution, Text Editor et Web Search

Qu'est-ce que le Tool Use ?

Le Tool Use (ou function calling) est la capacité de Claude à utiliser des outils externes pendant une conversation. Au lieu de simplement répondre avec du texte, Claude peut :

1. →Décider qu'un outil est nécessaire pour répondre
2. →Générer les paramètres d'appel de l'outil au format JSON
3. →Recevoir le résultat de l'exécution de l'outil
4. →Utiliser ce résultat pour formuler une réponse complète

Le Flux Tool Use

Utilisateur → Claude (réfléchit) → Appel d'outil (JSON)
                                        ↓
                                   Votre code exécute l'outil
                                        ↓
Résultat → Claude (utilise le résultat) → Réponse finale

Outils Intégrés (Built-in Tools)

Claude dispose de trois outils intégrés qui ne nécessitent aucune implémentation de votre part.

1. Code Execution (Sandbox Python)

L'outil Code Execution permet à Claude d'exécuter du code Python dans un environnement sandbox sécurisé. Idéal pour les calculs, l'analyse de données et la génération de graphiques.

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=4096,
    tools=[{
        "type": "code_execution"
    }],
    messages=[{
        "role": "user",
        "content": "Calcule la moyenne, médiane et écart-type de ces données : [23, 45, 67, 12, 89, 34, 56, 78, 91, 43]"
    }]
)

Cas d'usage : Calculs mathématiques, analyse statistique, génération de graphiques matplotlib, manipulation de données pandas.

Limites : Sandbox isolée, pas d'accès réseau, pas de persistance entre appels, bibliothèques limitées (numpy, pandas, matplotlib disponibles).

2. Text Editor

L'outil Text Editor permet à Claude de lire, créer et modifier des fichiers. Utilisé principalement dans Claude Code et les agents de développement.

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=4096,
    tools=[{
        "type": "text_editor_20250429",
        "name": "text_editor"
    }],
    messages=[{
        "role": "user",
        "content": "Lis le fichier config.json et modifie le port de 3000 à 8080."
    }]
)

Commandes disponibles :

3. Web Search

L'outil Web Search permet à Claude de rechercher des informations actualisées sur le web.

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=4096,
    tools=[{
        "type": "web_search"
    }],
    messages=[{
        "role": "user",
        "content": "Quelles sont les dernières nouvelles sur l'IA en mars 2026 ?"
    }]
)

Cas d'usage : Informations actualisées, vérification de faits, recherche de documentation, prix et disponibilité de produits.

Outils Custom (Function Calling)

Les outils custom vous permettent de connecter Claude à n'importe quelle API ou fonction de votre application.

Définir un Outil Custom

import anthropic
import json

client = anthropic.Anthropic()

# Définition de l'outil
tools = [{
    "name": "get_weather",
    "description": "Récupère la météo actuelle pour une ville donnée. Utilise cet outil quand l'utilisateur demande la météo.",
    "input_schema": {
        "type": "object",
        "properties": {
            "city": {
                "type": "string",
                "description": "Le nom de la ville (ex: 'Paris', 'Lyon')"
            },
            "units": {
                "type": "string",
                "enum": ["celsius", "fahrenheit"],
                "description": "Unité de température"
            }
        },
        "required": ["city"]
    }
}]

# Première requête
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    tools=tools,
    messages=[{
        "role": "user",
        "content": "Quel temps fait-il à Paris ?"
    }]
)

Le Cycle Complet Tool Use

Le Tool Use fonctionne en boucle. Voici le pattern complet :

def run_tool_loop(user_message, tools, tool_handlers):
    """Exécute une boucle tool use complète."""
    messages = [{"role": "user", "content": user_message}]
    
    while True:
        response = client.messages.create(
            model="claude-sonnet-4-20250514",
            max_tokens=4096,
            tools=tools,
            messages=messages
        )
        
        # Si Claude a fini (pas d'appel d'outil)
        if response.stop_reason == "end_turn":
            return response.content[0].text
        
        # Traiter les appels d'outils
        messages.append({"role": "assistant", "content": response.content})
        
        tool_results = []
        for block in response.content:
            if block.type == "tool_use":
                # Exécuter l'outil
                handler = tool_handlers[block.name]
                result = handler(**block.input)
                
                tool_results.append({
                    "type": "tool_result",
                    "tool_use_id": block.id,
                    "content": json.dumps(result)
                })
        
        messages.append({"role": "user", "content": tool_results})

# Handlers d'outils
def get_weather(city, units="celsius"):
    # Appel à une vraie API météo
    return {"city": city, "temp": 18, "condition": "Ensoleillé"}

# Exécution
result = run_tool_loop(
    "Quel temps fait-il à Paris et Lyon ?",
    tools=tools,
    tool_handlers={"get_weather": get_weather}
)

Outils en Parallèle

Claude peut appeler plusieurs outils simultanément quand il a besoin de plusieurs informations indépendantes :

# Claude peut générer plusieurs tool_use blocks dans une seule réponse :
# [
#   {"type": "tool_use", "name": "get_weather", "input": {"city": "Paris"}},
#   {"type": "tool_use", "name": "get_weather", "input": {"city": "Lyon"}}
# ]

Patterns Avancés

Forcer l'Utilisation d'un Outil

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "get_weather"},  # Force cet outil
    messages=[{"role": "user", "content": "Paris"}]
)

Extraction Structurée via Tool Use

Un pattern puissant : utiliser le Tool Use pour forcer Claude à retourner des données structurées.

tools = [{
    "name": "extract_contact",
    "description": "Extrait les informations de contact d'un texte.",
    "input_schema": {
        "type": "object",
        "properties": {
            "name": {"type": "string"},
            "email": {"type": "string"},
            "phone": {"type": "string"},
            "company": {"type": "string"}
        },
        "required": ["name"]
    }
}]

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    tools=tools,
    tool_choice={"type": "tool", "name": "extract_contact"},
    messages=[{
        "role": "user",
        "content": "Marie Dupont est directrice chez TechCorp. Contactez-la à marie@techcorp.fr ou au 06 12 34 56 78."
    }]
)

# Résultat structuré garanti :
# {"name": "Marie Dupont", "email": "marie@techcorp.fr", "phone": "06 12 34 56 78", "company": "TechCorp"}

Bonnes Pratiques

Écrire de Bonnes Descriptions d'Outils

La description d'un outil est critique — c'est ce que Claude utilise pour décider quand et comment l'utiliser.

Checklist des Bonnes Pratiques

1. →Descriptions détaillées — Expliquez quand et pourquoi utiliser l'outil
2. →Paramètres documentés — Chaque paramètre doit avoir une description claire
3. →Validation côté serveur — Ne faites jamais confiance aux paramètres sans validation
4. →Gestion des erreurs — Retournez des messages d'erreur clairs dans les tool_results
5. →Limite le nombre d'outils — 10-20 outils maximum pour une performance optimale
6. →Noms explicites — search_products plutôt que search ou sp

Erreurs Courantes

Pour aller plus loin

• →Agent-Computer Interface (ACI) : concevoir des outils pour agents — Principes de conception d'outils optimisés pour les agents IA
• →MCP avancé : transports et patterns — Explorez les patterns avancés du Model Context Protocol