Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

L-API tar-Responses: L-Oġġett reasoning fid-Dettall

Lezzjoni 7 / 12 Aġġornat 28 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. L-Oġġett reasoning fl-API tar-Responses
  2. L-Istruttura Sħiħa tal-Oġġett reasoning
  3. Id-Differenza Bejn is-Sommarju u r-Raġunar Iċċifrjat
  4. Kombinazzjonijiet Komuni
  5. Meta Tħalli Barra l-Oġġett reasoning
  6. Punti Ewlenin

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ċi
  • medium : 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:

AspettSommarju (generate_summary)Iċċifrjat (include)
LeġibbiltàTest ċar, li jinftiehemIċċifrjat, opaku
Użu primarjuWirja lill-utent, awditjarUżu mill-ġdid f’talbiet sussegwenti
Attivazzjonireasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DettallSommarju kondensatRaġunar sħiħ
DisponibbiltàAPI tar-Responses bissAPI 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 reasoning huwa disponibbli biss fl-API tar-Responses
  • effort jikkontrolla l-fond (low, medium, high)
  • generate_summary jipproduċ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 reasoning huwa validu: il-mudell jirraġuna bl-issettjar predefinit