Claude Academy
Chargement

Réflexion étendue

Leçon 4310 min

La réflexion étendue est la fonctionnalité de raisonnement avancée de Claude qui donne au modèle le temps de réfléchir à des problèmes complexes avant de générer une réponse. Lorsqu'elle est activée, Claude produit un processus de réflexion visible que les utilisateurs peuvent examiner pour comprendre comment le modèle a abordé leur requête.

Cette fonctionnalité améliore considérablement la capacité de Claude à gérer des tâches complexes avec une plus grande précision, mais elle s'accompagne de compromis importants. Vous serez facturé pour tous les tokens générés pendant la phase de réflexion, et le temps de traitement supplémentaire augmente la latence de réponse. La clé est de savoir quand l'intelligence améliorée justifie le coût et le temps d'attente supplémentaires.

Quand utiliser la réflexion étendue

La décision d'activer la réflexion étendue doit être guidée par vos évaluations de prompts. Voici l'approche recommandée :

  • Rédigez et testez votre prompt sans réflexion étendue d'abord
  • Exécutez des évaluations pour mesurer la précision
  • Si les résultats ne répondent pas à vos standards après des efforts d'optimisation du prompt
  • Envisagez alors d'activer la réflexion étendue comme solution

Comment la réflexion étendue modifie les réponses

Sans réflexion étendue, le flux de réponse de Claude est simple - vous envoyez un message utilisateur avec un bloc de texte et recevez en retour un message assistant avec un bloc de texte.

Avec la réflexion étendue activée, la structure de la réponse change considérablement. Vous recevrez un message assistant contenant deux blocs distincts :

  • Un bloc thinking contenant le processus de raisonnement de Claude
  • Un bloc text avec la réponse finale

Le système de signature

Chaque bloc de réflexion inclut une signature cryptographique qui remplit un objectif de sécurité important. Cette signature garantit que le texte de réflexion n'a pas été modifié lorsque vous incluez le message dans de futurs tours de conversation.

Claude s'appuie fortement sur le contenu de réflexion pour la génération de réponses, donc prévenir toute altération est crucial pour maintenir un comportement sûr et cohérent. Si vous modifiez le texte de réflexion, la validation de la signature échouera.

Réflexion expurgée

Parfois, le processus de réflexion de Claude est signalé par les systèmes de sécurité internes. Lorsque cela se produit, vous recevrez un bloc de réflexion expurgé au lieu du texte de réflexion brut.

Le contenu expurgé contient le texte de réflexion réel sous forme chiffrée. Bien que vous ne puissiez pas le lire, vous pouvez toujours inclure ce bloc dans de futurs tours de conversation afin que Claude ne perde pas le contexte de son raisonnement précédent.

Implémentation

Pour activer la réflexion étendue dans votre code, vous devrez modifier votre fonction de chat avec deux nouveaux paramètres :

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

Le budget de réflexion représente le nombre maximal de tokens que Claude peut utiliser pour le raisonnement. La valeur minimale autorisée est de 1024 tokens. Il est important de noter que votre paramètre max_tokens doit dépasser votre budget de réflexion - si vous définissez un budget de réflexion de 1024, max_tokens doit être d'au moins 1025.

En pratique, vous voudrez une marge beaucoup plus importante. Par exemple, avec un budget de réflexion de 1024 et un max_tokens de 4000, Claude peut utiliser jusqu'à 1024 tokens pour la réflexion et jusqu'à 2976 tokens pour la réponse réelle.

Ajoutez la configuration de réflexion à vos paramètres API lorsque la fonctionnalité est activée :

python
if thinking:
    params["thinking"] = {
        "type": "enabled",
        "budget_tokens": thinking_budget
    }

Test des réponses expurgées

Pendant le développement, vous pourriez vouloir tester comment votre application gère les blocs de réflexion expurgés. Vous pouvez forcer Claude à renvoyer une réponse expurgée en incluant cette chaîne de déclenchement spéciale dans votre message :

TRIGGER_REDACTED_THINKING_46C9A13E193C177646C7398A98432ECCCE4C1253D5E2D82641AC0E52CC2876CB

Cela garantit que votre gestion des erreurs fonctionne correctement lorsque vous rencontrez du contenu expurgé en production.