Abrufen verschlüsselter Begründungen mit include

Zugriff auf interne Begründungen von xAI-Modellen für die Begründung

Neuere xAI-Modelle für die Begründung (grok-4.5, grok-4.20-Familie) erzeugen interne Begründungen, die Sie nicht als reiner Text lesen können. xAI ermöglicht es Ihnen jedoch, diese Begründungen in verschlüsselter Form über den Parameter include abzurufen. Dieser Mechanismus ermöglicht fortschrittliche Anwendungen, insbesondere die Wiederverwendung von Begründungen in nachfolgenden Anfragen.

Der include-Parameter

Um den Inhalt der verschlüsselten Begründung abzurufen, fügen Sie "reasoning.encrypted_content" dem Array include in Ihrer Anfrage an die Responses API hinzu:

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"]
)

Antwortstruktur

Die Antwort enthält die verschlüsselte Begründung in einem spezifischen Format. Dieser Inhalt ist ein codierter Blob, den Sie speichern, aber nicht interpretieren können. Ihre interne Struktur ist aus Designgründen undurchsichtig.

# Iteration durch Antwortelemente
for item in response.output:
    if item.type == "reasoning":
        # Inhalt der verschlüsselten Begründung
        encrypted = item.encrypted_content
        print(f"Größe der verschlüsselten Begründung: {len(encrypted)} Zeichen")
    elif item.type == "message":
        # Endgültige Antwort des Modells
        print(f"Antwort: {item.content[0].text}")

Ohne include: Keine Begründung in der Antwort

Wenn Sie "reasoning.encrypted_content" nicht im Parameter include angeben, enthält die Antwort nur das Endergebnis. Die Begründung erfolgt serverseitig, aber es wird kein Nachweis zurückgegeben:

# Ohne include – nur die endgültige Antwort wird zurückgegeben
response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze the algorithmic complexity of merge sort."
)
# response.output enthält nur die Nachricht, keine Begründung

Begründungstokens werden weiterhin gezählt und berechnet, auch ohne include. Der Unterschied besteht darin, dass Sie den verschlüsselten Inhalt für eine spätere Wiederverwendung nicht erhalten.

Wann include verwenden

Das Abrufen verschlüsselter Begründungen verursacht Kosten – größere Antworten, mehr Bandbreite – daher sollten Sie include nur für einen spezifischen Zweck und nicht standardmäßig verwenden. Der primäre Anwendungsfall ist ein mehrstufiger Dialog: Wenn Sie den Austausch fortsetzen möchten, bewahrt die Reinjektion der Begründung aus dem vorherigen Turn die Kontinuität des Denkens des Modells. Dies unterscheidet einen fortschreitenden Dialog von einer Reihe unabhängiger Fragen. Der Thought Cache ist die Erweiterung für Unternehmen: Das Speichern von Begründungen aus einer Anfrage, um sie bei ähnlichen Anfragen wiederverwenden zu können, vermeidet, dass das Modell alles neu berechnet. Zwei Governance-Anwendungsfälle bleiben bestehen: Prüfung (Audit), wenn die Compliance eine vollständige Spur jeder erzeugten Antwort erfordert, und Fehleranalyse mit Unterstützung von xAI, die die vollständige Begründung anfordert, um unerwartetes Verhalten zu analysieren.

Speichern verschlüsselter Begründungen

Sie können den verschlüsselten Inhalt wie einen beliebigen String speichern. In einer Datenbank reicht ein Feld vom Typ TEXT oder JSONB:

import json

# Extrahieren und Speichern der verschlüsselten Begründung
reasoning_data = None
for item in response.output:
    if item.type == "reasoning":
        reasoning_data = item.encrypted_content

# Speichern mit der Antwort
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"
}

Kernaussagen

• Der Parameter include=["reasoning.encrypted_content"] holt verschlüsselte Begründungen von xAI-Modellen für die Begründung ab.
• Ohne include erfolgt die Begründung, wird aber nicht zurückgegeben (Tokens werden weiterhin berechnet).
• Der verschlüsselte Inhalt ist ein undurchsichtiger Blob, den Sie nicht als reiner Text lesen können.
• Sie können diesen Inhalt speichern und in nachfolgenden Anfragen wiederverwenden (in der nächsten Lektion).
• Verwenden Sie include nur, wenn Sie einen spezifischen Verwendungszweck für die verschlüsselte Begründung haben.