Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Pyyntöparametrit

Oppitunti 3 / 16 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Mallin toiminnan ohjaus
  2. Generointiparametrit
  3. Keskusteluparametrit
  4. Työkaluparametrit
  5. Parametrien yhteenveto
  6. Keskeiset asiat

Päivitetty 3. marraskuuta 2026. Perustuu Responses API -viitteeseen ja xAI:n parhaisiin käytäntöihin: suositeltu lämpötila 0,7, yläraja 1; top_p oletuksena 0,95; max_output_tokens rajoitettu näkyvään vastaukseen (oletus 128 000, päättely ei mukana); päättelypyrkimys varattu malleille grok-4.5–4.7. Lähteet: Responses API · Parhaat käytännöt.

Mallin toiminnan ohjaus

model, input ja instructions -parametrien lisäksi Responses API tarjoaa lukuisia parametreja Grokin toiminnan hienosäätöön. Näiden parametrien ymmärtäminen auttaa sinua saamaan tarpeisiisi sopivampia, lyhyempiä tai luovempia vastauksia.

Generointiparametrit

temperature (lämpötila)

Ohjaa vastauksien satunnaisuutta. API hyväksyy arvoja välillä 0–2, mutta kaikki yli 1 olevat arvot näytetään otannassa arvolla 1.

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

xAI:n parhaat käytännöt ovat selkeät: aseta temperature arvoksi 0,7 äläkä poikkea siitä merkittävästi, sillä Grok-mallit reagoivat huonosti muihin otanta-asetuksiin. Säädä kehottetta faktuaalisemmaksi tai luovammaksi muokkaamalla promptia eikä lämpötilaa.

top_p

Ydinotanta (nucleus sampling). Nykyiset tekstimallet käyttävät oletuksena arvoa 0,95, ja kaikki mallin oletusarvoa suuremmat arvot pienennetään tähän.

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

Arvolla top_p: 0.95 malli huomioi vain ne tokenit, jotka kattavat 95 % todennäköisyydestä. API-viite toistaa klassisen neuvon säätää vain toista kahdesta parametrista, mutta xAI:n parhaat käytännöt vaativat molempien asettamista eksplisiittisesti arvoihin 0,7 ja 0,95 jokaisessa pyynnössä.

max_output_tokens

Rajoittaa näkyvän vastauksen tokenien määrää; päättely ja funktiokutsut eivät sisälly laskentaan, ja oletusarvo on 128 000 tokenia:

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

Päättelymalleissa sisäistä pohdintaa ohjaa päättelypyrkimys, ei tämä yläraja. Jos vastaus katkeaa rajan vuoksi, tilaksi ilmoitetaan incomplete.

reasoning (päättely)

Malleille, jotka tukevat päättelyä, voit säätää pyrkimyksen tasoa:

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

Mahdolliset arvot ovat low, medium ja high (oletus), sekä xhigh malleissa grok-4.6 ja grok-4.7. Parametri koskee malleja grok-4.5–4.7, eikä grok-4.20-0309-reasoning hyväksy sitä. Korkea pyrkimys kuluttaa enemmän tokeneita ja sopii monimutkaisiin ongelmiin.

Keskusteluparametrit

store

Määrittää, tallennetaanko vastaus palvelinpuolelle:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: vastaus tallennetaan 30 päiväksi, haettavissa GET-pyynnöllä, käytettävissä parametrilla previous_response_id
  • false: vastausta ei pysyväistytä (yksityinen tila)

previous_response_id

Ketjuttaa uuden pyynnön olemassa olevaan keskusteluun (käsitelty tarkemmin oppitunnilla 5).

user

Loppukäyttäjän tunniste, hyödyllinen seurantaan ja moderointiin:

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

Työkaluparametrit

tools, tool_choice, parallel_tool_calls, max_turns

Nämä parametrit ohjaavat työkalujen käyttöä (web_search, code_interpreter, mukautetut funktiot). Niitä käsitellään yksityiskohtaisesti osiossa “Työkalut” (oppitunnit 9–12).

Parametrien yhteenveto

ParametriTyyppiOletusKäyttö
modelmerkkijonovaadittuMallin tunniste
inputmerkkijono/taulukkovaadittuKäyttäjän kehote
instructionsmerkkijononullJärjestelmäkehote
temperaturenumero—Suositus 0,7; yläraja 1
top_pnumero0.95Ydinotanta
max_output_tokenskokonaisluku128 000Näkyvän vastauksen raja
reasoningobjektinullPäättelypyrkimys
storetotuusarvonull30 päivän pysyvyys
streamtotuusarvofalseSSE-virtaus
usermerkkijononullLoppukäyttäjän ID

Keskeiset asiat

  • xAI suosittelee asettamaan temperature arvoksi 0,7 ja top_p arvoksi 0,95 eksplisiittisesti
  • max_output_tokens rajoittaa vain näkyvää vastausta, päättelyä ei lasketa mukaan
  • store: true pysyväistää vastauksen 30 päiväksi keskusteluketjutusta varten
  • reasoning.effort antaa sinun skaalata mallin pohdintaa tehtävän vaativuuden mukaan
  • user-parametri auttaa xAI:ta seurannassa ja moderoinnissa