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

Parametri reasoning_effort

Oppitunti 2 / 12 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Ajattelun syvyyden määrittäminen
  2. Hyväksytyt arvot mallikohtaisesti
  3. Toteutus Pythonilla
  4. Tason valinta tehtävän mukaan
  5. Kulun mittaaminen
  6. Reititys monimutkaisuuden perusteella
  7. Huomioitavat rajoitukset
  8. Keskeiset asiat

Oppitunti kirjoitettu uudelleen 2. marraskuuta 2026. Edellinen versio väitti, että reasoning_effort hyvä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.

MalliDokumentoidut arvotVirallinen suositus
Mistral Small 4 (mistral-small-2603)high, none—
Mistral Medium 3.5 (mistral-medium-3-5)high, nonehigh agenttityönkulkuja ja koodia varten
Mistral Large 4 (mistral-large-4-0)low, medium, highAloita 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_effort ohjaa päättelyä pyyntö kerrallaan ilman muita asetuksia
  • Small 4 ja Medium 3.5 hyväksyvät arvot high ja none; Large 4 hyväksyy arvot low, medium ja high, ei none:a
  • SDK-luettelot sisältävät arvoja, joita kaikki mallit eivät hyväksy
  • Arvolla high content on osioiden lista; arvolla none se on merkkijono
  • Mittaa kustannus kohdalla usage.completion_tokens ja reititä monimutkaisuuden perusteella