Responses API: objekt reasoning lähemalt
Sellel lehel
Objekt reasoning Responses API-s
xAI Responses API pakub peenekoelist juhtimist arutluse üle objekti reasoning kaudu. See parameeter on saadaval ainult Responses API-s (mitte Chat Completionsis) ja võimaldab konfigureerida arutluse kolme aspekti: pingutus, kokkuvõtte genereerimine ja kokkuvõtte vorming.
Objekti reasoning täielik struktuur
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Juhib mudeli mõtlemise sügavust. Võimalikud on kolm väärtust:
low: minimaalne mõtlemine, sobib lihtsate ülesannete jaoksmedium: tasakaal sügavuse ja kiiruse vahelhigh: maksimaalne mõtlemine keerukate probleemide lahendamiseks
See parameeter on Responses API vaste parameetrile reasoning_effort Chat Completionsis, kuid lisandub väärtus medium.
generate_summary
Boole’i väärtus, mis näitab, kas mudel peaks lisaks lõppvastusele koostama oma arutluskäigu kokkuvõtte.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Kui generate_summary on määratud väärtusele true, sisaldab vastus täiendavat elementi, mis koosneb arutlusprotsessi lühikesest kokkuvõttest. See kokkuvõte on lihttekstina (krüpteerimata), mis eristab seda väljast reasoning.encrypted_content.
summary
Juhib genereeritud kokkuvõtte vormingut. Praegu on ainus dokumenteeritud väärtus "auto", mis jätab mudelile võimaluse valida kõige sobivam vorming.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Erinevus kokkuvõtte ja krüpteeritud arutluse vahel
Need kaks mehhanismi täiendavad teineteist, kuid on erinevad:
| Aspekt | Kokkuvõte (generate_summary) | Krüpteeritud (include) |
|---|---|---|
| Loetavus | Lihttekst, arusaadav | Krüpteeritud, läbipaistmatu |
| Peamine kasutusviis | Kasutajale kuvamine, auditeerimine | Taaskasutamine järgnevates päringutes |
| Aktiveerimine | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detailne sisu | Kondenseeritud kokkuvõte | Täielik arutluskäik |
| Saadavus | Ainult Responses API | Ainult Responses API |
Saad mõlemad samaaegselt lubada, et saada nii loetav kokkuvõte kui ka täielik krüpteeritud arutluskäik:
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"]
)
Levinud kombinatsioonid
Minimaalne kasutus: ainult pingutus
{
"reasoning": {
"effort": "low"
}
}
Mudel arutleb minimaalse pingutusega. Kokkuvõtet ega krüpteeritud arutlust ei tagastata.
Vahepealne kasutus: pingutus + kokkuvõte
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Mudel arutleb ja esitab loetava kokkuvõtte. Ideaalne rakendustele, mis soovivad kasutajale mõtlemisprotsessi näidata.
Täielik kasutus: pingutus + kokkuvõte + krüpteeritud
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maksimaalne konfiguratsioon: sügav arutlus, loetav kokkuvõte ja taaskasutamiseks mõeldud krüpteeritud sisu. Kasuta seda juhtudel, kui vajad kõike.
Millal jätta objekt reasoning kasutamata
Kui sa ei pea arutlust juhtima, võid parameetri reasoning lihtsalt ära jätta. Mudel kasutab vaikimisi seadeid. See on täiesti korrektne ja mudel arutleb ikka (kuna grok-4.20-0309-reasoning on oma olemuselt arutlev mudel).
Peamised punktid
- Objekt
reasoningon saadaval ainult Responses API-s effortjuhib sügavust (low,medium,high)generate_summaryloob arutluskäigu loetava kokkuvõtte (lihttekst)summary: "auto"jätab mudelile kokkuvõtte vormingu valiku- Saad samas päringus kombineerida kokkuvõtet ja krüpteeritud arutlust
reasoningärajätmine on lubatud: mudel arutleb vaikimisi seadetega