Chargement

Réflexion étendue

Leçon 3910 min
Chargement

La réflexion étendue est la fonctionnalité de raisonnement avancée de Claude qui donne au modèle le temps de résoudre des problèmes complexes avant de générer une réponse finale. Considérez-la comme le « brouillon » de Claude : vous pouvez voir le processus de raisonnement qui mène à la réponse, ce qui favorise la transparence et se traduit souvent par des réponses de meilleure qualité.

Comment fonctionne la réflexion étendue

Lorsque la réflexion étendue est activée, la réponse de Claude passe d'un simple bloc de texte à une réponse structurée comprenant deux parties :

Notre serveur envoie « Écrivez un court guide sur la récursivité » et le message de l'assistant Claude comporte un bloc de réflexion puis un bloc de texte.

Avec la réflexion activée, vous obtenez à la fois le processus de raisonnement et la réponse finale :

JSON du message de l'assistant : un bloc de réflexion avec un jeton de signature mis en évidence, puis un bloc de texte « Guide de la récursivité ».

Les principaux avantages incluent :

  • De meilleures capacités de raisonnement pour les tâches complexes
  • Une précision accrue sur les problèmes difficiles
  • Une transparence sur le processus de réflexion de Claude

Cependant, il existe des compromis importants :

  • Des coûts plus élevés (vous payez pour les jetons de réflexion)
  • Une latence accrue (la réflexion prend du temps)
  • Une gestion plus complexe des réponses dans votre code

Quand utiliser la réflexion étendue

La décision est simple : utilisez vos évaluations de requêtes. Exécutez d'abord vos requêtes sans réflexion et, si la précision ne répond pas à vos exigences après avoir déjà optimisé votre requête, envisagez d'activer la réflexion étendue. C'est un outil à utiliser lorsque la requête standard ne vous permet pas tout à fait d'y parvenir.

Structure de la réponse et sécurité

Les réponses en réflexion étendue incluent un système de signature spécial pour la sécurité :

JSON du message de l'assistant : un bloc de réflexion avec un jeton de signature mis en évidence, puis un bloc de texte « Guide de la récursivité ».

La signature est un jeton cryptographique qui garantit que vous n'avez pas modifié le texte de réflexion. Cela empêche les développeurs de falsifier le processus de raisonnement de Claude, ce qui pourrait potentiellement conduire le modèle dans des directions dangereuses.

Réflexion caviardée

Parfois, vous recevrez un bloc de réflexion caviardé au lieu d'un texte de raisonnement lisible.

Cela se produit lorsque le processus de réflexion de Claude est signalé par les systèmes de sécurité internes. Le contenu caviardé contient la réflexion réelle sous forme chiffrée, ce qui vous permet de renvoyer le message complet à Claude lors de conversations futures sans perdre le contexte.

Mise en œuvre

Pour activer la réflexion étendue dans votre code, vous devez ajouter deux paramètres à votre fonction de chat :

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

Le budget de réflexion — budget_tokens dans la requête — définit le nombre maximal de jetons que Claude peut utiliser pour le raisonnement. La valeur minimale de budget_tokens est de 1024, et votre paramètre max_tokens doit être supérieur à budget_tokens.

Ajoutez le paramètre thinking à votre requête API — un objet avec type défini sur "enabled" et une valeur budget_tokens — et augmentez max_tokens afin qu'il soit supérieur à budget_tokens :

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

Appelez ensuite votre fonction de chat avec la réflexion activée :

python
chat(messages, thinking=True)

Test des réponses caviardées

À des fins de test, vous pouvez forcer Claude à renvoyer un bloc de réflexion caviardé en envoyant une chaîne de déclenchement spéciale. Cela permet de s'assurer que votre application gère les réponses caviardées correctement sans planter.

La réflexion étendue est une fonctionnalité puissante lorsque vous avez besoin que Claude s'attaque à des tâches de raisonnement complexes, mais utilisez-la judicieusement compte tenu des implications en termes de coût et de latence. Commencez par une requête standard, optimisez-la minutieusement, puis ajoutez la réflexion lorsque vous avez besoin de cette capacité de raisonnement supplémentaire.