Responses API: Objekt reasoning v detailoch
Na tejto strane
Objekt reasoning v Responses API
Responses API od xAI ti ponúka jemné nastavenie usudzovania prostredníctvom objektu reasoning. Tento parameter je dostupný výlučne v Responses API (nie v Chat Completions) a umožňuje ti konfigurovať tri aspekty usudzovania: úsilie, generovanie zhrnutia a formát zhrnutia.
Kompletná štruktúra objektu reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Ovláda hĺbku uvažovania modelu. K dispozícii sú tri hodnoty:
low: minimálne uvažovanie, vhodné pre jednoduché úlohymedium: rovnováha medzi hĺbkou a rýchlosťouhigh: maximálne uvažovanie pre zložité problémy
Tento parameter je v Responses API ekvivalentom reasoning_effort z Chat Completions, no pridáva ďalšiu hodnotu medium.
generate_summary
Logická hodnota (boolean), ktorá určuje, či má model vygenerovať zhrnutie svojho usudzovania navyše k finálnej odpovedi.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Keď je generate_summary nastavené na true, odpoveď obsahuje dodatočný prvok so stručným zhrnutím procesu usudzovania. Toto zhrnutie je v čistom texte (nie šifrované), čo ho odlišuje od reasoning.encrypted_content.
summary
Ovláda formát generovaného zhrnutia. V súčasnosti je jedinou zdokumentovanou hodnotou "auto", čo modelu umožňuje vybrať najvhodnejší formát.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Rozdiel medzi zhrnutím a šifrovaným usudzovaním
Tieto dva mechanizmy sa dopĺňajú, no sú odlišné:
| Aspekt | Zhrnutie (generate_summary) | Šifrované (include) |
|---|---|---|
| Čitateľnosť | Čistý text, zrozumiteľné | Šifrované, nepriehľadné |
| Hlavné využitie | Zobrazenie používateľovi, audit | Opätovné použitie v následných požiadavkách |
| Aktivácia | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detailnosť | Stručné zhrnutie | Úplné usudzovanie |
| Dostupnosť | Iba Responses API | Iba Responses API |
Obidve funkcie môžeš povoliť súčasne, aby si získal čitateľné zhrnutie aj úplné šifrované usudzovanie:
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"]
)
Bežné kombinácie
Minimálne použitie: Iba úsilie
{
"reasoning": {
"effort": "low"
}
}
Model uvažuje s minimálnym úsilím. Nevracia sa žiadne zhrnutie ani šifrované usudzovanie.
Stredné použitie: Úsilie + Zhrnutie
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Model uvažuje a poskytuje čitateľné zhrnutie. Ideálne pre aplikácie, ktoré chcú používateľovi ukázať proces uvažovania.
Plné použitie: Úsilie + Zhrnutie + Šifrované
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maximálna konfigurácia: hlboké usudzovanie, čitateľné zhrnutie a šifrovaný obsah na opätovné použitie. Túto kombináciu si nechaj pre prípady, keď potrebuješ všetko.
Kedy vynechať objekt reasoning
Ak nepotrebuješ riadiť usudzovanie, môžeš parameter reasoning jednoducho vynechať. Model použije svoje predvolené nastavenia. Toto je platný postup a model bude stále uvažovať (keďže grok-4.20-0309-reasoning je svojou povahou model na usudzovanie).
Kľúčové poznatky
- Objekt
reasoningje dostupný iba v Responses API effortovláda hĺbku (low,medium,high)generate_summaryvytvára čitateľné zhrnutie usudzovania (čistý text)summary: "auto"umožňuje modelu vybrať formát zhrnutia- Zhrnutie a šifrované usudzovanie môžeš kombinovať v jednej požiadavke
- Vynechanie
reasoningje platné: model uvažuje s predvolenými nastaveniami