Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Parametri Bażiċi

Lezzjoni 3 / 16 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ikkonfigura s-Sejħiet tal-API Tiegħek
  2. Il-Parametru model
  3. Il-Parametru max_tokens
  4. Il-Parametru temperature
  5. Il-Parametru top_p
  6. Eżempju Sħiħ bil-Parametri Kollha
  7. Punti Ewlenin

Ikkonfigura s-Sejħiet tal-API Tiegħek

Barra mill-kampijiet meħtieġa model u messages, l-API ta’ Chat Completions jaċċetta għadd żgħir ta’ parametri li jikkontrollaw l-imġiba tal-ġenerazzjoni. Dawn l-issettjar jagħmlu d-differenza bejn estrattur tad-data li jirritorna riżultati identiċi għall-istess fattura u ġeneratur ta’ slogans li qatt ma jirrepeti ruħu. Il-kodiċi tas-sejħa jibqa’ mingħajr bidla minn każ ta’ użu għall-ieħor; biss l-issettjar jinbidlu, u eżattament għalhekk għandek bżonn tifhem x’jagħmel kull wieħed minnhom.

Hawnhekk huma l-parametri li se tittratta kuljum, flimkien mat-tipi u l-valuri predefiniti tagħhom.

ParametruTipPredefinitDeskrizzjoni
modelstring—Identifikatur tal-mudell (meħtieġ)
messagesarray—Array ta’ messaġġi (meħtieġ)
max_tokensintegervarjabbliNumru massimu ta’ tokens tal-output
temperaturefloat0.7Jikkontrolla l-kreattività (0.0 sa 1.5)
top_pfloat1.0Kampjunar tan-nukleu (0.0 sa 1.0)
streambooleanfalseJattiva l-istreaming SSE
safe_promptbooleanfalseJattiva l-gwardji tas-sigurtà

Il-Parametru model

L-għażla tal-mudell tiegħek tiddetermina immedjatament il-kapaċitajiet, il-veloċità u l-ispiża ta’ kull sejħa—tliet kompromessi li ma tistax tirkupra mkien ieħor. Sa April 2026, il-mudelli primarji huma:

# Mudell ewlieni — raġunar kumpless, multilingwi
model = "mistral-large-latest"

# Mudell kompatt — mgħaġġel, ekonomiku, ideali għall-produzzjoni
model = "mistral-small-latest"

# Mudell żgħir ħafna — ultra-mgħaġġel, edge computing
model = "ministral-3b-latest"

# Mudell tal-kodiċi — speċjalizzat għall-ipprogrammar
model = "codestral-latest"

Is-suffiss -latest huwa konvenjenti waqt l-iżvilupp: dejjem jipponta lejn l-aħħar verżjoni mingħajr ma jeħtieġ bidliet fil-kodiċi. Madankollu, fil-produzzjoni, din il-konvenjenza ssir riskju, peress li aġġornament min-naħa ta’ Mistral jista’ jbiddel sottilment l-imġiba tal-applikazzjoni tiegħek. Ippreferi identifikaturi b’verżjoni bħal mistral-large-2512 biex tiggarantixxi r-riproduċibbiltà tat-testijiet tiegħek.

Il-Parametru max_tokens

Dan il-parametru jistabbilixxi l-limitu massimu tan-numru ta’ tokens li l-mudell jista’ jiġġenera fir-risposta tiegħu. Ma jfurzax lill-mudell biex jipproduċi eżattament dak in-numru; jiddefinixxi saqaf, xejn aktar.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Summarize this text in one sentence."}],
    max_tokens=100  # Ir-risposta ma taqbiżx 100 tokens
)

