Põhjendustegevus: madal, keskmine ja kõrge
Sellel lehel
Uuendatud 3. novembril 2026 vastavalt xAI API dokumentatsioonile:
max_completion_tokenspiirab ainult nähtavat vastust; põhjendustokeneid sellesse limiiti ei arvestata ja nende hulka reguleerib tegevusparameeter. Allikas: Chat Completions. 3. novembri lisa: Õppetund sidus varem tegevuse API-ga (Chat Completions või Responses) ja rakendas seda mudelilegrok-4.20-0309-reasoning, mis seda ei toeta; vastavalt xAI lehele Reasoning sõltub see mudelist (grok-4.7,grok-4.6,grok-4.5,grok-4.20-multi-agent). Näites kasutati kausage.completion_tokens, mida Responses API vastustes ei leidu (seal onoutput_tokens,output_tokens_details.reasoning_tokens). Allikas: Reasoning.
Põhjendustegevuse sügavuse juhtimine
Põhjendustegevus võimaldab sul kalibreerida, kui palju mõtleb mudel enne vastamist. See on otsene hoob kvaliteedi, kiiruse ja tokenite tarbimise tasakaalustamiseks.
Mudel määrab kättesaadavuse, mitte API. Vastavalt xAI dokumentatsioonile:
| Mudel | Tegevus | Väärtused |
|---|---|---|
grok-4.7, grok-4.6 | Põhjendustegevuse sügavus | low, medium, high (vaikimisi), xhigh |
grok-4.5 | Põhjendustegevuse sügavus | low, medium, high (vaikimisi); xhigh käsitletakse kui high |
grok-4.20-multi-agent | Mobiliseeritud agentide arv (4 või 16), mitte sügavus | low, medium, high, xhigh |
grok-4.20-0309-reasoning | Pole konfigureeritav: mudel põhjendab alati | — |
Nendel mudelitel ei saa põhjendamist välja lülitada: ilma konfiguratsioonita on tegevus vaikimisi high. Ainult parameetri nimi muutub sõltuvalt API-st: reasoning_effort ülemisel tasemel Chat Completionsis ja reasoning.effort objekti reasoning sees Responses API puhul.
{
"model": "grok-4.7",
"input": "Solve the system of equations: 3x + 2y = 12, x - y = 1",
"reasoning": {
"effort": "medium"
}
}
Tegevustasemed
Dokumentatsioon kirjeldab iga taset ja selle sobivat kasutust:
low: Kasutab mõningast põhjendamist, jäädes kiireks. Sobib latentsustundlikele agentsetele kasutusjuhtudele ja lihtsatele tööriistakutsetele.medium: Rohkem arutlemist, rakendustele, mis on latentsuse suhtes vähem tundlikud. Sobib keeruliseks andmeanalüüsiks ja põhjendamiseks pikkades kontekstides.high(vaikimisi): Palju rohkem põhjendustokeneid. Sobib väga keerukate probleemide, kompleksse matemaatika ja mitmeastmelise loogika jaoks.xhigh: Maksimaalne sügavus koos vastava latentsusega. Sobib kõige raskemate probleemide lahendamiseks, kui kvaliteet on olulisem vastuse ajast.
xAI parimad tavad lisavad lihtsa reegli: määra tegevus iga päringu puhul sõnaselgelt ja logi see iga tulemuse juurde, et mõõtmised jääksid võrreldavaks.
Põhjendusmudelid lükkavad tagasi ka kolm parameetrit: presence_penalty, frequency_penalty ja stop põhjustavad päringu nurjumise.
Mõju tokenitele
Tegevustase mõjutab otseselt põhjendustokenite tarbimist:
low: Vähe põhjendustokeneid, kiire vastus, madal hindmedium: Mõõdukas tarbimine, hea kompromisshighjaxhigh: Palju põhjendustokeneid, aeglasem vastus, kõrge hind
Neid põhjendustokeneid arvestatakse väljundtokenitena (vt õppetund 8). Väljundi piirang (max_completion_tokens Chat Completionsis, max_output_tokens Responses APIs) piirab ainult nähtavat vastust: põhjendustokeneid sellesse ei arvestata, seega kontrollib tegevus nende hulka.
Õige taseme valimine
| Ülesanne | Soovitatav tegevus |
|---|---|
| Teksti klassifitseerimine | low |
| Kokkuvõte koos analüüsiga | medium |
| Struktureeritud üksuste ekstraheerimine | low |
| Võrrandite lahendamine | high |
| Koodivea analüüs | high |
| Teksti ümberformuleerimine | low |
| Valikute võrdlus plusside ja miinustega | medium |
| Matemaatiline tõestus | high |
Praktiline näide: sama küsimus, kolm tegevustaset
for effort in ["low", "medium", "high"]:
response = client.responses.create(
model="grok-4.7",
input="Explain why 0.1 + 0.2 != 0.3 in computing.",
reasoning={"effort": effort},
)
usage = response.usage
print(f"Effort {effort}: {usage.output_tokens} output tokens, "
f"including {usage.output_tokens_details.reasoning_tokens} reasoning tokens")
Erinevus tasemete vahel sõltub küsimusest: mõõda seda oma konkreetsetel juhtudel, mitte ei toetu üldisele suhtele, ning logi tegevus iga tulemuse juurde.
Peamised punktid
- Tegevus sõltub mudelist:
low,medium,high(vaikimisi) jaxhighmudelitelgrok-4.7jagrok-4.6; ilmaxhigh-ta mudelilgrok-4.5;grok-4.20-0309-reasoningei toeta seda reasoning_effortChat Completionsis,reasoning.effortResponses APIs; põhjendamist ei saa välja lülitada- Tegevustase mõjutab otseselt põhjendustokenite arvu ja seega ka hinda
- Ilma konfiguratsioonita on tegevus vaikimisi
high: määra see iga päringu puhul sõnaselgelt, nagu xAI soovitab - Kohanda tegevust ülesande tegeliku keerukusega, et optimeerida kulusid