Anthropic 0.128.0 : addTools maximise la réutilisation du cache

Anthropic introduit addTools() dans son SDK 0.128.0 pour ajouter des outils en cours d'exécution sans modifier le tableau tools[]. Cette méthode permet de réutiliser jusqu'à 98,7 % du préfixe de la requête suivante grâce au cache, à condition d'activer un beta header spécifique. Certaines limites persistent, avec des cas pouvant encore entraîner un cache miss complet.

Un beta header obligatoire et des cas de cache miss subsistent

L'utilisation de cette fonctionnalité nécessite d'ajouter le header ou paramètre beta inline-tools-2026-09-15, qui n'est pas inclus automatiquement par le runner. Ce beta flag doit donc être spécifié explicitement. Malgré l'amélioration attendue sur la réutilisation du cache, il subsiste des limitations liées au modèle, ainsi qu'un cas particulier pouvant toujours provoquer un cache miss complet. Par ailleurs, une pause dans l'exécution retarde la prise en compte des changements d'outils, même si l'ajout ou la suppression d'un outil est immédiat côté agent.

Pourquoi modifier tools[] invalide le cache et comment addTools() l'évite

Dans le cache de prompt, les définitions d'outils sont placées au début du préfixe. Toute modification de tools[] entraîne donc un cache miss complet. La fonction addTools() contourne ce problème en laissant le tableau tools[] inchangé et en ajoutant un message système contenant un bloc tool_addition, ce qui limite le traitement à la seule partie nouvellement ajoutée. Cette capacité est disponible dans le SDK Anthropic 0.128.0 en TypeScript, lancé avec Claude Opus 5.5, et permet d'ajouter un outil en cours d'exécution sans modifier la base des outils.

Jusqu'à 98,7 % de préfixe réutilisé avec addTools(), quasi nul avec tools[]

L'utilisation de addTools() permet de réutiliser jusqu'à 98,7 % du préfixe de la requête suivante via le cache, alors qu'une modification directe de tools[] ne permet pratiquement aucune réutilisation. Un script Node reproductible a permis de mesurer la réutilisation du JSON de requête, montrant un préfixe partagé jusqu'à 98,7 % avec addTools() et proche de zéro après modification de tools[]. L'écart de réutilisation s'accentue avec la longueur de la conversation. Il est donc conseillé de conserver l'array tools[] initial et d'utiliser addTools(), en activant le beta flag pour les modèles compatibles.