Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Versleutelde redenering ophalen met include

Les 5 van 12 Bijgewerkt op 28 juli 2026 Ontwikkelaar
Op deze pagina
  1. Interne redenering van xAI-redeneermodellen openen
  2. De parameter include
  3. Structuur van het antwoord
  4. Zonder include: geen redenering in het antwoord
  5. Wanneer u include gebruikt
  6. Versleutelde redenering opslaan
  7. Belangrijkste punten

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 include vindt 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 include alleen als u een specifiek gebruik heeft voor de versleutelde redenering