Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Codestral API Pythonis

Õppetund 3 / 14 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Codestrali kutsumine Pythonist
  2. Paigaldamine ja seadistamine
  3. Täielik FIM-i päring
  4. Vestluspäring koodi genereerimiseks
  5. Täiustatud parameetrid
  6. Kaks mustrit kopeerimiseks ja kleebimiseks
  7. Veakäitlus
  8. Peamised punktid

Codestrali kutsumine Pythonist

Selles tunnis liigume teooriast käivitatava koodi juurde. Kasutad Mistral AI Python SDK-d, et pärida Codestralilt selle kahe lõpp-punkti kaudu, häälestad täiustatud parameetreid, mis eristavad kasulikku soovitust ülearusest, ning rakendad mustreid, mida leidub enamikes reaalsetes integratsioonides.

Paigaldamine ja seadistamine

Paigalda SDK ühe käsuga:

pip install mistralai

Hangi oma API-võti aadressilt console.mistral.ai ja loe see keskkonnamuutujatest, selle asemel et see faili kõvakodeerida:

import os
from mistralai.client import Mistral

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

Codestrali teenindab kaks platvormi ja valid nende vahel võtme loomisel. api.mistral.ai töötab kasutuspõhise arvelduse alusel: see on standardne tee, kui Codestral on rakenduses vaid üks komponent paljude seas. codestral.mistral.ai on spetsiaalne lõpp-punkt, mis on tasuta või tellimuse alusel kättesaadav ja mõeldud arendaja otseseks kasutamiseks oma redaktoris.

Täielik FIM-i päring

Siin on üksikasjalik FIM-i päring koos kõigi oluliste parameetritega:

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)

Vastuse lahendamine

Tagastatud objekt sisaldab rohkemat kui ainult genereeritud teksti. Tooteversioonis peaksid süstemaatiliselt kontrollima kolme teabetükki: ennast täiendust, tokenite tarbimist, mis määrab sinu arve, ja peatumise põhjust, mis ütleb, kas mudel lõpetas loomulikult või jõudis sinu seatud piiranguni.

# Juurdepääs genereeritud täiendusele
text = response.choices[0].message.content

# Kontrolli kasutatud tokenite arvu
tokens_prompt = response.usage.prompt_tokens
tokens_completion = response.usage.completion_tokens
tokens_total = response.usage.total_tokens

# Kontrolli peatumise põhjust
reason = response.choices[0].finish_reason  # "stop", "length", jne.

Kui pooltel sinu päringutel on finish_reason väärtuseks "length", on see selge signaal: sinu max_tokens on liiga madal ja tarnid kasutajatele kärbitud koodi.

Vestluspäring koodi genereerimiseks

Kui faili keskel puudub kursor – näiteks täieliku genereerimise, selgitamise või ümberkujundamise korral – võtab ohjad enda kätte vestluse lõpp-punkt. Süsteemsõnum raamib seejärel väljundformaadi, mis välistab vajaduse vastust hiljem puhastada:

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)

Täiustatud parameetrid

Paar min_tokens / max_tokens raamib väljundi pikkust. Miinimum on kasulik, kui genereerid plokki, mis ei saa olla lühem kui teatud maht, näiteks funktsioon koos veakäitlusega.

# min_tokens: sunnib minimaalset väljundi pikkust
# max_tokens: piirab maksimaalset pikkust
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    min_tokens=20,
    max_tokens=300,
)

Peatumise tokenitel on teine roll: need peatavad genereerimise kindla mustri korral, hoides täienduse praeguse funktsiooni piires, selle asemel et lasta mudelil ahelduda järgmisse.

# Peata genereerimine kindlate mustrite korral
response = client.fim.complete(
    model="codestral-latest",
    prompt=prompt,
    suffix=suffix,
    stop=["\n\n", "\nclass ", "\ndef "],  # Peata enne uut funktsiooni/klassi
)

Lõpuks reguleerib temperatuur varieeruvust. Väärtusel 0 annab sama sisend alati sama väljundi, mida automaatne lõpetamine nõuab. Umbes 0.3 juures pakub mudel variante, mis on huvitav mitme soovituse kuvamisel. Väärtusel 0.7 oled koodi ajurünnaku režiimis, mis on kasulik lähenemisviisi uurimiseks, kuid ei sobi redigeerimisvoogu.

# temperature=0: deterministlik (automaatne lõpetamine)
# temperature=0.3: veidi loominguline (mitu soovitust)
# temperature=0.7: loominguline (koodi ajurünnak)

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

Kaks mustrit kopeerimiseks ja kleebimiseks

Esimene jäljendab IDE käitumist: jagad faili sisu kursori asukoha kohalt kaheks ja mõlemast poolest saab vastavalt prompt ja suffix.

def autocomplete_ide(file_content: str, cursor_position: int) -> str:
    """Simuleerib IDE automaatset lõpetamist Codestral FIM-iga."""
    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

Teine automatiseerib olemasoleva projekti dokumentatsiooni: annad funktsiooni, hangid selle docstring’i ja süsteemi juhend sunnib ühtset formaati, nii et tulemuse saab sisestada ilma edasise redigeerimiseta.

def generate_docstring(function_code: str) -> str:
    """Genereerib Pythoni funktsioonile docstring'i."""
    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

Veakäitlus

Võrgupäring ebaõnnestub varem või hiljem ja redaktori laiendus, mis jookseb kokku valideerimisvea tõttu, on halvem kui laiendus, mis jätab täienduse tegemata. Seega pakenda oma päringud alati try-except plokki:

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"Valideerimisviga: {e}")
except Exception as e:
    print(f"Ootamatu viga: {e}")

Peamised punktid

  • mistralai SDK pakub FIM-i jaoks client.fim.complete() ja vestluse jaoks client.chat.complete()
  • Parameetrid prompt ja suffix on spetsiifilised FIM-i lõpp-punktile
  • Kasuta automaatseks lõpetamiseks temperature=0 ja loominguliseks genereerimiseks 0.2–0.7
  • stop piirab genereerimise ühtse koodiplokiga
  • min_tokens ja max_tokens kontrollivad väljundi pikkust
  • Käitle tootekoodis alati HTTP-vigu