Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Responses API: Podroben pregled predmeta reasoning

Lekcija 7 od 12 Posodobljeno 28. julij 2026 Razvijalec
Na tej strani
  1. Predmet reasoning v Responses API
  2. Celotna struktura predmeta reasoning
  3. Razlika med povzetkom in šifriranim sklepanjem
  4. Pogoste kombinacije
  5. Kdaj izpustiti predmet reasoning
  6. Ključne ugotovitve

Predmet reasoning v Responses API

Responses API podjetja xAI omogoča natančen nadzor nad sklepanjem prek predmeta reasoning. Ta parameter je na voljo izključno v Responses API (ne pa tudi v Chat Completions) in ti omogoča konfiguracijo treh vidikov sklepanja: prizadevnosti, ustvarjanja povzetka in oblike povzetka.

Celotna struktura predmeta reasoning

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Your question here",
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

effort

Krmili globino razmišljanja modela. Na voljo so tri možne vrednosti:

  • low: minimalno razmišljanje, primerno za preproste naloge
  • medium: ravnovesje med globino in hitrostjo
  • high: maksimalno razmišljanje za kompleksne probleme

Ta parameter je v Responses API ekvivalent parametru reasoning_effort v Chat Completions, vendar z dodatno vrednostjo medium.

generate_summary

Boolova vrednost, ki določa, ali naj model poleg končnega odgovora ustvari tudi povzetek svojega sklepanja.

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Compare the advantages of quicksort and mergesort.",
  "reasoning": {
    "effort": "high",
    "generate_summary": true
  }
}

Ko je generate_summary nastavljen na true, odgovor vsebuje dodaten element s jedrnatim povzetkom procesa sklepanja. Ta povzetek je v navadnem besedilu (ni šifriran), kar ga razlikuje od reasoning.encrypted_content.

summary

Krmili obliko ustvarjenega povzetka. Trenutno je edina dokumentirana vrednost "auto", ki modelu omogoča izbiro najprimernejše oblike.

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  }
}

Razlika med povzetkom in šifriranim sklepanjem

Ta dva mehanizma se dopolnjujeta, vendar sta različna:

VidikPovzetek (generate_summary)Šifrirano (include)
BerljivostNavadno besedilo, razumljivoŠifrirano, neprozorno
Primarna uporabaPrikaz uporabniku, revizijaPonovna uporaba v naslednjih zahtevkih
Aktivacijareasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
PodrobnostJedrnat povzetekPolno sklepanje
RazpoložljivostSamo Responses APISamo Responses API

Oba lahko omogočiš hkrati, da dobiš tako berljiv povzetek kot tudi polno šifrirano sklepanje:

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"]
)

Pogoste kombinacije

Minimalna uporaba: Samo prizadevnost

{
  "reasoning": {
    "effort": "low"
  }
}

Model sklepa z minimalno prizadevnostjo. Brez povzetka, brez vrnjenega šifriranega sklepanja.

Vmesna uporaba: Prizadevnost + Povzetek

{
  "reasoning": {
    "effort": "medium",
    "generate_summary": true,
    "summary": "auto"
  }
}

Model sklepa in zagotovi berljiv povzetek. Idealno za aplikacije, ki želijo uporabniku prikazati proces razmišljanja.

Polna uporaba: Prizadevnost + Povzetek + Šifrirano

{
  "reasoning": {
    "effort": "high",
    "generate_summary": true,
    "summary": "auto"
  },
  "include": ["reasoning.encrypted_content"]
}

Maksimalna konfiguracija: globoko sklepanje, berljiv povzetek in šifrirana vsebina za ponovno uporabo. To uporabi le v primerih, ko potrebuješ vse naenkrat.

Kdaj izpustiti predmet reasoning

Če ne potrebuješ nadzora nad sklepanjem, lahko parameter reasoning preprosto izpustiš. Model bo uporabil svoje privzete nastavitve. To je veljavno in model bo še vedno sklepal (saj je grok-4.20-0309-reasoning po naravi model za sklepanje).

Ključne ugotovitve

  • Predmet reasoning je na voljo samo v Responses API
  • effort krmili globino (low, medium, high)
  • generate_summary ustvari berljiv povzetek sklepanja (navadno besedilo)
  • summary: "auto" modelu omogoča izbiro oblike povzetka
  • Povzetek in šifrirano sklepanje lahko združiš v istem zahtevku
  • Izpustitev reasoning je veljavna: model sklepa s privzetimi nastavitvami