L-API ta' Codestral f'Python
F'din il-paġna
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
mistralaijesponiclient.fim.complete()għal FIM uclient.chat.complete()għaċ-chat - Il-parametri
promptusuffixhuma speċifiċi għall-endpoint FIM - Uża
temperature=0għall-awto-tlestija,0.2-0.7għall-ġenerazzjoni kreattiva stopjillimita l-ġenerazzjoni għal blokka ta’ kodiċi koerentimin_tokensumax_tokensjikkontrollaw it-tul tal-output- Dejjem immaniġġja l-iżbalji HTTP fil-kodiċi tal-produzzjoni