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

L-API ta' Codestral f'Python

Lezzjoni 3 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Sejħa ta’ Codestral minn Python
  2. Installazzjoni u konfigurazzjoni
  3. Sejħa FIM sħiħa
  4. Sejħa ta’ Chat għall-ġenerazzjoni tal-kodiċi
  5. Parametri avvanzati
  6. Żewġ mudelli biex tikkopja u twaħħal
  7. Trattament tal-iżbalji
  8. Punti Ewlenin

Sejħa ta’ Codestral minn Python

Din il-lezzjoni timxi mit-teorija għal kodiċi eżegwibbli. Se tuża l-SDK ta’ Python ta’ Mistral AI biex tistaqsi lil Codestral fuq iż-żewġ endpoints tiegħu, taġġusta l-parametri avvanzati li jisseparaw suġġeriment utli minn wieħed verbali żżejjed, u timplimenta l-mudelli misjuba fil-biċċa l-kbira tal-integrazzjonijiet fid-dinja reali.

Installazzjoni u konfigurazzjoni

Installa l-SDK b’kmand wieħed:

pip install mistralai

Irrikupra ċ-ċavetta tal-API tiegħek minn console.mistral.ai u aqraha mill-ambjent minflok ma tiktbuha direttament fil-fajl tiegħek:

import os
from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Żewġ pjattaformi jservu lil Codestral, u inti tagħżel bejniethom meta toħloq iċ-ċavetta tiegħek. api.mistral.ai topera fuq bażi ta’ ħlas skont l-użu b’kontabbiltà bbażata fuq l-użu: din hija t-triq standard meta Codestral ikun komponent wieħed fost ħafna f’applikazzjoni. codestral.mistral.ai huwa endpoint iddedikat, aċċessibbli b’xejn jew permezz ta’ abbonament, iddisinjat għall-użu dirett minn żviluppatur fl-editor tiegħu.

Sejħa FIM sħiħa

Hawnhekk hemm sejħa FIM dettaljata bil-parametri importanti kollha:

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

response = client.fim.complete(
    model="codestral-latest",
    prompt="def calculate_vat(price_excl: float, rate: float = 0.20) -> float:",
    suffix="price = float(input('Price excl. VAT: '))\nprint(f'Price incl. VAT: {calculate_vat(price):.2f} EUR')",
    temperature=0,
    max_tokens=150,
    stop=["\n\n"],
)

completion = response.choices[0].message.content
print(completion)

Analiżi tar-rispons

L-oġġett ritornat fih aktar milli sempliċiment it-test iġġenerat. Fil-produzzjoni, għandek tiċċekkja sistematikament tliet biċċiet ta’ informazzjoni: it-tlestija nnifisha, il-konsum tat-tokens li jiddetermina l-kont tiegħek, u r-raġuni tal-waqfien, li tgħidlek jekk il-mudellx temm naturalment jew laħaq il-limitu tiegħek.

# Aċċessa t-tlestija ġġenerata
text = response.choices[0].message.content

# Iċċekkja n-numru ta' tokens użati
tokens_prompt = response.usage.prompt_tokens
tokens_completion = response.usage.completion_tokens
tokens_total = response.usage.total_tokens

# Iċċekkja r-raġuni tal-waqfien
reason = response.choices[0].finish_reason  # "stop", "length", eċċ.

finish_reason ta’ "length" f’nofs is-sejħiet tiegħek huwa sinjal ċar: il-max_tokens tiegħek huwa baxx wisq, u qed twassal kodiċi maqtugħ lill-utenti tiegħek.

Sejħa ta’ Chat għall-ġenerazzjoni tal-kodiċi

Kull meta ma jkun hemm l-ebda kursor fin-nofs ta’ fajl—bħal għal ġenerazzjoni sħiħa, spjegazzjoni, jew refactoring—l-endpoint tal-chat jieħu l-kontroll. Il-messaġġ tas-sistema mbagħad jifforma l-format tal-output, li jevita l-ħtieġa li tnaddaf ir-rispons wara:

response = client.chat.complete(
    model="codestral-latest",
    messages=[
        {
            "role": "system",
            "content": "You are an expert Python development assistant. Respond with code only, no explanations."
        },
        {
            "role": "user",
            "content": "Write a Python function that validates an email address using regex."
        }
    ],
    temperature=0.2,
    max_tokens=500,
)

code = response.choices[0].message.content
print(code)

Parametri avvanzati

