Versleutelde redenering ophalen met include
Op deze pagina
Interne redenering van xAI-redeneermodellen openen
Recente xAI-redeneermodellen (de families grok-4.5 en grok-4.20) genereren interne redeneringen die u niet als platte tekst kunt lezen. xAI stelt u echter in staat deze redenering in versleutelde vorm op te halen via de parameter include. Dit mechanisme maakt geavanceerd gebruik mogelijk, met name het hergebruiken van redeneringen in daaropvolgende verzoeken.
De parameter include
Om de versleutelde redeneringsinhoud op te halen, voegt u "reasoning.encrypted_content" toe aan de array include in uw Responses API-verzoek:
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort.",
include=["reasoning.encrypted_content"]
)
Structuur van het antwoord
Het antwoord bevat de versleutelde redenering in een specifiek formaat. Deze inhoud is een gecodeerde blob die u kunt opslaan, maar niet kunt interpreteren. De interne structuur is bewust ondoorzichtig.
# Itereer door de antwoordelementen
for item in response.output:
if item.type == "reasoning":
# Versleutelde redeneringsinhoud
encrypted = item.encrypted_content
print(f"Encrypted reasoning size: {len(encrypted)} characters")
elif item.type == "message":
# Definitieve antwoord van het model
print(f"Response: {item.content[0].text}")
Zonder include: geen redenering in het antwoord
Als u "reasoning.encrypted_content" niet opneemt in de parameter include, bevat het antwoord alleen het eindresultaat. De redenering vindt plaats aan de serverzijde, maar er wordt geen spoor van teruggegeven:
# Zonder include - alleen het definitieve antwoord wordt teruggegeven
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Analyze the algorithmic complexity of merge sort."
)
# response.output bevat alleen het bericht, geen redenering
Redeneringstokens worden nog steeds geteld en gefactureerd, zelfs zonder include. Het verschil is dat u de versleutelde inhoud niet ontvangt voor later hergebruik.
Wanneer u include gebruikt
Het ophalen van versleutelde redenering brengt kosten met zich mee: grotere antwoorden en meer bandbreedte. Gebruik include daarom voor een specifiek doel en niet standaard. De primaire use case is conversatie in meerdere beurten: als u van plan bent de uitwisseling voort te zetten, behoudt het opnieuw injecteren van de redenering uit de vorige beurt de continuïteit van de gedachtegang van het model. Dit onderscheidt een voortschrijdend gesprek van een reeks onafhankelijke vragen. Thought cache is de enterprise-extensie: het opslaan van redeneringen uit een verzoek om deze bij vergelijkbare verzoeken opnieuw te gebruiken, voorkomt dat het model alles opnieuw moet berekenen. Er blijven twee governance-use cases over: audit, wanneer compliance een volledig spoor vereist van elk geproduceerd antwoord, en debugging met ondersteuning van xAI, die de volledige redenering zal opvragen om onverwacht gedrag te analyseren.
Versleutelde redenering opslaan
U kunt de versleutelde inhoud opslaan als elke andere string. In een database volstaat een veld van het type TEXT of JSONB:
import json
# Versleutelde redenering extraheren en opslaan
reasoning_data = None
for item in response.output:
if item.type == "reasoning":
reasoning_data = item.encrypted_content
# Opslaan samen met het antwoord
record = {
"question": "Analyze the complexity of merge sort.",
"response": response.output[-1].content[0].text,
"encrypted_reasoning": reasoning_data,
"model": "grok-4.20-0309-reasoning",
"timestamp": "2026-04-03T10:00:00Z"
}
Belangrijkste punten
- De parameter
include=["reasoning.encrypted_content"]haalt versleutelde redenering op van xAI-redeneermodellen - Zonder
includevindt redenering plaats, maar wordt deze niet teruggegeven (tokens worden nog steeds gefactureerd) - Versleutelde inhoud is een ondoorzichtige blob die u niet als platte tekst kunt lezen
- U kunt deze inhoud opslaan en hergebruiken in daaropvolgende verzoeken (in de volgende les)
- Gebruik
includealleen als u een specifiek gebruik heeft voor de versleutelde redenering