Jekk il-mudell jilħaq dan il-limitu, ir-risposta titqatta’ f’daqqa, u finish_reason tirritorna "length" minflok "stop". Din hija l-aktar kawża komuni ta’ risposti li jieqfu f’nofs sentenza, u ħadd ma jinnota sakemm jimmonitorja dan il-qasam. Ir-rifless it-tajjeb huwa li tikkalibra s-saqaf skont il-kompitu: il-klassifikazzjoni toqgħod f’10 sa 50 token peress li tistenna biss tikketta, sommarju jeħtieġ 200 sa 500 token, kitba ħielsa tieħu 1,000 sa 4,000, u l-ġenerazzjoni tal-kodiċi tilħaq faċilment 2,000 jew 8,000 token għax fajl sħiħ huwa twil.

Il-Parametru temperature

It-temperatura tikkontrolla l-grad ta’ każwalità fil-għażla tat-token. Aktar ma l-valur ikun baxx, aktar il-mudell isir deterministiku u prevedibbli; aktar ma jitla’, aktar jipprova kontinwazzjonijiet improbabbli. Għal mistoqsijiet fattwali, trid l-ewwel approċċ; għal eżerċizzji ta’ tismija, it-tieni.

# Temperatura baxxa — estrazzjoni, klassifikazzjoni, fattwali
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "What is the capital of France?"}],
    temperature=0.1
)

# Temperatura għolja — kreattività, brainstorming
response = client.chat.complete(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Invent a name for an AI startup."}],
    temperature=1.2
)

Il-firxa tvarja minn 0.0 sa 1.5. Tiddependix fuq temperature=0 għal determiniżmu perfett: varjazzjonijiet żgħar jibqgħu jeżistu minħabba r-rounding tal-floating-point fil-livell tal-hardware.

Il-Parametru top_p

Il-kampjunar tan-nukleu, jew Top P, jaġixxi fuq l-istess leva iżda permezz ta’ triq differenti: jillimita t-tokens kandidati b’soglia ta’ probabbiltà kumulattiva. B’top_p=0.5, biss it-tokens l-aktar probabbli li s-somom tal-probabbiltajiet tagħhom jilħqu 50% jibqgħu fil-kompetizzjoni; il-bqija jiġu skartati kompletament.

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[{"role": "user", "content": "Complete: The cat is on the..."}],
    temperature=0.7,
    top_p=0.9  # Iqis tokens li jkopru 90% tal-probabbiltà
)

Mistral jirrakkomanda li taġġusta parametru wieħed biss kull darba, jew it-temperatura jew top_p, qatt it-tnejn flimkien. Ir-raġuni hija prattika: jekk output isir stramb wara li tmexxi ż-żewġ sliders, xejn ma jgħidlek liema wieħed ikkawżah, u titlef kemm id-debuggability kif ukoll ir-riproduċibbiltà.

Eżempju Sħiħ bil-Parametri Kollha

Meta magħqudin f’sejħa waħda, dawn l-issettjar joħolqu ġeneratur ta’ slogans li huwa intenzjonalment qasir u ftit awdaċi, filwaqt li jsegwi wkoll il-konsum tat-tokens:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {
            "role": "system",
            "content": "You are a concise and punchy marketing writer."
        },
        {
            "role": "user",
            "content": "Write a slogan for a meditation app."
        }
    ],
    max_tokens=50,
    temperature=0.9,
    top_p=1.0
)

print(response.choices[0].message.content)
print(f"Tokens used: {response.usage.total_tokens}")

Ħarrek dan l-iskritt tliet darbiet wara xulxin, imbagħad ibdel temperature=0.9 b’0.1 u ħarrehu tliet darbiet oħra. Id-differenza bejn iż-żewġ serje tgħallmek aktar dwar dan il-parametru milli kwalunkwe definizzjoni tista’ tagħmel.

Punti Ewlenin

  • model u messages huma l-uniki parametri meħtieġa
  • max_tokens huwa saqaf, mhux mira—iċċekkja finish_reason biex tiskopri t-trunkazzjoni
  • Uża temperature baxxa għal kompiti fattwali, għolja għall-kreattività
  • top_p jirfina d-distribuzzjoni tat-token—taġġustahx fl-istess ħin mat-temperatura
  • Uża identifikaturi ta’ mudelli b’verżjoni fil-produzzjoni għar-riproduċibbiltà