Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Parametre požiadavky

Lekcia 3 z 16 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Ovládanie správania modelu
  2. Parametre generovania
  3. Parametre konverzácie
  4. Parametre nástrojov
  5. Zhrnutie parametrov
  6. Kľúčové poznatky

Aktualizované 3. novembra 2026. Na základe referencie Responses API a osvedčených postupov xAI: odporúčaná teplota 0,7, obmedzená na 1; top_p predvolene 0,95; max_output_tokens obmedzené na viditeľnú odpoveď (predvolene 128 000, bez uvažovania); úsilie pri uvažovaní vyhradené pre modely grok-4.5 až 4.7. Zdroje: Responses API · Osvedčené postupy.

Ovládanie správania modelu

Okrem parametrov model, input a instructions ponúka Responses API množstvo ďalších parametrov na jemné doladenie správania Groka. Pochopenie týchto parametrov ti umožní získať relevantnejšie, kratšie alebo kreatívnejšie odpovede podľa tvojich potrieb.

Parametre generovania

temperature

Ovláda náhodnosť odpovedí. API akceptuje hodnoty od 0 do 2, ale akákoľvek hodnota nad 1 sa vzorkuje ako 1.

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

Osvedčené postupy xAI sú jasné: nastav temperature na 0,7 a príliš sa od tejto hodnoty nevzďaľuj, pretože modely Grok reagujú zle na iné nastavenia vzorkovania. Pre faktickejší alebo kreatívnejší tón uprav radšej prompt než teplotu.

top_p

Jadrové vzorkovanie (nucleus sampling). Aktuálne textové modely majú predvolenú hodnotu 0,95 a akákoľvek vyššia hodnota sa zníži na túto predvolenú hodnotu modelu.

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

Pri hodnote top_p: 0.95 model berie do úvahy iba tokeny, ktoré predstavujú 95 % pravdepodobnosti. Referencia API opakuje klasickú radu upravovať iba jeden z týchto dvoch parametrov; osvedčené postupy xAI však vyžadujú explicitné nastavenie oboch parametrov na každej požiadavke, a to na hodnoty 0,7 a 0,95.

max_output_tokens

Obmedzuje počet tokenov vo viditeľnej odpovedi; uvažovanie a volania funkcií sa nepočítajú a predvolená hodnota je 128 000 tokenov:

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

Pri modeloch s uvažovaním riadi internú reflexiu parameter úsilia pri uvažovaní (reasoning effort), nie tento limit. Odpoveď prerušená týmto limitom je signalizovaná stavom incomplete.

reasoning

Pre modely, ktoré podporujú uvažovanie, môžeš upraviť úsilie:

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

Možné hodnoty sú low, medium a high (predvolené), plus xhigh pre modely grok-4.6 a grok-4.7; parameter platí pre modely grok-4.5 až 4.7 a model grok-4.20-0309-reasoning ho neprijíma. Vysoké úsilie spotrebuje viac tokenov a hodí sa pre zložité problémy.

Parametre konverzácie

store

Určuje, či sa odpoveď uloží na strane servera:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: odpoveď sa uloží na 30 dní, je získateľná prostredníctvom GET a použiteľná s parametrom previous_response_id
  • false: odpoveď sa neuloží (súkromný režim)

previous_response_id

Prepojí novú požiadavku s existujúcou konverzáciou (podrobne popísané v lekcii 5).

user

Identifikátor koncového používateľa, užitočný na sledovanie a moderovanie:

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

Parametre nástrojov

tools, tool_choice, parallel_tool_calls, max_turns

Tieto parametre riadia používanie nástrojov (web_search, code_interpreter, vlastné funkcie). Podrobne sú pokryté v sekcii „Nástroje“ (lekcie 9 – 12).

Zhrnutie parametrov

ParameterTypPredvolená hodnotaPoužitie
modelstringpovinnéIdentifikátor modelu
inputstring/arraypovinnéPrompt používateľa
instructionsstringnullSystémový prompt
temperaturenumber—Odporúčané 0,7; obmedzené na 1
top_pnumber0.95Jadrové vzorkovanie
max_output_tokensinteger128 000Limit viditeľnej odpovede
reasoningobjectnullÚsilie pri uvažovaní
storebooleannullPerzistencia na 30 dní
streambooleanfalseStreamovanie cez SSE
userstringnullID koncového používateľa

Kľúčové poznatky

  • xAI odporúča nastaviť temperature na 0,7 a top_p na 0,95 explicitne
  • max_output_tokens obmedzuje iba viditeľnú odpoveď, bez zahrnutia uvažovania
  • store: true uchováva odpoveď na 30 dní pre prepojenie konverzácií
  • reasoning.effort ti umožňuje škálovať reflexiu modelu podľa zložitosti úlohy
  • Parameter user pomáha so sledovaním a moderovaním na strane xAI