Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

API Freagarthaí: Mionsonrú ar an Oibiacht `reasoning`

Ceacht 7 as 12 Nuashonraithe 28 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An Oibiacht reasoning san API Freagarthaí
  2. Struchtúr Iomlán na hOibiachta reasoning
  3. Difríocht idir Achoimre agus Réasúnaíocht Chriptithe
  4. Comhcheangail Choitianta
  5. Cathin an Oibiacht reasoning a Fhágáil ar Lár
  6. Príomhphointí

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 luas
  • high: 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éiteachtGnáth-théacs, intuigtheCriptithe, dofheicthe
PríomhúsáidTaispeáint don úsáideoir, iniúchadhAthúsáid in iarratais ina dhiaidh sin
Gníomhachtúreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
SonraíAchoimre chomhdhlúiteRéasúnaíocht iomlán
InfhaighteachtAPI Freagarthaí amháinAPI 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 reasoning ar fáil ach san API Freagarthaí
  • Rialaíonn effort an doimhneacht (low, medium, high)
  • Cruthaíonn generate_summary achoimre 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í reasoning a fhágáil ar lár: déanfaidh an múnla réasúnaíocht le socruithe réamhshocraithe