Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Responses API: Objekt reasoning v detailu

Lekce 7 z 12 Aktualizováno 28. července 2026 Vývojář
Na této stránce
  1. Objekt reasoning v Responses API
  2. Kompletní struktura objektu reasoning
  3. Rozdíl mezi shrnutím a šifrovaným uvažováním
  4. Běžné kombinace
  5. Kdy vynechat objekt reasoning
  6. Klíčové poznatky

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é úkoly
  • medium : 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é:

AspektShrnutí (generate_summary)Šifrované (include)
ČitelnostProstý text, srozumitelnéŠifrované, neprůhledné
Hlavní využitíZobrazení uživateli, auditOpětovné použití v následujících požadavcích
Aktivacereasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetailnostKondenzované shrnutíPlné uvažování
DostupnostPouze Responses APIPouze 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 reasoning je dostupný pouze v Responses API
  • effort řídí hloubku (low, medium, high)
  • generate_summary vytváří č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í reasoning je platné: model uvažuje s výchozím nastavením