Responses API: Das reasoning-Objekt im Detail

Das reasoning-Objekt in der Responses API

Die xAI Responses API bietet über das reasoning-Objekt eine feingranulare Steuerung der Denkprozesse. Dieser Parameter steht ausschließlich in der Responses API zur Verfügung (nicht in Chat Completions) und ermöglicht die Konfiguration dreier Aspekte: die Anstrengung (effort), die Generierung einer Zusammenfassung und das Format dieser Zusammenfassung.

Die vollständige Struktur des reasoning-Objekts

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Ihre Frage hier",
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

effort

Steuert die Tiefe des Denkprozesses des Modells. Drei mögliche Werte:

• low: Minimale Denkintensität, geeignet für einfache Aufgaben.
• medium: Ein Gleichgewicht zwischen Tiefe und Geschwindigkeit.
• high: Maximale Denkintensität für komplexe Probleme.

Dieser Parameter entspricht dem reasoning_effort in Chat Completions, verfügt jedoch über den zusätzlichen Wert medium.

generate_summary

Ein boolescher Wert, der angibt, ob das Modell zusätzlich zur endgültigen Antwort eine Zusammenfassung seines Denkprozesses erstellen soll.

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Vergleichen Sie die Vorteile von Quicksort und Mergesort.",
  "reasoning": {
    "effort": "high",
    "generate_summary": true
  }
}

Wenn generate_summary auf true gesetzt ist, enthält die Antwort ein zusätzliches Element mit einer prägnanten Zusammenfassung des Denkprozesses. Diese Zusammenfassung liegt als reiner Text vor (nicht verschlüsselt), was sie von reasoning.encrypted_content unterscheidet.

summary

Steuert das Format der generierten Zusammenfassung. Derzeit ist der einzige dokumentierte Wert "auto", der es dem Modell erlaubt, das geeignetste Format selbst zu wählen.

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  }
}

Unterschied zwischen Zusammenfassung und verschlüsseltem Denkprozess

Diese beiden Mechanismen ergänzen sich, sind jedoch voneinander getrennt:

Sie können beide gleichzeitig aktivieren, um sowohl eine lesbare Zusammenfassung als auch den vollständigen verschlüsselten Denkprozess zu erhalten:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Demonstrieren Sie die Unendlichkeit der Primzahlen.",
    reasoning={
        "effort": "high",
        "generate_summary": True,
        "summary": "auto"
    },
    include=["reasoning.encrypted_content"]
)

Häufige Kombinationen

Minimale Nutzung: Nur Anstrengung

{
  "reasoning": {
    "effort": "low"
  }
}

Das Modell denkt mit minimaler Anstrengung. Es wird keine Zusammenfassung und kein verschlüsselter Denkprozess zurückgegeben.

Mittlere Nutzung: Anstrengung + Zusammenfassung

{
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

Das Modell denkt und liefert eine lesbare Zusammenfassung. Ideal für Anwendungen, die den Denkprozess für den Benutzer anzeigen möchten.

Vollständige Nutzung: Anstrengung + Zusammenfassung + Verschlüsselt

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  },
  "include": ["reasoning.encrypted_content"]
}

Maximale Konfiguration: tiefes Denken, lesbare Zusammenfassung und verschlüsselter Inhalt zur Wiederverwendung. Dies sollte nur für Fälle vorbehalten sein, in denen alles benötigt wird.

Wann das reasoning-Objekt weggelassen werden kann

Wenn Sie die Steuerung des Denkprozesses nicht benötigen, können Sie den Parameter reasoning einfach weglassen. Das Modell verwendet dann seine Standardeinstellungen. Dies ist weiterhin gültig, und das Modell wird weiterhin denken (da grok-4.20-0309-reasoning von Natur aus ein Denkmodell ist).

Kernaussagen

• Das reasoning-Objekt steht ausschließlich in der Responses API zur Verfügung.
• effort steuert die Tiefe (low, medium, high).
• generate_summary erzeugt eine lesbare Zusammenfassung des Denkprozesses (reiner Text).
• summary: "auto" ermöglicht es dem Modell, das Zusammenfassungsformat selbst zu wählen.
• Zusammenfassung und verschlüsselter Denkprozess können in derselben Anfrage kombiniert werden.
• Das Weglassen von reasoning ist gültig: Das Modell denkt mit Standardeinstellungen.