Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Responses API: Objekt reasoning v detailoch

Lekcia 7 z 12 Aktualizované 28. júla 2026 Vývojár
Na tejto strane
  1. Objekt reasoning v Responses API
  2. Kompletná štruktúra objektu reasoning
  3. Rozdiel medzi zhrnutím a šifrovaným usudzovaním
  4. Bežné kombinácie
  5. Kedy vynechať objekt reasoning
  6. Kľúčové poznatky

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é úlohy
  • medium: rovnováha medzi hĺbkou a rýchlosťou
  • high: 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é:

AspektZhrnutie (generate_summary)Šifrované (include)
ČitateľnosťČistý text, zrozumiteľnéŠifrované, nepriehľadné
Hlavné využitieZobrazenie používateľovi, auditOpätovné použitie v následných požiadavkách
Aktiváciareasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetailnosťStručné zhrnutieÚplné usudzovanie
DostupnosťIba Responses APIIba 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 reasoning je dostupný iba v Responses API
  • effort ovláda hĺbku (low, medium, high)
  • generate_summary vytvá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 reasoning je platné: model uvažuje s predvolenými nastaveniami