Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Kérési paraméterek

3. lecke 16 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A modell viselkedésének vezérlése
  2. Generálási paraméterek
  3. Beszélgetési paraméterek
  4. Eszközparaméterek
  5. Paraméterek összefoglalása
  6. Főbb megállapítások

Frissítve: 2026. november 3. A Responses API referenciája és az xAI legjobb gyakorlatai alapján: ajánlott hőmérséklet 0,7 (maximálisan 1-re korlátozva); top_p alapértelmezetten 0,95; max_output_tokens csak a látható válaszra korlátozódik (alapértelmezett 128 000, a következtetés nélkül); a következtetési erőfeszítés csak a grok-4.5-től 4.7-ig elérhető. Források: Responses API · Legjobb gyakorlatok.

A modell viselkedésének vezérlése

A model, input és instructions paramétereken túl a Responses API számos további beállítást kínál a Grok viselkedésének finomhangolására. Ezen paraméterek megértésével igényeidnek megfelelően relevánsabb, rövidebb vagy kreatívabb válaszokat érhetsz el.

Generálási paraméterek

temperature (hőmérséklet)

Szabályozza a válaszok véletlenszerűségét. Az API a 0 és 2 közötti értékeket fogadja el, de az 1 feletti bármilyen értéket 1-re mintavételez.

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

Az xAI legjobb gyakorlatai egyértelműek: állítsd a temperature értékét 0,7-re, és ne térj el jelentősen ettől, mert a Grok modellek rosszul reagálnak más mintavételezési beállításokra. Ha tényközlőbb vagy kreatívabb hangnemet szeretnél, inkább a promptot módosítsd, ne a hőmérsékletet.

top_p

Magmintavételezés (nucleus sampling). A jelenlegi szöveges modellek alapértelmezett értéke 0,95, és a modell alapértelmezett értékénél magasabb bármilyen értéket erre csökkentenek.

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

A top_p: 0.95 beállítással a modell csak azokat a tokeneket veszi figyelembe, amelyek a valószínűség 95%-át teszik ki. Az API referencia a klasszikus tanácsot ismétli, miszerint e két paraméter közül csak az egyiket érdemes módosítani; az xAI legjobb gyakorlatai azonban előírják, hogy minden kérésnél mindkettőt állítsd be explicit módon: 0,7-re, illetve 0,95-re.

max_output_tokens

Korlátozza a látható válasz tokenjeinek számát; a következtetés és a függvényhívások nem számítanak bele, az alapértelmezett érték pedig 128 000 token:

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

A következtető modelleknél nem ez a korlát, hanem a következtetési erőfeszítés (reasoning effort) szabályozza a belső gondolkodást. Ha a válasz levágásra kerül e korlát miatt, azt az rendszer egy incomplete állapottal jelzi.

reasoning (következtetés)

Azoknál a modelleknél, amelyek támogatják a következtetést, beállíthatod az erőfeszítés mértékét:

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

A lehetséges értékek: low, medium és high (alapértelmezett), valamint xhigh a grok-4.6 és grok-4.7 modelleken; a paraméter a grok-4.5-től 4.7-ig érvényes, a grok-4.20-0309-reasoning viszont nem fogadja el. A magas erőfeszítés több tokent fogyaszt, és összetett feladatokhoz illik.

Beszélgetési paraméterek

store (tárolás)

Meghatározza, hogy a választ tárolja-e a szerver oldalon:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analyze this contract.",
  "store": false
}
  • true: a választ 30 napig tárolja, GET kéréssel lekérhető, és használható a previous_response_id paraméterrel
  • false: a válasz nem kerül megőrzésre (privát mód)

previous_response_id

Összeláncol egy új kérést egy meglévő beszélgetéssel (részletesen az 5. leckében tárgyaljuk).

user

A végfelhasználó azonosítója, amely nyomkövetéshez és moderációhoz hasznos:

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

Eszközparaméterek

tools, tool_choice, parallel_tool_calls, max_turns

Ezek a paraméterek az eszközhasználatot (webes keresés, kódértelmező, egyéni függvények) vezérlik. Részletes kifejtésük az „Eszközök“ szekcióban (9–12. leckék) található.

Paraméterek összefoglalása

ParaméterTípusAlapértelmezettHasználat
modelstringkötelezőModellazonosító
inputstring/arraykötelezőFelhasználói prompt
instructionsstringnullRendszerprompt
temperaturenumber—Ajánlott: 0,7; 1-re korlátozva
top_pnumber0.95Magmintavételezés
max_output_tokensinteger128,000Látható válasz korlátja
reasoningobjectnullKövetkeztetési erőfeszítés
storebooleannull30 napos megőrzés
streambooleanfalseSSE streamelés
userstringnullVégfelhasználó azonosítója

Főbb megállapítások

  • Az xAI ajánlása szerint a temperature értéke 0,7, a top_p értéke pedig 0,95 legyen, mindkettőt állítsd be explicit módon
  • A max_output_tokens csak a látható választ korlátozza, a következtetést nem tartalmazza
  • A store: true beállítás 30 napig megőrzi a választ a beszélgetések összeláncolásához
  • A reasoning.effort paraméterrel a feladat összetettsége alapján skálázhatod a modell gondolkodási mélységét
  • A user paraméter segít az xAI oldalán történő nyomkövetésben és moderációban