Parameeter reasoning_effort
Sellel lehel
Õppetund kirjutati ümber 2. novembril 2026. Eelmises versioonis väideti, et
reasoning_effortaktsepteerib ainult kahte väärtust ja eksisteerib vaid mudelil Mistral Small. Tegelikult sõltuvad lubatud väärtused mudelist ja Mistral Large 4 pakub kolme. Allikas: Reasoning (Mistrali dokumentatsioon).
Mõtlemise sügavuse seadistamine
Kohandatav arutlemine põhineb lihtsal põhimõttel: sina otsustad iga päringu puhul eraldi, kui palju peaks mudel enne vastamist mõtlema. Hoobaks on parameeter reasoning_effort. Sa edastad selle API väljakutses samal tasemel kui mudeli ja sõnumitega, ilma et oleks vaja muud konfiguratsiooni.
Lubatud väärtused mudeliti
See on kõige levinum lõks: lubatud väärtused sõltuvad mudelist.
| Mudel | Dokumenteeritud väärtused | Ametlik soovitus |
|---|---|---|
Mistral Small 4 (mistral-small-2603) | high, none | — |
Mistral Medium 3.5 (mistral-medium-3-5) | high, none | high agentsete töövoogude ja kodeerimise jaoks |
Mistral Large 4 (mistral-large-4-0) | low, medium, high | Alusta väärtusega high, seejärel lülitu väärtusele medium või low, kui tokenite arv või latentsus on olulisemad |
Mudelitel Small 4 ja Medium 3.5 genereerib väärtus high enne vastust täieliku arutlusosa, mis suurendab tokenite tarbimist; väärtus none vähendab arutluse miinimumini ja jätab selle vastusest välja. Mudelil Large 4 on skaala kolmetasandiline: low lihtsate ülesannete jaoks, medium kvaliteedi, tokenite ja latentsuse tasakaalustamiseks ning high keerukate ülesannete jaoks. Large 4 ei aktsepteeri väärtust none: dokumentatsioon täpsustab, et tase, mida selle eelvaateversioonis nimetati none, kannab nüüd nime low.
Veel üks nüanss: tüüp ReasoningEffort SDK-des loetleb ka väärtused minimal, xhigh ja max, kuna loetelu hõlmab kõiki platvormi mudelaid (näiteks kasutab kolmanda osapoole mudel zai-glm-5-3 väärtust max). Asjaolu, et väärtus loetelus esineb, ei tähenda, et sinu mudel seda aktsepteeriks.
Rakendamine Pythonis
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
# Mistral Small 4, sügav arutlemine
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, otsene vastus
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, vahepealne tase
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",
)
Vastuse struktuur muutub sõltuvalt seadistusest. Väärtusega high on message.content loend, mis algab arutlusosaga; väärtusega none on see lihtne string. Sinu kood peab seetõttu mõlemat vormi käsitlema, nagu näitab järgmine õppetund.
TypeScriptis järgib parameeter JavaScripti konventsioone ja kirjutatakse kujul 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',
});
Taseme valik ülesande põhjal
Reserveeri sügav arutlemine mitmeastmeliste matemaatikaülesannete, keeruka koodi silumise, võrdleva analüüsi, planeerimise, loogikamõistatuste ja riskihinnangu jaoks. Neid ühendab üks joon: võimalikke teid on mitu ja vale valiku tegemine on kulukas.
Lülita see välja (või langeta madalaimale tasemele) lihtsate faktiliste küsimuste, tõlkimise, ümber sõnastamise, otsese info ekstraheerimise ja igapäevase vestluse jaoks. Siin pole mudelil midagi kaaluda: ta toob info või teisendab seda ning arutlusfaas ainult suurendaks latentsust.
Kulude mõõtmine
Arutlemine tarbib väljundtokeneid. Ametlik dokumentatsioon toob näiteks skaala tajumise: vanusemõistatus, saadetud mudelile Mistral Small 4 väärtusega high, tarbib 77 sisendtokenit ja 1114 väljundtokenit. Small 4 hinnakirja järgi (0,15 USD miljoni sisendtokeni ja 0,60 USD miljoni väljundtokeni kohta) maksab päring umbes 0,0007 USD. Üksiku päringu puhul on see tühine, kuid miljoni sarnase päringu korral tähendab pelgalt arutlemine sadu dollareid, ilma et oleks kasu, kui pooled küsimused seda ei vajanud.
Väli usage igas vastuses annab sulle täpse mõõdu: jälgi completion_tokens päringutüübiti enne seadistuse üldistamist.
Suunamine keerukuse alusel
Lihtne lahendus on valida tase küsimuse põhjal, kasutades iga mudeli jaoks tabelit, et veenduda, kunagi tagasilükatud väärtust ei saadeta:
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):
"""Valib reasoning_effort küsimuse põhjal või rakendab sunnitud taset."""
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,
)
Märksõnade heuristika on toorevõitu; see piisab arutlemise reserveerimiseks päringutele, mis sellest kasu saavad, ja argument level võimaldab seadistust sundida. Õppetund 12 pakub välja terviklikuma suunamisarhitektuuri.
Piirangud, mida teada
Arutlemine suurendab õige vastuse saamise tõenäosust, kuid ei garanteeri seda: kontrolli kriitilisi tulemusi (õppetund 9). Samuti suurendab see latentsust, mis on vestlusliideses oluline. Lõpuks peab edastatud väärtus vastama kutsutud mudelile: planeeri ette selline tabel nagu eespool, selle asemel et hajutada stringe üle kogu koodi.
Peamised punktid
reasoning_effortjuhib arutlemist päring-päringult ilma muu konfiguratsioonita- Small 4 ja Medium 3.5 aktsepteerivad
highjanone; Large 4 aktsepteeriblow,mediumjahigh, mittenone - SDK loetelud sisaldavad väärtusi, mida kõik mudelid ei aktsepteeri
- Väärtusega
highoncontentfragmentide loend; väärtuseganoneon see string - Mõõda kulu väljaga
usage.completion_tokensja suuna päringuid keerukuse alusel