Responses API: A reasoning objektum részletesen
Ezen az oldalon
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álismedium: egyensúly a mélység és a sebesség közötthigh: 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ág | Sima szöveg, érthető | Titkosított, átláthatatlan |
| Elsődleges használat | Megjelenítés felhasználónak, auditálás | Újrafelhasználás későbbi kérésekben |
| Aktiválás | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Részletesség | Tömör összefoglaló | Teljes gondolkodási folyamat |
| Elérhetőség | Kizárólag Responses API | Kizá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
reasoningobjektum kizárólag a Responses API-n érhető el - Az
effortszabályozza a mélységet (low,medium,high) - A
generate_summaryolvasható ö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
reasoningkihagyása érvényes: a modell alapértelmezett beállításokkal gondolkodik