Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Responses API: A reasoning objektum részletesen

7. lecke 12 közül Frissítve 2026. július 28. Fejlesztő
Ezen az oldalon
  1. A reasoning objektum a Responses API-ban
  2. A reasoning objektum teljes szerkezete
  3. Különbség az összefoglaló és a titkosított gondolkodás között
  4. Gyakori kombinációk
  5. Mikor hagyd ki a reasoning objektumot?
  6. Főbb megállapítások

A reasoning objektum a Responses API-ban

Az xAI Responses API-ja finomhangolt vezérlést tesz lehetővé a gondolkodási folyamat felett a reasoning objektum segítségével. Ez a paraméter kizárólag a Responses API-n érhető el (a Chat Completions-en nem), és három aspektus konfigurálását teszi lehetővé: a ráfordított erőfeszítést, az összefoglaló generálását és az összefoglaló formátumát.

A reasoning objektum teljes szerkezete

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Your question here",
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

effort

Szabályozza a modell gondolkodási mélységét. Három lehetséges érték:

  • low: minimális gondolkodás, egyszerű feladatokhoz ideális
  • medium: egyensúly a mélység és a sebesség között
  • high: maximális gondolkodás összetett problémák esetén

Ez a paraméter a Responses API megfelelője a Chat Completions reasoning_effort paraméterének, kiegészülve egy új medium értékkel.

generate_summary

Egy logikai érték (boolean), amely azt jelzi, hogy a modellnek kell-e összefoglalót készítenie a gondolkodási folyamatáról a végső válasz mellett.

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Compare the advantages of quicksort and mergesort.",
  "reasoning": {
    "effort": "high",
    "generate_summary": true
  }
}

Ha a generate_summary értéke true, a válasz tartalmaz egy további elemet, amely tömören összefoglalja a gondolkodási folyamatot. Ez az összefoglaló sima szövegként (plaintext) jelenik meg (nincs titkosítva), ami megkülönbözteti a reasoning.encrypted_content tartalomtól.

summary

Szabályozza a generált összefoglaló formátumát. Jelenleg az egyetlen dokumentált érték az "auto", amely lehetővé teszi a modell számára, hogy kiválassza a legmegfelelőbb formátumot.

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

Különbség az összefoglaló és a titkosított gondolkodás között

Ez a két mechanizmus kiegészíti egymást, de eltérő funkciót lát el:

SzempontÖsszefoglaló (generate_summary)Titkosított (include)
OlvashatóságSima szöveg, érthetőTitkosított, átláthatatlan
Elsődleges használatMegjelenítés felhasználónak, auditálásÚjrafelhasználás későbbi kérésekben
Aktiválásreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
RészletességTömör összefoglalóTeljes gondolkodási folyamat
ElérhetőségKizárólag Responses APIKizárólag Responses API

Mindkettőt engedélyezheted egyszerre, hogy egyszer kapd meg az olvasható összefoglalót és a teljes titkosított gondolkodási folyamatot is:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Demonstrate the infinitude of prime numbers.",
    reasoning={
        "effort": "high",
        "generate_summary": True,
        "summary": "auto"
    },
    include=["reasoning.encrypted_content"]
)

Gyakori kombinációk

Minimális használat: Csak Effort

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

A modell minimális erőfeszítéssel gondolkodik. Nem készül összefoglaló, és nem kerül vissza titkosított gondolkodási adat sem.

Közepes használat: Effort + Összefoglaló

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

A modell gondolkodik, és olvasható összefoglalót készít. Ideális olyan alkalmazásokhoz, amelyek megjelenítik a felhasználó számára a gondolkodási folyamatot.

Teljes használat: Effort + Összefoglaló + Titkosított

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

Maximális konfiguráció: mély gondolkodás, olvasható összefoglaló és újrafelhasználható titkosított tartalom. Ezt csak olyan esetekben használd, amikor minden adatra szükséged van.

Mikor hagyd ki a reasoning objektumot?

Ha nem kell vezérelned a gondolkodási folyamatot, egyszerűen hagyd ki a reasoning paramétert. A modell az alapértelmezett beállításait fogja használni. Ez teljesen érvényes megoldás, és a modell továbbra is gondolkodni fog (mivel a grok-4.20-0309-reasoning alapvetően egy gondolkodó modell).

Főbb megállapítások

  • A reasoning objektum kizárólag a Responses API-n érhető el
  • Az effort szabályozza a mélységet (low, medium, high)
  • A generate_summary olvasható összefoglalót készít a gondolkodásról (sima szöveg)
  • A summary: "auto" lehetővé teszi a modell számára az összefoglaló formátumának kiválasztását
  • Egy kérésben kombinálhatod az összefoglalót és a titkosított gondolkodást
  • A reasoning kihagyása érvényes: a modell alapértelmezett beállításokkal gondolkodik