Responses API: Podroben pregled predmeta reasoning
Na tej strani
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 nalogemedium: ravnovesje med globino in hitrostjohigh: 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:
| Vidik | Povzetek (generate_summary) | Šifrirano (include) |
|---|---|---|
| Berljivost | Navadno besedilo, razumljivo | Šifrirano, neprozorno |
| Primarna uporaba | Prikaz uporabniku, revizija | Ponovna uporaba v naslednjih zahtevkih |
| Aktivacija | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Podrobnost | Jedrnat povzetek | Polno sklepanje |
| Razpoložljivost | Samo Responses API | Samo 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
reasoningje na voljo samo v Responses API effortkrmili globino (low,medium,high)generate_summaryustvari berljiv povzetek sklepanja (navadno besedilo)summary: "auto"modelu omogoča izbiro oblike povzetka- Povzetek in šifrirano sklepanje lahko združiš v istem zahtevku
- Izpustitev
reasoningje veljavna: model sklepa s privzetimi nastavitvami