Aller au contenu principal
Leçon 64 sur 95 · Construire avec l'API Claude

Quiz : fonctionnalités avancées de Claude

Leçon 64 sur 95 Mis à jour le 5 novembre 2026 Développeur
Sur cette page
  1. À vous de jouer
  2. Points clés à retenir

Dix questions pour vérifier les acquis de la section : réflexion, images, PDF, citations, mise en cache, exécution de code. Répondez avant d’ouvrir chaque réponse.

La section en quatre fonctionnalités Quatre tuiles : la réflexion réglée par effort ; les images et les PDF ; les citations ; la mise en cache et l'exécution de code. RÉCAPITULATIF La section en quatre fonctionnalités 01 Réflexion Adaptative par défaut, réglée par effort, renvoyée intacte. effort 02 Images et PDF Des blocs image et document, avant la question. file_id 03 Citations Chaque affirmation reliée au passage qui l'appuie. cited_text 04 Cache et code Un préfixe relu à moindre coût ; du code exécuté dans un conteneur. cache_control code_execution Chaque fonctionnalité se vérifie dans la réponse : blocs, citations, compteurs d'usage.
Récapitulatif de la section « Fonctionnalités avancées » de l'adaptation Corsen.

Question 1 : activer la réflexion

Vous envoyez thinking={"type": "enabled", "budget_tokens": 4000} à Claude Sonnet 5.5. Que se passe-t-il, et que faire à la place ?

Voir la réponse

Une erreur 400 : les modèles Claude 5 refusent budget_tokens. La réflexion y est déjà active et adaptative. Pour régler sa profondeur, on utilise output_config={"effort": "…"}, et max_tokens reste le plafond strict (leçon 56).

Question 2 : la réflexion masquée

Les blocs thinking arrivent avec un texte vide. La réflexion a-t-elle eu lieu, et est-elle facturée ?

Voir la réponse

Oui aux deux. Sur les modèles Claude 5, le texte est masqué par défaut (display: "omitted") ; la signature contient le raisonnement chiffré, et les jetons de réflexion sont facturés en totalité. display: "summarized" en donne un résumé (leçon 56).

Question 3 : renvoyer les blocs

Dans une boucle d’outils, votre code ne renvoie que les blocs text et tool_use de Claude. Pourquoi est-ce une erreur ?

Voir la réponse

Quand on renvoie un résultat d’outil, les blocs thinking et redacted_thinking du message de Claude doivent revenir intacts : un message filtré ou reconstruit provoque une erreur 400. Le plus sûr est d’ajouter la réponse entière à l’historique (leçons 35 et 56).

Question 4 : le coût d’une image

Combien de jetons coûte une image de 1 000 × 1 000 pixels ?

Voir la réponse

1 296 jetons : Claude découpe l’image en carrés de 28 × 28 pixels, soit 36 × 36 carrés. Une image trop grande est d’abord réduite, jusqu’à 2 576 pixels de côté sur les modèles Claude 4.7 et suivants (leçon 57).

Question 5 : questionner une image

Claude se trompe en comptant les billes d’une photo. Que changer dans le prompt ?

Voir la réponse

Donner une méthode : repérer et numéroter chaque bille, puis vérifier par un second comptage, rangée par rangée. On peut aussi fournir un exemple résolu. Les comptes restent approximatifs pour de nombreux petits objets : vérifiez quand l’enjeu est élevé (leçon 57).

Question 6 : un PDF scanné

Un PDF scanné, sans couche de texte, est-il exploitable par Claude ?

Voir la réponse

Oui : chaque page est convertie en image, en plus du texte extrait. Claude lit donc aussi les pages scannées, les graphiques et les tableaux. Une page coûte son texte et son image (leçon 58).

Question 7 : citations et JSON

Peut-on activer les citations et demander une sortie structurée dans la même requête ?

Voir la réponse

Non : la requête reçoit une erreur 400. Les citations intercalent leurs références dans le texte, ce que le schéma strict d’une sortie structurée interdit (leçon 59).

Question 8 : un cache qui ne sert jamais

Votre prompt système commence par « Nous sommes le 5 novembre 2026, il est 14 h 32 ». Pourquoi le cache n’est-il jamais relu ?

Voir la réponse

Parce que le préfixe change à chaque requête : le cache ne sert que si le contenu est identique au caractère près jusqu’au point d’arrêt. Placez les éléments variables après le dernier point d’arrêt (leçon 61).

Question 9 : vérifier la mise en cache

Comment savoir si une requête a écrit ou relu le cache ?

Voir la réponse

Avec response.usage : cache_creation_input_tokens compte ce qui a été écrit, cache_read_input_tokens ce qui a été relu. Si les deux valent 0, rien n’a été mis en cache, par exemple parce que le préfixe n’atteint pas le seuil minimal, 512 jetons sur les modèles Claude 5 actuels (leçons 61 et 62).

Question 10 : faire entrer des données dans le conteneur

Le conteneur d’exécution de code n’a pas accès à Internet. Comment Claude peut-il analyser votre fichier CSV, et comment récupérer son graphique ?

Voir la réponse

On téléverse le fichier avec la Files API, puis on le cite dans un bloc container_upload. Claude enregistre le graphique dans $OUTPUT_DIR ; la réponse en donne le file_id, que l’on télécharge avec client.files.download (leçon 63).

À vous de jouer

Combiner les fonctionnalités. Envoyez un rapport PDF avec les citations activées et le document mis en cache, puis posez trois questions de suite. Affichez chaque réponse avec ses citations, puis les compteurs de cache de chaque requête.

Sources officielles : Quiz on features of Claude (Claude Academy) · Thinking · Prompt caching (documentation Claude)

Points clés à retenir

  • Réflexion : adaptative et active par défaut ; on la règle avec effort, pas avec budget_tokens.
  • Images et PDF : des blocs image et document, en base64, par URL ou par file_id, avant la question.
  • Citations : par document, sur tous ou aucun, incompatibles avec les sorties structurées.
  • Mise en cache : un préfixe identique, au-dessus du seuil, relu à une fraction du prix.
  • Exécution de code : des données entrées par la Files API, des fichiers récupérés dans $OUTPUT_DIR.