Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Pieprasījuma parametri

Nodarbība 3 no 16 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Modeļa uzvedības vadība
  2. Ģenerēšanas parametri
  3. Sarunu parametri
  4. Rīku parametri
  5. Parametru kopsavilkums
  6. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī. Pamatojoties uz Responses API atsauces dokumentāciju un xAI labākās prakses ieteikumiem: ieteicamā temperatūra ir 0,7 (maksimāli 1); top_p pēc noklusējuma ir 0,95; max_output_tokens attiecas tikai uz redzamo atbildi (noklusējums 128 000, spriešana netiek ieskaitīta); spriešanas intensitāte (reasoning effort) ir pieejama tikai modeļiem no grok-4.5 līdz 4.7. Avoti: Responses API · Labākā prakse.

Modeļa uzvedības vadība

Papildus parametriem model, input un instructions, Responses API piedāvā daudzus citus parametrus, lai precīzi pielāgotu Grok uzvedību. Izprotot šos parametrus, tu vari iegūt atbildes, kas ir atbilstošākas, īsākas vai radošākas atkarībā no tavām vajadzībām.

Ģenerēšanas parametri

temperature (temperatūra)

Kontrolē atbilžu nejaušības pakāpi. API pieņem vērtības no 0 līdz 2, taču jebkura vērtība virs 1 tiek automātiski samazināta līdz 1.

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

xAI labākās prakses vadlīnijas ir skaidras: iestati temperature uz 0,7 un nenovirzies no šīs vērtības, jo Grok modeļi reaģē slikti uz citiem izlases iestatījumiem. Ja vēlies mainīt toni uz faktoloģiskāku vai radošāku, pielāgo promptu, nevis temperatūru.

top_p

Kodola izlase (nucleus sampling). Pašreizējiem teksta modeļiem noklusējuma vērtība ir 0,95, un jebkura vērtība, kas pārsniedz modeļa noklusējumu, tiek samazināta līdz tam.

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

Iestatot top_p: 0.95, modelis ņem vērā tikai tos tokenus, kas veido 95 % no varbūtības sadalījuma. Lai gan API atsauces dokumentācija atkārto klasisko padomu mainīt tikai vienu no abiem parametriem, xAI labākā prakse prasa katrā pieprasījumā eksplicīti iestatīt abus: temperature uz 0,7 un top_p uz 0,95.

max_output_tokens

Ierobežo tokenus skaitu redzamajā atbildē; spriešanas procesi un funkciju izsaukumi netiek ieskaitīti, un noklusējuma vērtība ir 128 000 tokeni:

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

Spriešanas modeļiem iekšējo refleksiju regulē nevis šis limits, bet gan spriešanas intensitāte (reasoning effort). Ja atbilde tiek pārtraukta šī limita dēļ, tas tiek signalizēts ar statusu incomplete.

reasoning (spriešana)

Modeļiem, kas atbalsta spriešanu, tu vari pielāgot intensitāti:

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

Iespējamās vērtības ir low, medium un high (noklusējums), kā arī xhigh modeļiem grok-4.6 un grok-4.7. Šis parametrs attiecas uz modeļiem no grok-4.5 līdz 4.7, bet grok-4.20-0309-reasoning to nepieņem. Augsta intensitāte patērē vairāk tokenus un ir piemērota sarežģītām problēmām.

Sarunu parametri

store (glabāšana)

Nosaka, vai atbilde tiek glabāta servera pusē:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: atbilde tiek glabāta 30 dienas, to var izgūt, izmantojot GET pieprasījumu, un izmantot kopā ar previous_response_id.
  • false: atbilde netiek saglabāta (privātais režīms).

previous_response_id

Sasaista jaunu pieprasījumu ar esošu sarunu (detalizēti aplūkots 5. nodarbībā).

user (lietotājs)

Beigu lietotāja identifikators, kas noder izsekošanai un moderācijai:

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

Rīku parametri

tools, tool_choice, parallel_tool_calls, max_turns

Šie parametri kontrolē rīku (web_search, code_interpreter, pielāgotas funkcijas) izmantošanu. Tie detalizēti aplūkoti sadaļā „Rīki” (9.–12. nodarbība).

Parametru kopsavilkums

ParametrsTipsNoklusējumsLietojums
modelvirknenepieciešamsModeļa identifikators
inputvirkne/masīvsnepieciešamsLietotāja prompts
instructionsvirknenullSistēmas prompts
temperatureskaitlis—Ieteicams 0,7; maksimāli 1
top_pskaitlis0.95Kodola izlase
max_output_tokensvesels skaitlis128 000Redzamās atbildes limits
reasoningobjektsnullSpriešanas intensitāte
storeloģisksnull30 dienu saglabāšana
streamloģisksfalseSSE straumēšana
uservirknenullBeigu lietotāja ID

Galvenās atziņas

  • xAI iesaka eksplicīti iestatīt temperature uz 0,7 un top_p uz 0,95.
  • max_output_tokens ierobežo tikai redzamo atbildi, neieskaitot spriešanas procesu.
  • store: true saglabā atbildi uz 30 dienām, lai nodrošinātu sarunu ķēdes veidošanu.
  • reasoning.effort ļauj mērogot modeļa refleksiju atkarībā no uzdevuma sarežģītības.
  • Parametrs user palīdz xAI pusē veikt izsekošanu un moderāciju.