Récupérer le raisonnement chiffré avec include

Accéder au raisonnement interne des modèles de raisonnement xAI

Les modèles de raisonnement récents de xAI (grok-4.5, famille grok-4.20) produisent un raisonnement interne que vous ne pouvez pas lire en clair. Cependant, xAI vous permet de récupérer ce raisonnement sous forme chiffrée grâce au paramètre include. Ce mécanisme ouvre la porte à des utilisations avancées, notamment la réutilisation du raisonnement dans les requêtes suivantes.

Le paramètre include

Pour récupérer le contenu chiffré du raisonnement, ajoutez "reasoning.encrypted_content" dans le tableau include de votre requête à l’API Responses :

from openai import OpenAI

client = OpenAI(
    api_key="votre-cle-api",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analysez la complexité algorithmique du tri fusion.",
    include=["reasoning.encrypted_content"]
)

Structure de la réponse

La réponse contient le raisonnement chiffré dans un format spécifique. Ce contenu est un blob encodé que vous pouvez stocker mais pas interpréter. Sa structure interne est opaque par conception.

# Parcourir les éléments de la réponse
for item in response.output:
    if item.type == "reasoning":
        # Contenu chiffré du raisonnement
        encrypted = item.encrypted_content
        print(f"Taille du raisonnement chiffré : {len(encrypted)} caractères")
    elif item.type == "message":
        # Réponse finale du modèle
        print(f"Réponse : {item.content[0].text}")

Sans include : pas de raisonnement dans la réponse

Si vous n’incluez pas "reasoning.encrypted_content" dans le paramètre include, la réponse ne contiendra que le résultat final. Le raisonnement aura lieu côté serveur, mais aucune trace ne sera retournée :

# Sans include - seule la réponse finale est retournée
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analysez la complexité algorithmique du tri fusion."
)
# response.output ne contient que le message, pas de reasoning

Les tokens de raisonnement sont tout de même comptabilisés et facturés, même sans include. La différence est que vous ne recevez pas le contenu chiffré pour une éventuelle réutilisation.

Quand utiliser include

Récupérer le raisonnement chiffré a un coût — des réponses plus volumineuses, plus de bande passante — donc include se justifie par un usage précis, pas par principe. Le cas majeur est la conversation multi-tours : si vous prévoyez de poursuivre l’échange, réinjecter le raisonnement du tour précédent préserve la continuité de la réflexion du modèle, et c’est ce qui distingue une conversation qui progresse d’une suite de questions indépendantes. Le cache de pensée en est le prolongement industriel : stocker le raisonnement d’une requête pour le réutiliser sur des requêtes similaires évite au modèle de tout re-réfléchir. Restent deux usages de gouvernance : l’audit, quand la conformité exige une trace complète de chaque réponse produite, et le débogage avec le support xAI, qui demandera le raisonnement complet pour analyser un comportement inattendu.

Stockage du raisonnement chiffré

Le contenu chiffré peut être stocké comme n’importe quelle chaîne de caractères. En base de données, un champ TEXT ou JSONB suffit :

import json

# Extraire et stocker le raisonnement chiffré
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Sauvegarder avec la réponse
record = {
    "question": "Analysez la complexité du tri fusion.",
    "response": response.output[-1].content[0].text,
    "encrypted_reasoning": reasoning_data,
    "model": "grok-4.20-0309-reasoning",
    "timestamp": "2026-04-03T10:00:00Z"
}

Points clés à retenir

• Le paramètre include=["reasoning.encrypted_content"] récupère le raisonnement chiffré des modèles de raisonnement xAI
• Sans include, le raisonnement a lieu mais n’est pas retourné (les tokens sont quand même facturés)
• Le contenu chiffré est un blob opaque que vous ne pouvez pas lire en clair
• Ce contenu peut être stocké et réutilisé dans les requêtes suivantes (leçon suivante)
• N’utilisez include que si vous avez un usage concret du raisonnement chiffré