Responses API: Objekt reasoning u detalje
Na ovoj stranici
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 zadatkemedium: balans između dubine i brzinehigh: 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:
| Aspekt | Sažetak (generate_summary) | Šifrirano (include) |
|---|---|---|
| Čitljivost | Običan tekst, razumljivo | Šifrirano, neprozirno |
| Primarna uporaba | Prikaz korisniku, revizija | Ponovna uporaba u narednim zahtjevima |
| Aktivacija | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detaljnost | Kondenzirani sažetak | Potpuno rezoniranje |
| Dostupnost | Samo Responses API | Samo 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
reasoningdostupan je isključivo u Responses APIju effortkontrolira dubinu (low,medium,high)generate_summaryproizvodi č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
reasoningje valjano: model rezonira sa zadanim postavkama