API Freagarthaí: Mionsonrú ar an Oibiacht `reasoning`
Ar an leathanach seo
An Oibiacht reasoning san API Freagarthaí
Tugann API Freagarthaí xAI smacht gráinníneach ar an réasúnaíocht trí oibiacht reasoning. Níl an paraiméadar seo ar fáil ach san API Freagarthaí (níl sé ar fáil i gComhlánuithe Comhrá) agus ligeann sé duit trí ghné de réasúnaíocht a chumrú: iarracht, giniúint achoimre, agus formáid na hachoimre.
Struchtúr Iomlán na hOibiachta reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Rialaíonn sé doimhneacht smaointeoireachta an mhúnla. Trí luach fhéideartha:
low: smaointeoireacht íosta, oiriúnach do thascanna simplímedium: cothromaíocht idir doimhneacht agus luashigh: uasmhéid smaointeoireachta do fhadhbanna casta
Is é an paraiméadar seo an coibhéis san API Freagarthaí le reasoning_effort i gComhlánuithe Comhrá, ach le luach breise medium.
generate_summary
Booleán a léiríonn ar cheart don mhúnla achoimre a tháirgeadh ar a phróiseas réasúnaíochta, i dteannta na freagra deiridh.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Nuair a shocraítear generate_summary ar true, bíonn eilimint bhreise sa fhreagra ina bhfuil achoimre ghonta ar an bpróiseas réasúnaíochta. Tá an achoimre seo i ngnáth-théacs (gan criptiú), rud a dhéanann idirdhealú idir í agus reasoning.encrypted_content.
summary
Rialaíonn sé formáid na hachoimre a ghintear. Faoi láthair, is é "auto" an t-aon luach atá doiciméadaithe, rud a ligeann don mhúnla an formáid is oiriúnaí a roghnú.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Difríocht idir Achoimre agus Réasúnaíocht Chriptithe
Tá an dá mheicníocht seo comhlántach ach ar leith:
| Gné | Achoimre (generate_summary) | Criptithe (include) |
|---|---|---|
| Inléiteacht | Gnáth-théacs, intuigthe | Criptithe, dofheicthe |
| Príomhúsáid | Taispeáint don úsáideoir, iniúchadh | Athúsáid in iarratais ina dhiaidh sin |
| Gníomhachtú | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Sonraí | Achoimre chomhdhlúite | Réasúnaíocht iomlán |
| Infhaighteacht | API Freagarthaí amháin | API Freagarthaí amháin |
Is féidir leat an dá cheann a chumasú ag an am céanna chun achoimre inléite agus an réasúnaíocht chriptithe iomlán a fháil:
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"]
)
Comhcheangail Choitianta
Úsáid Íosta: Iarracht Amháin
{
"reasoning": {
"effort": "low"
}
}
Déanann an múnla réasúnaíocht le hiarracht íosta. Ní thugtar aon achoimre ná réasúnaíocht chriptithe ar ais.
Úsáid Idirmheánach: Iarracht + Achoimre
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Déanann an múnla réasúnaíocht agus soláthraíonn sé achoimre inléite. Ideálach d’fheidhmchláir ar mian leo an próiseas smaointeoireachta a thaispeáint don úsáideoir.
Úsáid Iomlán: Iarracht + Achoimre + Criptithe
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Cumraíocht uasta: réasúnaíocht dhomhain, achoimre inléite, agus ábhar criptithe le haghaidh athúsáide. Cuir in áirithe é seo do chásanna ina bhfuil gá agat le gach rud.
Cathin an Oibiacht reasoning a Fhágáil ar Lár
Mura bhfuil gá agat smacht a bheith agat ar an réasúnaíocht, is féidir leat an paraiméadar reasoning a fhágáil ar lár go simplí. Úsáidfidh an múnla a shocruithe réamhshocraithe. Fanann sé seo bailí agus déanfaidh an múnla réasúnaíocht fós (óir is múnla réasúnaíochta é grok-4.20-0309-reasoning de réir nádúir).
Príomhphointí
- Níl an oibiacht
reasoningar fáil ach san API Freagarthaí - Rialaíonn
effortan doimhneacht (low,medium,high) - Cruthaíonn
generate_summaryachoimre inléite ar an réasúnaíocht (gnáth-théacs) - Ligeann
summary: "auto"don mhúnla formáid na hachoimre a roghnú - Is féidir leat achoimre agus réasúnaíocht chriptithe a chomhcheangal san iarratas céanna
- Tá sé bailí
reasoninga fhágáil ar lár: déanfaidh an múnla réasúnaíocht le socruithe réamhshocraithe