API Responses: objekts reasoning detalizēti
Šajā lapā
Objekts reasoning API Responses
xAI API Responses piedāvā smalku kontroli pār spriešanu, izmantojot objektu reasoning. Šis parametrs ir pieejams tikai API Responses (nevis Chat Completions) un ļauj konfigurēt trīs spriešanas aspektus: piepūli, kopsavilkuma ģenerēšanu un kopsavilkuma formātu.
Pilna objekta reasoning struktūra
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Kontrolē modeļa domāšanas dziļumu. Iespējamas trīs vērtības:
low: minimāla domāšana, piemērota vienkāršiem uzdevumiemmedium: līdzsvars starp dziļumu un ātrumuhigh: maksimāla domāšana sarežģītām problēmām
Šis parametrs API Responses ir ekvivalents reasoning_effort pakalpojumā Chat Completions, taču ar papildu vērtību medium.
generate_summary
Būla vērtība, kas norāda, vai modelim papildus galīgajai atbildei jāizveido sava spriešanas procesa kopsavilkums.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Kad generate_summary ir iestatīts uz true, atbilde satur papildu elementu ar kodolīgu spriešanas procesa kopsavilkumu. Šis kopsavilkums ir parastā tekstā (nešifrēts), kas to atšķir no reasoning.encrypted_content.
summary
Kontrolē ģenerētā kopsavilkuma formātu. Pagaidām vienīgā dokumentētā vērtība ir "auto", kas ļauj modelim izvēlēties vispiemērotāko formātu.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Atšķirība starp kopsavilkumu un šifrētu spriešanu
Šie divi mehānismi ir papildinoši, bet atšķirīgi:
| Aspekts | Kopsavilkums (generate_summary) | Šifrēts (include) |
|---|---|---|
| Lasāmība | Parasts teksts, saprotams | Šifrēts, neskaidrs |
| Pamatlietojums | Lietotāja displejs, audits | Atkārtota izmantošana turpmākos pieprasījumos |
| Aktivizēšana | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detalizācija | Kondensēts kopsavilkums | Pilns spriešanas process |
| Pieejamība | Tikai API Responses | Tikai API Responses |
Tu vari aktivizēt abus vienlaicīgi, lai iegūtu gan lasāmu kopsavilkumu, gan pilnu šifrētu spriešanu:
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"]
)
Biežākās kombinācijas
Minimāls lietojums: tikai piepūle
{
"reasoning": {
"effort": "low"
}
}
Modelis veic spriešanu ar minimālu piepūli. Netiek atgriezts ne kopsavilkums, ne šifrēta spriešana.
Vidējs lietojums: piepūle + kopsavilkums
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Modelis veic spriešanu un sniedz lasāmu kopsavilkumu. Ideāli piemērots lietotnēm, kas vēlas lietotājam parādīt domāšanas procesu.
Pilns lietojums: piepūle + kopsavilkums + šifrēts saturs
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maksimāla konfigurācija: dziļa spriešana, lasāms kopsavilkums un šifrēts saturs atkārtotai izmantošanai. Paturēši to gadījumiem, kad tev nepieciešams viss.
Kad izlaist objektu reasoning
Ja tev nav nepieciešams kontrolēt spriešanu, vari vienkārši izlaist parametru reasoning. Modelis izmantos savus noklusējuma iestatījumus. Tas joprojām ir derīgi, un modelis joprojām veiks spriešanu (jo grok-4.20-0309-reasoning pēc savas būtības ir spriešanas modelis).
Galvenās atziņas
- Objekts
reasoningir pieejams tikai API Responses effortkontrolē dziļumu (low,medium,high)generate_summaryģenerē lasāmu spriešanas kopsavilkumu (parasts teksts)summary: "auto"ļauj modelim izvēlēties kopsavilkuma formātu- Tu vari apvienot kopsavilkumu un šifrētu spriešanu vienā pieprasījumā
- Parametra
reasoningizlaišana ir derīga: modelis veic spriešanu ar noklusējuma iestatījumiem