Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Päringu parameetrid

Õppetund 3 / 16 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Mudeli käitumise juhtimine
  2. Generatsiooniparameetrid
  3. Vestlusparameetrid
  4. Tööriistade parameetrid
  5. Parameetrite kokkuvõte
  6. Peamised punktid

Uuendatud 3. novembril 2026. Lähtudes Responses API dokumentatsioonist ja xAi parimatest tavadest: soovitatav temperatuur on 0,7 (maksimum 1); top_p vaikeväärtusega 0,95; max_output_tokens piirab ainult nähtavat vastust (vaikimisi 128 000, arutluskäik ei kuulu hulka); arutluse intensiivsus on reserveeritud mudelitele grok-4.5 kuni 4.7. Allikad: Responses API · Parimad tavad.

Mudeli käitumise juhtimine

Lisaks parameetritele model, input ja instructions pakub Responses API arvukalt võimalusi Groki käitumise täpseks häälestamiseks. Nende parameetrite mõistmine aitab sul saada oma vajadustest lähtuvalt asjakohasemaid, lühemaid või loovamaid vastuseid.

Generatsiooniparameetrid

temperature

Juhib vastuste juhuslikkust. API aktsepteerib väärtusi vahemikus 0 kuni 2, kuid kõik üle 1 olevad väärtused ümardatakse 1-ni.

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

xAi parimad tavad on selged: sea temperature väärtuseks 0,7 ja ära kaldu sellest kaugele, sest Groki mudelid reageerivad teistele proovivõtuseadistustele halvasti. Faktilisema või loovama tooni saavutamiseks kohanda pigem sisendit (prompt) kui temperatuuri.

top_p

Tuumaproovivõtt (nucleus sampling). Praegused teksti mudelid kasutavad vaikeväärtusena 0,95 ja kõik mudeli vaikeseadistusest suuremad väärtused vähendatakse sellele tasemele.

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

Väärtusega top_p: 0.95 arvestab mudel ainult neid tokeneid, mis moodustavad 95% tõenäosusest. API dokumentatsioon kordab klassikalist nõuannet kohandada ainult üht kahest parameetrist, kuid xAi parimad tavad nõuavad mõlema parameetri igal päringul selget määramist väärtustele vastavalt 0,7 ja 0,95.

max_output_tokens

Piirab nähtavas vastuses olevate tokenite arvu; arutluskäik ja funktsioonikutsed ei kuulu sellesse piirangusse ning vaikeväärtus on 128 000 tokenit:

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

Arutlusvõimega mudelite puhul reguleerib sisemist mõtlemist pigem arutluse intensiivsus (reasoning effort) kui see piirang. Kui vastus katkeb piirangu tõttu, märgitakse see olekuga incomplete.

reasoning

Mudelite puhul, mis toetavad arutlemist, saad reguleerida pingutuse taset:

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

Võimalikud väärtused on low, medium ja high (vaikimisi), lisaks xhigh mudelite grok-4.6 ja grok-4.7 puhul; parameeter kehtib mudelitele grok-4.5 kuni 4.7, kuid grok-4.20-0309-reasoning seda ei aktsepteeri. Kõrge pingutustase tarbib rohkem tokeneid ja sobib keerukate ülesannete lahendamiseks.

Vestlusparameetrid

store

Määrab, kas vastust salvestatakse serveripoolselt:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: vastus salvestatakse 30 päevaks, seda saab kätte GET-päringuga ja kasutada koos previous_response_id-ga
  • false: vastust ei salvestata (privaatne režiim)

previous_response_id

Seob uue päringu olemasoleva vestlusega (täpsemalt käsitletud 5. õppetükis).

user

Lõppkasutaja identifikaator, kasulik jälgimiseks ja modereerimiseks:

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

Tööriistade parameetrid

tools, tool_choice, parallel_tool_calls, max_turns

Need parameetrid kontrollivad tööriistade kasutamist (veebiotsing, koodi interpretaator, kohandatud funktsioonid). Neid käsitletakse üksikasjalikult jaos „Tööriistad“ (õppetükid 9–12).

Parameetrite kokkuvõte

ParameeterTüüpVaikimisiKasutus
modelstringnõutavMudeli identifikaator
inputstring/arraynõutavKasutaja sisend
instructionsstringnullSüsteemi sisend
temperaturenumber—Soovitatav 0,7; piiratud 1-ga
top_pnumber0.95Tuumaproovivõtt
max_output_tokensinteger128,000Nähtava vastuse piirang
reasoningobjectnullArutluse intensiivsus
storebooleannull30-päevane säilitamine
streambooleanfalseSSE voogedastus
userstringnullLõppkasutaja ID

Peamised punktid

  • xAi soovitab määrata temperature väärtuseks 0,7 ja top_p väärtuseks 0,95, mõlemad sõnaselgelt
  • max_output_tokens piirab ainult nähtavat vastust, jättes arutluskäigu välja
  • store: true säilitab vastuse 30 päeva jooksul, võimaldades vestluse aheldamist
  • reasoning.effort võimaldab skaleerida mudeli mõtlemist vastavalt ülesande keerukusele
  • Parameeter user aitab xAi poolt teha jälgimist ja modereerimist