Il-par min_tokens / max_tokens jifforma t-tul tal-output. L-art hija utli meta tiġġenera blokka li taf li ma tistax tkun iqsar minn volum partikolari, bħal funzjoni bit-trattament tal-iżbalji tagħha.

# min_tokens: jiforza tul minimu tal-output
# max_tokens: jillimita t-tul massimu
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    min_tokens=20,
    max_tokens=300,
)

It-tokens ta’ waqfien (stop tokens) għandhom rwol differenti: iwaqqfu l-ġenerazzjoni fuq mudell speċifiku, u jżommu t-tlestija fil-kamp ta’ applikazzjoni tal-funzjoni attwali minflok ma jħallu lill-mudell jgħaqqad mal-oħra li jmiss.

# Waqqaf il-ġenerazzjoni fuq mudelli speċifiċi
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    stop=["\n\n", "\nclass ", "\ndef "],  # Waqqaf qabel funzjoni/klassi ġdida
)

Fl-aħħar nett, it-temperatura tirregola l-varjabbiltà. F’0, l-istess input dejjem jagħti l-istess output, li l-awto-tlestija teħtieġ. Madwar 0.3, il-mudell jipproponi varjanti, li huwa interessanti meta turi bosta suġġerimenti. F’0.7, inti f’modalità ta’ brainstorming tal-kodiċi, utli bi tesplora approċċ iżda mhux xierqa għal fluss ta’ editing.

# temperature=0: deterministiku (awto-tlestija)
# temperature=0.3: ftit kreattiv (bosta suġġerimenti)
# temperature=0.7: kreattiv (brainstorming tal-kodiċi)

response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    temperature=0.3,
    top_p=0.95,
)

Żewġ mudelli biex tikkopja u twaħħal

L-ewwel jirriproduċi l-imġiba tal-IDE: taqsam il-kontenut tal-fajl fil-pożizzjoni tal-kursor, u ż-żewġ nofsijiet isiru l-prompt u s-suffix.

def autocomplete_ide(file_content: str, cursor_position: int) -> str:
    """Jissimula l-awto-tlestija tal-IDE b'Codestral FIM."""
    prompt = file_content[:cursor_position]
    suffix = file_content[cursor_position:]

    response = client.fim.complete(
        model="codestral-latest",
        prompt=prompt,
        suffix=suffix,
        temperature=0,
        max_tokens=100,
        stop=["\n\n", "\ndef ", "\nclass "],
    )

    return response.choices[0].message.content

It-tieni jawtomatizza d-dokumentazzjoni għal proġett eżistenti: tgħaddi funzjoni, tirrikupra d-docstring tagħha, u l-istruzzjoni tas-sistema timponi format wieħed sabiex ir-riżultat jiddaħħal mingħajr editing ulterjuri.

def generate_docstring(function_code: str) -> str:
    """Tiġġenera docstring għal funzjoni Python."""
    response = client.chat.complete(
        model="codestral-latest",
        messages=[
            {
                "role": "system",
                "content": "Generate a Google-style docstring for the following function. Return ONLY the docstring between triple quotes."
            },
            {
                "role": "user",
                "content": function_code
            }
        ],
        temperature=0,
        max_tokens=300,
    )
    return response.choices[0].message.content

Trattament tal-iżbalji

Sejħa tan-network se tfalli qabel jew wara, u estensjoni tal-editor li taqa’ fuq żball ta’ validazzjoni hija agħar minn estensjoni mingħajr tlestija. Għalhekk, dejjem ġib is-sejħiet tiegħek f’blokk ta’ protezzjoni:

from mistralai.client import Mistral
from mistralai.client.errors import HTTPValidationError

try:
    response = client.fim.complete(
        model="codestral-latest",
        prompt=prompt,
        suffix=suffix,
    )
except HTTPValidationError as e:
    print(f"Validation error: {e}")
except Exception as e:
    print(f"Unexpected error: {e}")

Punti Ewlenin

  • L-SDK mistralai jesponi client.fim.complete() għal FIM u client.chat.complete() għaċ-chat
  • Il-parametri prompt u suffix huma speċifiċi għall-endpoint FIM
  • Uża temperature=0 għall-awto-tlestija, 0.2-0.7 għall-ġenerazzjoni kreattiva
  • stop jillimita l-ġenerazzjoni għal blokka ta’ kodiċi koerenti
  • min_tokens u max_tokens jikkontrollaw it-tul tal-output
  • Dejjem immaniġġja l-iżbalji HTTP fil-kodiċi tal-produzzjoni