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
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.
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, unedescriptionet uninput_schema.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_useavec unidet uninput.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.
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.
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é.