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

Sforz tar-Raġunar: Baxx, Medju u Għoli

Lezzjoni 4 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ikkontrolla l-Fond tar-Raġunar
  2. Livelli ta’ Sforz
  3. Impatt fuq it-Tokens
  4. Tagħżel il-Livell It-Tajjeb
  5. Eżempju Prattiku: L-Istess Mistoqsija, Tliet Sforzi
  6. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026 abbażi tar-referenza tal-API ta’ xAI: max_completion_tokens jillimita biss ir-risposta viżibbli; it-tokens tar-raġunar ma jgħoddux għal dan il-limitu, u l-isforz jikkontrolla l-kwantità tagħhom. Sors: Chat Completions. Addendum tat-3 ta’ Novembru: Il-lezzjoni preċedentement kienet torbot l-isforz mal-API (Chat Completions jew Responses) u applikatuh għal grok-4.20-0309-reasoning, li ma jappoġġjax dan; skont il-paġna Reasoning ta’ xAI, dan jiddependi mill-mudell (grok-4.7, grok-4.6, grok-4.5, grok-4.20-multi-agent). L-eżempju qara wkoll usage.completion_tokens, li huwa nieqes mir-risponsi tal-API tar-Responses (output_tokens, output_tokens_details.reasoning_tokens). Sors: Reasoning.

Ikkontrolla l-Fond tar-Raġunar

L-isforz tar-raġunar jippermettilek tikkalibra kemm il-mudell jaħseb qabel ma jwieġeb. Din hija leva diretta biex tibbilanċja l-kwalità, il-veloċità u l-konsum tat-tokens.

Il-mudell jiddetermina d-disponibbiltà, mhux l-API. Skont id-dokumentazzjoni ta’ xAI:

MudellSforzValuri
grok-4.7, grok-4.6Fond tar-raġunarlow, medium, high (default), xhigh
grok-4.5Fond tar-raġunarlow, medium, high (default); xhigh jiġi ttrattat bħala high
grok-4.20-multi-agentNumru ta’ aġenti mobilizzati (4 jew 16), mhux fondlow, medium, high, xhigh
grok-4.20-0309-reasoningMhux konfigurabbli: il-mudell dejjem jirraġuna—

Ir-raġunar ma jistax jiġi diżattivat fuq dawn il-mudelli: mingħajr konfigurazzjoni, l-isforz huwa awtomatikament high. biss l-isem tal-parametru jinbidel skont l-API: reasoning_effort fil-livell superjuri f’Chat Completions, reasoning.effort ġewwa oġġett reasoning bl-API tar-Responses.

{
  "model": "grok-4.7",
  "input": "Solve the system of equations: 3x + 2y = 12, x - y = 1",
  "reasoning": {
    "effort": "medium"
  }
}

Livelli ta’ Sforz

Id-dokumentazzjoni tiddeskrivi kull livell u l-użu xieraq tiegħu:

  • low: Juża ftit raġunar filwaqt li jibqa’ mgħaġġel. Għal użi aġentiċi sensittivi għal-latency u sejħiet sempliċi għal għodod.
  • medium: Aktar riflessjoni, għal applikazzjonijiet inqas sensittivi għal-latency. Għal analiżi kumplessa tad-data u raġunar fuq kuntesti twal.
  • high (default): Ħafna aktar tokens tar-raġunar. Għal problemi diffiċli ħafna, matematika kumplessa, loġika b’diversi passi.
  • xhigh: Fond massimu, bil-latency korrispondenti. Għall-aktar problemi iebsa, meta l-kwalità tkun aktar importanti mill-ħin tar-rispons.

L-aħjar prattiki ta’ xAI jżidu regola sempliċi: issettja l-isforz b’mod espliċitu fuq kull talba, u irreġistrah ma’ kull riżultat, sabiex il-kejl tiegħek jibqa’ komparabbli.

Il-mudelli tar-raġunar jiċħdu wkoll tliet parametri: presence_penalty, frequency_penalty, u stop se jfallu t-talba.

Impatt fuq it-Tokens

Il-livell ta’ sforz għandu impatt dirett fuq il-konsum tat-tokens tar-raġunar:

  • low: Ftitt tokens tar-raġunar, rispons mgħaġġel, kost baxx
  • medium: Konsum moderat, kompromess tajjeb
  • high u xhigh: Ħafna tokens tar-raġunar, rispons aktar bil-mod, kost għoli

Dawn it-tokens tar-raġunar jiġu ffratturati bħala tokens tal-output (ara l-Lezzjoni 8). Il-limitu tal-output (max_completion_tokens f’Chat Completions, max_output_tokens fl-API tar-Responses) jillimita biss ir-rispons viżibbli: ir-raġunar ma jgħoddx għalih, għalhekk l-isforz jikkontrolla l-kwantità tagħhom.

Tagħżel il-Livell It-Tajjeb

KompituSforz Rakkomandat
Klassifikazzjoni tat-testlow
Sommarju b’analiżimedium
Estrazzjoni strutturata ta’ entitajietlow
Soluzzjoni ta’ ekwazzjonijiethigh
Analiżi ta’ bugs fil-kodiċihigh
Riformulazzjoni tat-testlow
Tqabbil ta’ għażliet b’vantaġġi/iżvantaġġimedium
Prova matematikahigh

Eżempju Prattiku: L-Istess Mistoqsija, Tliet Sforzi

for effort in ["low", "medium", "high"]:
    response = client.responses.create(
        model="grok-4.7",
        input="Explain why 0.1 + 0.2 != 0.3 in computing.",
        reasoning={"effort": effort},
    )
    usage = response.usage
    print(f"Effort {effort}: {usage.output_tokens} output tokens, "
          f"including {usage.output_tokens_details.reasoning_tokens} reasoning tokens")

Id-differenza bejn il-livelli tiddependi mill-mistoqsija: kejjilha fuq il-każijiet tiegħek stess minflok ma tiddependi fuq proporzjon ġenerali, u irreġistra l-isforz ma’ kull riżultat.

Punti Ewlenin

  • L-isforz jiddependi mill-mudell: low, medium, high (default), u xhigh fuq grok-4.7 u grok-4.6, mingħajr xhigh fuq grok-4.5; grok-4.20-0309-reasoning ma jappoġġjax dan
  • reasoning_effort f’Chat Completions, reasoning.effort fl-API tar-Responses; ir-raġunar ma jistax jiġi diżattivat
  • Il-livell ta’ sforz jaffettwa direttament in-numru ta’ tokens tar-raġunar u għalhekk l-ispejjeż
  • Mingħajr konfigurazzjoni, l-isforz huwa awtomatikament high: issettjah b’mod espliċitu fuq kull talba, kif jirrakkomanda xAI
  • Adatta l-isforz għall-kumplessità attwali tal-kompitu biex tottimizza l-ispejjeż