L-API tar-Responses: L-Oġġett reasoning fid-Dettall
F'din il-paġna
L-Oġġett reasoning fl-API tar-Responses
L-API tar-Responses ta’ xAI toffri kontroll fin fuq ir-raġunar permezz tal-oġġett reasoning. Dan il-parametru huwa disponibbli biss fl-API tar-Responses (mhux fil-Chat Completions) u jħallik tikkonfigura tliet aspetti tar-raġunar: l-isforz, il-ġenerazzjoni tas-sommarju, u l-format tas-sommarju.
L-Istruttura Sħiħa tal-Oġġett reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Jikkontrolla l-fond tal-ħsieb tal-mudell. Hemm tliet valuri possibbli:
low: ħsieb minimu, adattat għal kompiti sempliċimedium: bilanċ bejn il-fond u l-veloċitàhigh: ħsieb massimu għal problemi kumplessi
Dan il-parametru huwa l-ekwivalenti fl-API tar-Responses ta’ reasoning_effort fil-Chat Completions, iżda b’valur addizzjonali medium.
generate_summary
Boolean li jindika jekk il-mudell għandux jipproduċi sommarju tar-raġunar tiegħu minbarra t-tweġiba finali.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Meta generate_summary ikun issettjat għal true, ir-risposta tkun fiha element addizzjonali b’sommarju konċiż tal-proċess tar-raġunar. Dan is-sommarju jkun f’test ċar (mhux iċċifrjat), li jiddistingwih minn reasoning.encrypted_content.
summary
Jikkontrolla l-format tas-sommarju ġġenerat. Bħalissa, l-uniku valur iddokumentat huwa "auto", li jħalli lill-mudell jagħżel l-aktar format xieraq.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Id-Differenza Bejn is-Sommarju u r-Raġunar Iċċifrjat
Dawn iż-żewġ mekkaniżmi huma komplementari iżda distinti:
| Aspett | Sommarju (generate_summary) | Iċċifrjat (include) |
|---|---|---|
| Leġibbiltà | Test ċar, li jinftiehem | Iċċifrjat, opaku |
| Użu primarju | Wirja lill-utent, awditjar | Użu mill-ġdid f’talbiet sussegwenti |
| Attivazzjoni | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Dettall | Sommarju kondensat | Raġunar sħiħ |
| Disponibbiltà | API tar-Responses biss | API tar-Responses biss |
Tista’ tattivahom it-tnejn fl-istess ħin biex tikseb kemm sommarju li jinqara kif ukoll ir-raġunar iċċifrjat sħiħ:
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"]
)
Kombinazzjonijiet Komuni
Użu Minimu: Effort Biss
{
"reasoning": {
"effort": "low"
}
}
Il-mudell jirraġuna b’isforz minimu. L-ebda sommarju, l-ebda raġunar iċċifrjat ma jiġi rritornat.
Użu Intermedjarju: Effort + Sommarju
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Il-mudell jirraġuna u jipprovdi sommarju li jinqara. Ideali għal applikazzjonijiet li jridu juru l-proċess tal-ħsieb lill-utent.
Użu Sħiħ: Effort + Sommarju + Iċċifrjat
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Konfigurazzjoni massima: raġunar fond, sommarju li jinqara, u kontenut iċċifrjat għall-użu mill-ġdid. Irriżerva dan għal każijiet fejn teħtieġ kollox.
Meta Tħalli Barra l-Oġġett reasoning
Jekk m’għandekx bżonn tikkontrolla r-raġunar, tista’ sempliċiment tħalli barra l-parametru reasoning. Il-mudell se juża l-issettjar predefinit tiegħu. Dan jibqa’ validu u l-mudell xorta jirraġuna (peress li grok-4.20-0309-reasoning huwa mudell tar-raġunar fin-natura tiegħu).
Punti Ewlenin
- L-oġġett
reasoninghuwa disponibbli biss fl-API tar-Responses effortjikkontrolla l-fond (low,medium,high)generate_summaryjipproduċi sommarju li jinqra tar-raġunar (test ċar)summary: "auto"iħalli lill-mudell jagħżel il-format tas-sommarju- Tista’ tgħaqqad is-sommarju u r-raġunar iċċifrjat fl-istess talba
- Li tħalli barra
reasoninghuwa validu: il-mudell jirraġuna bl-issettjar predefinit