Réflexion étendue (Extended Thinking)

Certains problèmes méritent mieux qu’une réponse du premier jet. La réflexion étendue est la fonctionnalité avancée qui donne à Claude le temps de raisonner sur des problèmes complexes avant de générer sa réponse finale — c’est le monologue interne de Claude, rendu visible : vous pouvez voir comment il aborde votre problème étape par étape, quelles pistes il explore, lesquelles il écarte.

Fonctionnement

Quand vous activez la réflexion étendue, la réponse de Claude inclut deux parties au lieu d’une :

1. Partie raisonnement : le processus de réflexion interne de Claude
2. Partie texte : la réponse finale que vous vouliez

La partie raisonnement montre exactement comment Claude décompose votre problème, ce qu’il considère, et comment il arrive à sa réponse finale. Votre code d’extraction doit donc distinguer les deux : afficher, journaliser ou ignorer le raisonnement selon votre interface, et ne présenter à l’utilisateur que la partie texte — ou les deux, dans les applications qui veulent montrer le cheminement.

Compromis

La fonctionnalité se paie, et sur deux tableaux : meilleure précision sur les tâches complexes, mais coût plus élevé — vous payez pour tous les tokens de réflexion — et latence accrue, car la réflexion prend du temps avant que le premier mot de réponse n’apparaisse.

D’où la discipline d’activation, qui rejoint la philosophie de tout ce cours : la décision doit être basée sur les données. Si vous avez déjà optimisé votre prompt mais n’obtenez toujours pas la précision souhaitée sur vos évaluations, c’est le moment de considérer la réflexion étendue. L’activer d’office sur des tâches simples, c’est payer un raisonnement dont la réponse n’avait pas besoin.

Le système de signature

Le contenu de raisonnement est accompagné d’une signature cryptographique, qui garantit que le texte de réflexion ne peut pas être modifié. Si vous voulez inclure le raisonnement précédent dans une conversation de suivi — le cas normal en multi-tours —, la signature vérifie que le contenu n’a pas été altéré. La règle pratique en découle : le raisonnement est en lecture seule ; on le renvoie tel quel, on ne le retouche jamais, sous peine de rejet.

Contenu expurgé

Cas particulier à prévoir : parfois, la réflexion de Claude est signalée par les systèmes de sécurité internes. Dans ce cas, vous recevez un champ redactedContent au lieu du texte lisible. Le contenu expurgé est chiffré mais fonctionnel — vous pouvez le repasser à Claude dans les tours suivants sans perdre le contexte : le modèle, lui, sait toujours l’exploiter. Une application robuste gère donc les deux formes de raisonnement, lisible et expurgée.

Implémentation

Sur Bedrock, l’activation passe par les champs additionnels du modèle :

additional_model_fields["thinking"] = {
    "type": "enabled",
    "budget_tokens": thinking_budget
}

Le thinking_budget contrôle combien de tokens Claude peut dépenser pour le raisonnement, avec un minimum de 1024 tokens. Comme pour tout le reste, utilisez vos évaluations pour trouver le bon budget selon votre cas d’usage — les problèmes réellement durs profitent de budgets bien plus généreux.

Notre fonction chat accueille les deux nouveaux paramètres, dernière extension d’une signature qui a grandi avec le cours :

def chat(
    messages,
    system=None,
    temperature=1.0,
    stop_sequences=[],
    tools=None,
    tool_choice="auto",
    text_editor=None,
    thinking=False,
    thinking_budget=1024
):

Dernier outil de développement à connaître : il existe une chaîne de test spéciale qui force Claude à renvoyer du contenu expurgé — utile pour vérifier que votre code gère les deux cas correctement, en test plutôt qu’en découvrant le cas expurgé chez un utilisateur.

Points clés à retenir

• La réflexion étendue rend visible le raisonnement de Claude avant sa réponse — en deux parties distinctes
• Compromis explicite : précision accrue contre tokens facturés et latence — à arbitrer sur vos évaluations
• Le raisonnement est signé : renvoyez-le intact dans les conversations, toute modification est rejetée
• redactedContent = raisonnement chiffré mais réutilisable — gérez ce cas, testez-le avec la chaîne dédiée
• Sur Bedrock : thinking dans les champs additionnels, budget_tokens ≥ 1024, calibré par l’évaluation