Parametri reasoning_effort
Tällä sivulla
Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Edellinen versio väitti, että
reasoning_efforthyväksyi vain kaksi arvoa ja oli olemassa vain Mistral Small -mallissa. Todellisuudessa hyväksytyt arvot riippuvat mallista, ja Mistral Large 4 tarjoaa kolme. Lähde: Reasoning (Mistralin dokumentaatio).
Ajattelun syvyyden määrittäminen
Säädettävä päättely perustuu yksinkertaiseen periaatteeseen: päätät pyyntö kerrallaan, kuinka paljon mallin tulee ajatella ennen vastaamista. Vipuna toimii parametri reasoning_effort. Välität sen API-kutsussa samalla tasolla kuin mallin ja viestit, eikä muita asetuksia tarvita.
Hyväksytyt arvot mallikohtaisesti
Tämä on yleisin sudenkuoppa: hyväksytyt arvot riippuvat mallista.
| Malli | Dokumentoidut arvot | Virallinen suositus |
|---|---|---|
Mistral Small 4 (mistral-small-2603) | high, none | — |
Mistral Medium 3.5 (mistral-medium-3-5) | high, none | high agenttityönkulkuja ja koodia varten |
Mistral Large 4 (mistral-large-4-0) | low, medium, high | Aloita arvolla high, vaihda arvoon medium tai low, jos tokenit tai vasteaika ovat tärkeämpiä |
Malleissa Small 4 ja Medium 3.5 arvo high tuottaa täydellisen päättelyosion ennen vastausta, mikä kasvattaa tokenien kulutusta; arvo none vähentää päättelyn minimiin ja jättää sen pois vastauksesta. Mallissa Large 4 asteikolla on kolme tasoa: low yksinkertaisiin tehtäviin, medium laadun, tokenien ja vasteajan tasapainottamiseen sekä high monimutkaisiin tehtäviin. Large 4 ei hyväksy arvoa none: dokumentaatiossa täsmennetään, että esiversiossa none:na tunnettu taso on nyt nimetty low:ksi.
Viimeinen vivahde: SDK-tyypissä ReasoningEffort luetellaan myös arvot minimal, xhigh ja max, koska luettelo kattaa kaikki alustan mallit (max:aa käyttää esimerkiksi kolmannen osapuolen malli zai-glm-5-3). Se, että arvo esiintyy luettelossa, ei tarkoita, että mallisi hyväksyisi sen.
Toteutus Pythonilla
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Mistral Small 4, syvä päättely
response_high = client.chat.complete(
model="mistral-small-2603",
messages=[{"role": "user", "content": "Solve x^3 - 6x^2 + 11x - 6 = 0 and verify each root."}],
reasoning_effort="high",
)
# Mistral Small 4, suora vastaus
response_none = client.chat.complete(
model="mistral-small-2603",
messages=[{"role": "user", "content": "What is the capital of Portugal?"}],
reasoning_effort="none",
)
# Mistral Large 4, välitaso
response_medium = client.chat.complete(
model="mistral-large-4-0",
messages=[{"role": "user", "content": "Compare two caching strategies for a high-traffic API."}],
reasoning_effort="medium",
)
Vastauksen rakenne muuttuu asetuksen mukaan. Arvolla high message.content on lista, joka alkaa päättelyosiolla; arvolla none se on yksinkertainen merkkijono. Koodisi tulee siksi käsitellä molemmat muodot, kuten seuraava oppitunti osoittaa.
TypeScriptissä parametri noudattaa JavaScriptin nimeämiskäytäntöä ja kirjoitetaan muodossa reasoningEffort:
import { Mistral } from '@mistralai/mistralai';
const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const response = await client.chat.complete({
model: 'mistral-small-2603',
messages: [{ role: 'user', content: 'Solve x^3 - 6x^2 + 11x - 6 = 0.' }],
reasoningEffort: 'high',
});
Tason valinta tehtävän mukaan
Varaa syvä päättely monivaiheisiin matematiikan ongelmiin, monimutkaiseen koodin vianetsintään, vertailevaan analyysiin, suunnitteluun, logiikkapulmiin ja riskinarviointiin. Näillä on yhteinen piirre: useita polkuja on mahdollista, ja väärän valitseminen on kallista.
Kytke se pois päältä (tai pudota alimmalle tasolle) yksinkertaisissa faktakysymyksissä, kääntämisessä, uudelleenmuotoilussa, suorassa tiedonpoiminnassa ja arkikeskustelussa. Mallilla ei ole tässä mitään ratkaistavaa: se hakee tai muuntaa tietoa, ja päättelyvaihe lisäisi vain viivettä.
Kulun mittaaminen
Päättely kuluttaa output-tokeneita. Virallinen dokumentaatioesimerkki antaa mittakaavatunteen: ikäarvoitus lähetettynä Mistral Small 4:lle asetuksella high kuluttaa 77 input-tokenia ja 1 114 output-tokenia. Small 4:n listatulla hinnalla 0,15 dollaria miljoonaa input-tokenia kohden ja 0,60 dollaria miljoonaa output-tokenia kohden pyynnön hinta on noin 0,0007 dollaria. Se on merkityksetön yksikköä kohden, mutta miljoonassa samanlaisessa pyynnössä pelkkä päättely edustaa useita satoja dollareita ilman hyötyä, jos puolet kysymyksistä eivät tarvitseet sitä.
Kenttä usage jokaisessa vastauksessa antaa tarkan mittarin: seuraa arvoa completion_tokens pyyntötyypin mukaan ennen asetuksen yleistämistä.
Reititys monimutkaisuuden perusteella
Yksinkertainen kiertotie on valita taso kysymyksen perusteella käyttämällä mallikohtaista taulukkoa varmistaaksesi, ettet koskaan lähetä hylättyä arvoa:
LEVELS = {
"mistral-small-2603": {"simple": "none", "complex": "high"},
"mistral-large-4-0": {"simple": "low", "complex": "high"},
}
COMPLEX_WORDS = ("calculate", "prove", "compare", "analyze", "optimize", "debug", "why")
def query(client, question, model="mistral-small-2603", level=None):
"""Valitsee reasoning_effortin kysymyksen perusteella tai soveltaa pakotettua tasoa."""
if level is None:
is_complex = any(word in question.lower() for word in COMPLEX_WORDS)
level = LEVELS[model]["complex" if is_complex else "simple"]
return client.chat.complete(
model=model,
messages=[{"role": "user", "content": question}],
reasoning_effort=level,
)
Avainsanaheuristiikat ovat karkeita; ne riittävät varaamaan päättelyn pyynnöille, jotka hyötyvät siitä, ja argumentti level antaa sinun pakottaa asetuksen. Oppitunti 12 ehdottaa täydellisempää reititysarkkitehtuuria.
Huomioitavat rajoitukset
Päättely kasvattaa oikean vastauksen todennäköisyyttä, mutta ei takaa sitä: varmista kriittiset tulokset (oppitunti 9). Se kasvattaa myös viivettä, mikä on merkittävää keskustelukäyttöliittymässä. Lopuksi, välitetyn arvon on vastattava kutsuttua mallia: suunnittele yllä olevan kaltainen taulukko sen sijaan, että hajauttaisit merkkijonoja koodiisi.
Keskeiset asiat
reasoning_effortohjaa päättelyä pyyntö kerrallaan ilman muita asetuksia- Small 4 ja Medium 3.5 hyväksyvät arvot
highjanone; Large 4 hyväksyy arvotlow,mediumjahigh, einone:a - SDK-luettelot sisältävät arvoja, joita kaikki mallit eivät hyväksy
- Arvolla
highcontenton osioiden lista; arvollanonese on merkkijono - Mittaa kustannus kohdalla
usage.completion_tokensja reititä monimutkaisuuden perusteella