Quiz : utilisation des outils avec Claude

On vérifie le champ stop_reason de la réponse. Quand Claude veut appeler un outil, ce champ vaut "tool_use". Si la valeur est différente (par exemple "end_turn"), Claude a terminé et fournit sa réponse finale.

if response.stop_reason == "tool_use":
    # Claude veut utiliser un outil
    tool_results = run_tools(response)

C’est le champ tool_use_id. Chaque bloc tool_use à un identifiant unique, et le bloc tool_result correspondant doit utiliser exactement le même identifiant dans son champ tool_use_id.

tool_result_block = {
    "type": "tool_result",
    "tool_use_id": tool_request.id,  # Doit correspondre a l'id du tool_use
    "content": json.dumps(result),
    "is_error": False
}

Oui, il faut toujours renvoyer un bloc de résultat, même en cas d’erreur. On utilise le champ is_error: True pour signaler l’échec. Claude pourra alors adapter sa réponse (retenter, demander des clarifications, ou informer l’utilisateur).

except Exception as e:
    tool_result_block = {
        "type": "tool_result",
        "tool_use_id": tool_request.id,
        "content": f"Error: {e}",
        "is_error": True
    }

On utilise le paramètre tool_choice avec le type "tool" et le nom de l’outil :

response = chat(
    messages,
    tools=[extract_data_schema],
    tool_choice={"type": "tool", "name": "extract_data"}
)

Les trois options de tool_choice sont :

• {"type": "auto"} — Claude décide seul (par défaut)
• {"type": "any"} — Claude doit utiliser un outil, au choix
• {"type": "tool", "name": "NOM"} — Claude doit utiliser l’outil spécifie

L’outil batch permet de réduire le nombre d’allers-retours avec l’API en encourageant Claude à regrouper plusieurs appels d’outils indépendants dans une seule requête. Au lieu de faire un aller-retour par outil, Claude appelle le batch tool une seule fois avec la liste de toutes les opérations à effectuer.

C’est un meta-outil qui accepte une liste d’invocations, chacune contenant le nom de l’outil et ses arguments.

On crée un schéma JSON qui décrit la structure de données souhaitée, on le déclaré comme outil, et on force Claude à l’utiliser via tool_choice. Les données structurées se trouvent dans le champ input du bloc tool_use de la réponse :

structured_data = response.content[0].input

Il n’est pas nécessaire de fournir un résultat d’outil en retour — on récupère simplement les données et on s’arrête la.

En mode standard, l’API met en tampon et valide les fragments JSON avant de les envoyer. Elle attend qu’une paire clé-valeur de premier niveau soit complète et valide avant de transmettre les données.

En mode fine_grained, la validation JSON est désactivée côté API. Les fragments arrivent dès que Claude les génère, sans mise en tampon. C’est plus rapide mais le JSON peut être invalide — votre code doit gérer ces cas avec un try/except sur json.loads().

Le mode granulaire est utile pour les applications où la réactivité est critique.