Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Responses API: Objekt reasoning u detalje

Lekcija 7 od 12 Ažurirano 28. srpnja 2026. Programer
Na ovoj stranici
  1. Objekt reasoning u Responses APIju
  2. Potpuna struktura objekta reasoning
  3. Razlika između sažetka i šifriranog rezoniranja
  4. Uobičajene kombinacije
  5. Kada izostaviti objekt reasoning
  6. Ključne točke

Objekt reasoning u Responses APIju

xAI-jev Responses API nudi preciznu kontrolu nad rezoniranjem putem objekta reasoning. Ovaj parametar dostupan je isključivo u Responses APIju (ne i u Chat Completionsu) te ti omogućuje konfiguraciju tri aspekta rezoniranja: razine napora, generiranja sažetka i formata sažetka.

Potpuna struktura objekta reasoning

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

effort

Kontrolira dubinu razmišljanja modela. Tri moguće vrijednosti:

  • low : minimalno razmišljanje, prikladno za jednostavne zadatke
  • medium : balans između dubine i brzine
  • high : maksimalno razmišljanje za složene probleme

Ovaj parametar ekvivalent je reasoning_effort u Chat Completionsu, ali s dodatnom vrijednošću medium.

generate_summary

Booleova vrijednost koja označava treba li model, uz konačan odgovor, proizvesti i sažetak svog procesa rezoniranja.

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

Kada je generate_summary postavljen na true, odgovor sadrži dodatni element s konciznim sažetkom procesa rezoniranja. Taj je sažetak u običnom tekstu (nije šifriran), što ga razlikuje od reasoning.encrypted_content.

summary

Kontrolira format generiranog sažetka. Trenutačno je jedina dokumentirana vrijednost "auto", koja modelu prepušta odabir najprikladnijeg formata.

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

Razlika između sažetka i šifriranog rezoniranja

Ova su dva mehanizma komplementarna, ali različita:

AspektSažetak (generate_summary)Šifrirano (include)
ČitljivostObičan tekst, razumljivoŠifrirano, neprozirno
Primarna uporabaPrikaz korisniku, revizijaPonovna uporaba u narednim zahtjevima
Aktivacijareasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetaljnostKondenzirani sažetakPotpuno rezoniranje
DostupnostSamo Responses APISamo Responses API

Možeš istovremeno omogućiti oba mehanizma kako bi dobio i čitljivi sažetak i potpuno šifrirano rezoniranje:

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

Uobičajene kombinacije

Minimalna uporaba: Samo effort

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

Model rezonira s minimalnim naporom. Nema sažetka, nema vraćenog šifriranog rezoniranja.

Srednja uporaba: Effort + Sažetak

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

Model rezonira i pruža čitljivi sažetak. Idealno za aplikacije koje žele prikazati proces razmišljanja korisniku.

Potpuna uporaba: Effort + Sažetak + Šifrirano

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

Maksimalna konfiguracija: duboko rezoniranje, čitljivi sažetak i šifrirani sadržaj za ponovnu uporabu. Ovo rezerviraj za slučajeve kada ti treba sve.

Kada izostaviti objekt reasoning

Ako ne trebaš kontrolirati rezoniranje, jednostavno možeš izostaviti parametar reasoning. Model će koristiti svoje zadane postavke. To je valjano i model će i dalje rezonirati (budući da je grok-4.20-0309-reasoning po svojoj prirodi model za rezoniranje).

Ključne točke

  • Objekt reasoning dostupan je isključivo u Responses APIju
  • effort kontrolira dubinu (low, medium, high)
  • generate_summary proizvodi čitljivi sažetak rezoniranja (običan tekst)
  • summary: "auto" prepušta modelu odabir formata sažetka
  • Možeš kombinirati sažetak i šifrirano rezoniranje u istom zahtjevu
  • Izostavljanje reasoning je valjano: model rezonira sa zadanim postavkama