claudemaster Commencer

Construire avec l’API · Chapitre 11

Outils, cache & agents

Tool use, prompt caching et Agent SDK

L’essentiel

Tool use

Définis des outils, Claude répond par un bloc tool_use, tu exécutes et renvoies un tool_result.

{
  "name": "get_weather",
  "description": "Météo actuelle d’une ville",
  "input_schema": {
    "type": "object",
    "properties": {"city": {"type": "string"}},
    "required": ["city"]
  }
}

Prompt caching

Marque un long préfixe réutilisé pour réduire coûts et latence.

"cache_control": {"type": "ephemeral"}

Batches

Beaucoup de requêtes non urgentes ? La Batches API coûte moins cher.

Agent SDK

Le moteur de Claude Code, en bibliothèque : outils, permissions, sous-agents, MCP, hooks.

Vocabulaire

tool_use
Claude appelle un outil
tool_result
Résultat renvoyé
input_schema
Paramètres JSON
cache_control
Prompt caching
Batches
Asynchrone, moins cher
Agent SDK
Construire des agents
thinking
Réflexion étendue

Teste-toi

  1. Le « tool use » permet à Claude…

    • De demander l’appel de fonctions que TU définis
    • D’utiliser un marteau
    • De modifier l’API
    • De lire ton disque sans permission
    Voir la réponse

    De demander l’appel de fonctions que TU définis : Tu décris des outils ; Claude décide quand les appeler et avec quels arguments.

  2. Comment décrit-on les paramètres d’un outil ?

    • Avec un JSON Schema dans input_schema
    • En CSV
    • En SQL
    • Avec une image
    Voir la réponse

    Avec un JSON Schema dans input_schema : Chaque outil a un name, une description et un input_schema.

  3. Quand Claude veut utiliser un outil, stop_reason vaut…

    • tool_use
    • end_turn
    • max_tokens
    • error
    Voir la réponse

    tool_use : La réponse contient alors un bloc tool_use avec un id et un input.

  4. Comment renvoyer le résultat de ton outil à Claude ?

    • Un bloc tool_result dans un message user, avec le tool_use_id
    • Un e-mail
    • Un nouveau prompt système
    • On ne le renvoie pas
    Voir la réponse

    Un bloc tool_result dans un message user, avec le tool_use_id : Claude utilise ensuite le résultat pour continuer sa réponse.

  5. Le « prompt caching » sert à…

    • Réutiliser un long préfixe de prompt pour réduire coût et latence
    • Cacher le prompt à l’utilisateur
    • Supprimer l’historique
    • Chiffrer la clé API
    Voir la réponse

    Réutiliser un long préfixe de prompt pour réduire coût et latence : Idéal pour un long prompt système ou un gros document réutilisé à chaque appel.

  6. La « Message Batches API » est utile pour…

    • Traiter beaucoup de requêtes en asynchrone, moins cher
    • Discuter en temps réel
    • Faire du streaming
    • Générer des images
    Voir la réponse

    Traiter beaucoup de requêtes en asynchrone, moins cher : Jusqu’à 50 % moins cher, résultats en différé.

Apprends en jouant, 5 minutes par jour

Leçons interactives, série quotidienne, XP et ligues : ClaudeMaster transforme ce guide en exercices. Gratuit, sur le web et sur Android.

Commencer gratuitement