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

Paraiméadair Iarratais

Ceacht 3 as 16 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Iompar an mhúnla a rialú
  2. Paraiméadair ghiniúna
  3. Paraiméadair chomhrá
  4. Paraiméadair uirlisí
  5. Achoimre paraiméadar
  6. Príomhphointí

Nuashonraithe an 3 Samhain, 2026. Bunaithe ar thagairt API na bhFreagraí agus ar dhea-chleachtais xAI: teocht mholta 0.7, teoranta ag 1; top_p 0.95 mar réamhshocrú; max_output_tokens teoranta don fhreagra infheicthe (128,000 mar réamhshocrú, an réasúnaíocht eisiata); tá iarracht réasúnaíochta curtha in áirithe do grok-4.5 go 4.7. Foincí: API na bhFreagraí · Dea-chleachtais.

Iompar an mhúnla a rialú

Chomh maith le model, input, agus instructions, tairgeann API na bhFreagraí paraiméadair iomadúla chun iompar Grok a mhionchoigeartú. Trí na paraiméadair seo a thuiscint, is féidir leat freagraí níos ábhartha, níos giorra, nó níos cruthaithí a fháil ag brath ar do riachtanais.

Paraiméadair ghiniúna

temperature

Rialaíonn sé randamacht na bhfreagraí. Glacann an API le luachanna ó 0 go 2, ach sampláiltear aon rud os cionn 1 ag 1.

{
  "model": "grok-4.7",
  "input": "Write a slogan for a bakery.",
  "temperature": 0.7,
  "top_p": 0.95
}

Tá dea-chleachtais xAI soiléir: socraigh temperature ar 0.7 agus ná téigh i bhfad uaidh, toisc go n-imíonn múnlaí Grok go dona le socruithe samplála eile. Chun tón níos fíriciúil nó níos cruthaithí a fháil, coigeartaigh an leid seachas an teocht.

top_p

Sampláil núicléis. Is é 0.95 an réamhshocrú do mhúnlaí téacs reatha, agus laghdaítear aon luach atá níos airde ná réamhshocrú an mhúnla chuige sin.

{
  "model": "grok-4.7",
  "input": "Summarize this article.",
  "top_p": 0.95
}

Le top_p: 0.95, ní mheasann an múnla ach na tokenanna a dhéanann suas 95% den dóchúlacht. Déanann an tagairt API an comhairle chlasaiceach a athrá nach gceart ach ceann amháin den dá pharaiméadar a choigeartú; éilíonn dea-chleachtais xAI ina ionad sin go socraítear an dá cheann go sainráite, ar 0.7 agus 0.95, ar gach iarratas.

max_output_tokens

Teoraíonn sé líon na tokenanna sa fhreagra infheicthe; ní áirítear réasúnaíocht ná glaonna feidhme, agus is é 128,000 token an luach réamhshocraithe:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Explain general relativity.",
  "max_output_tokens": 500
}

I gcás múnlaí réasúnaíochta, is é iarracht na réasúnaíochta, seachas an teorainn seo, a rialaíonn an machnamh inmheánach. Cuirtear in iúl freagra a ghearrtar de bharr na teorann le stádas incomplete.

reasoning

Do mhúnlaí a thacaíonn le réasúnaíocht, is féidir leat an iarracht a choigeartú:

{
  "model": "grok-4.7",
  "input": "Solve this logic problem.",
  "reasoning": {"effort": "high"}
}

Is iad low, medium, agus high (réamhshocrú) na luachanna féideartha, chomh maith le xhigh ar grok-4.6 agus grok-4.7; baineann an paraiméadar le grok-4.5 go 4.7, agus ní ghlacann grok-4.20-0309-reasoning leis. Úsáideann iarracht ard níos mó tokenanna agus oireann sé d’fhadhbanna casta.

Paraiméadair chomhrá

store

Cinneann sé an stóráiltear an fhreagra ar an taobh freastalaí:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: stóráiltear an fhreagra ar feadh 30 lá, in-aisghabhála trí GET, inúsáidte le previous_response_id
  • false: ní dhéantar an fhreagra a bhuanú (mód príobháideach)

previous_response_id

Nascann sé iarratas nua le comhrá atá ann cheana (mionsonraithe i gcacht 5).

user

Aitheantóir an úsáideora deiridh, úsáideach le haghaidh rianaithe agus measúnaithe:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Hello",
  "user": "user-12345"
}

Paraiméadair uirlisí

tools, tool_choice, parallel_tool_calls, max_turns

Rialaíonn na paraiméadair seo úsáid uirlisí (web_search, code_interpreter, feidhmeanna saincheaptha). Clúdaítear iad go mion sa chuid “Uirlisí” (ceachtanna 9-12).

Achoimre paraiméadar

ParaiméadarCineálRéamhshocrúÚsáid
modelteaghránriachtanachAitheantóir an mhúnla
inputteaghrán/eagarriachtanachLeid an úsáideora
instructionsteaghránnullLeid an chórais
temperatureuimhir—0.7 molta; teoranta ag 1
top_puimhir0.95Sampláil núicléis
max_output_tokensslánuimhir128,000Teorainn na freagra infheicthe
reasoningoibiachtnullIarracht réasúnaíochta
storeboolenullBuanú 30 lá
streamboolefalseSruthú SSE
userteaghránnullAitheantas an úsáideora deiridh

Príomhphointí

  • Molann xAI temperature ag 0.7 agus top_p ag 0.95, socraithe go sainráite
  • Ní theorannaíonn max_output_tokens ach an fhreagra infheicthe, gan an réasúnaíocht a áireamh
  • Coinníonn store: true an fhreagra ar feadh 30 lá chun slabhrú comhrá a dhéanamh
  • Ligeann reasoning.effort duit machnamh an mhúnla a scálú bunaithe ar chastacht na tasc
  • Cabhraíonn an paraiméadar user le rianú agus measúnú ar thaobh xAI