Responses API: Objekt reasoning v detailu
Na této stránce
Objekt reasoning v Responses API
Responses API od xAI ti nabízí jemnou kontrolu nad procesem uvažování prostřednictvím objektu reasoning. Tento parametr je dostupný výhradně v Responses API (nikoliv v Chat Completions) a umožňuje ti konfigurovat tři aspekty uvažování: úsilí, generování shrnutí a formát shrnutí.
Kompletní struktura objektu reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Řídí hloubku myšlení modelu. K dispozici jsou tři hodnoty:
low: minimální myšlení, vhodné pro jednoduché úkolymedium: rovnováha mezi hloubkou a rychlostíhigh: maximální myšlení pro složité problémy
Tento parametr je v Responses API ekvivalentem parametru reasoning_effort z Chat Completions, ale s přidanou hodnotou medium.
generate_summary
Booleovská hodnota, která určuje, zda má model vygenerovat shrnutí svého uvažování navíc k finální odpovědi.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Když je generate_summary nastaveno na true, odpověď obsahuje dodatečný prvek se stručným shrnutím procesu uvažování. Toto shrnutí je v prostém textu (nešifrované), čímž se liší od reasoning.encrypted_content.
summary
Řídí formát generovaného shrnutí. V tuto chvíli je jedinou zdokumentovanou hodnotou "auto", která nechává model vybrat nejvhodnější formát.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Rozdíl mezi shrnutím a šifrovaným uvažováním
Tyto dva mechanismy se doplňují, ale jsou odlišné:
| Aspekt | Shrnutí (generate_summary) | Šifrované (include) |
|---|---|---|
| Čitelnost | Prostý text, srozumitelné | Šifrované, neprůhledné |
| Hlavní využití | Zobrazení uživateli, audit | Opětovné použití v následujících požadavcích |
| Aktivace | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detailnost | Kondenzované shrnutí | Plné uvažování |
| Dostupnost | Pouze Responses API | Pouze Responses API |
Oba režimy můžeš aktivovat současně, abys získal jak čitelné shrnutí, tak plné šifrované uvažování:
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"]
)
Běžné kombinace
Minimální využití: Pouze úsilí
{
"reasoning": {
"effort": "low"
}
}
Model uvažuje s minimálním úsilím. Žádné shrnutí ani šifrované uvažování se nevrací.
Střední využití: Úsilí + Shrnutí
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Model uvažuje a poskytuje čitelné shrnutí. Ideální pro aplikace, které chtějí uživateli zobrazit proces myšlení.
Plné využití: Úsilí + Shrnutí + Šifrované
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maximální konfigurace: hluboké uvažování, čitelné shrnutí a šifrovaný obsah pro opětovné použití. Tuto variantu si rezervuj pro případy, kdy potřebuješ vše.
Kdy vynechat objekt reasoning
Pokud nepotřebuješ řídit uvažování, můžeš parametr reasoning jednoduše vynechat. Model použije svá výchozí nastavení. Toto je platný postup a model bude stále uvažovat (protože grok-4.20-0309-reasoning je ze své podstaty model zaměřený na uvažování).
Klíčové poznatky
- Objekt
reasoningje dostupný pouze v Responses API effortřídí hloubku (low,medium,high)generate_summaryvytváří čitelné shrnutí uvažování (prostý text)summary: "auto"nechává model vybrat formát shrnutí- Shrnutí a šifrované uvažování můžeš kombinovat v jednom požadavku
- Vynechání
reasoningje platné: model uvažuje s výchozím nastavením