Responses API: išsamus apie objektą reasoning
Šiame puslapyje
Objektas reasoning Responses API
xAI Responses API suteikia tikslų valdymą samprotavimui per objektą reasoning. Šis parametras galimas tik Responses API (ne Chat Completions) ir leidžia konfigūruoti tris samprotavimo aspektus: pastangų lygį, santraukos generavimą ir santraukos formatą.
Pilna objekto reasoning struktūra
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Valdo modelio mąstymo gylį. Galimos trys reikšmės:
low: minimalus mąstymas, tinkamas paprastoms užduotimsmedium: balansas tarp gylio ir greičiohigh: maksimalus mąstymas sudėtingoms problemoms spręsti
Šis parametras yra Responses API atitikmuo reasoning_effort iš Chat Completions, tačiau turi papildomą medium reikšmę.
generate_summary
Būlio reikšmė, nurodanti, ar modelis turi pateikti savo samprotavimų santrauką kartu su galutiniu atsakymu.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Kai generate_summary nustatyta į true, atsakyme atsiranda papildomas elementas su glaustu samprotavimo proceso apibūdinimu. Ši santrauka yra paprastuoju tekstu (neužšifruota), o tai ją skiria nuo reasoning.encrypted_content.
summary
Valdo generuojamos santraukos formatą. Šiuo metu vienintelė dokumentuota reikšmė yra "auto", kuri leidžia modeliui pačiam pasirinkti tinkamiausią formatą.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Skirtumas tarp santraukos ir užšifruoto samprotavimo
Šie du mechanizmai papildo vienas kitą, tačiau yra skirtingi:
| Aspektas | Santrauka (generate_summary) | Užšifruota (include) |
|---|---|---|
| Skaitomumas | Paprastasis tekstas, suprantamas | Užšifruotas, nepermatomas |
| Pagrindinis naudojimas | Rodymas naudotojui, auditas | Pakartotinis naudojimas vėlesniuose užklausose |
| Aktyvavimas | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detalumas | Glausta santrauka | Pilnas samprotavimas |
| Prieinamumas | Tik Responses API | Tik Responses API |
Gali vienu metu įjungti abu mechanizmus, kad gautum tiek skaitomą santrauką, tiek visą užšifruotą samprotavimą:
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"]
)
Dažni deriniai
Minimalus naudojimas: tik pastangos
{
"reasoning": {
"effort": "low"
}
}
Modelis samprotauja minimaliomis pastangomis. Grąžinama nei santrauka, nei užšifruotas samprotavimas.
Tarpinis naudojimas: pastangos + santrauka
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Modelis samprotauja ir pateikia skaitomą santrauką. Idealu programoms, kurios nori rodyti mąstymo eigą naudotojui.
Pilnas naudojimas: pastangos + santrauka + užšifravimas
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maksimali konfigūracija: gilus samprotavimas, skaitoma santrauka ir užšifruotas turinis pakartotiniam naudojimui. Naudok tai tik tais atvejais, kai tau reikia visko.
Kada praleisti objektą reasoning
Jei tau nereikia valdyti samprotavimo, gali tiesiog nepridėti parametro reasoning. Modelis naudos numatytuosius nustatymus. Tai yra galiojantis veiksmas, ir modelis vis tiek samprotaus (kadangi grok-4.20-0309-reasoning iš esmės yra samprotavimo modelis).
Svarbiausi punktai
- Objektas
reasoninggalimas tik Responses API effortvaldo gylį (low,medium,high)generate_summarysukuria skaitomą samprotavimo santrauką (paprastasis tekstas)summary: "auto"leidžia modeliui pasirinkti santraukos formatą- Gali derinti santrauką ir užšifruotą samprotavimą tame pačiame užklausime
- Praleidus
reasoning, viskas veikia: modelis samprotauja naudodamas numatytuosius nustatymus