API Codestral i bPython
Ar an leathanach seo
Glaoch ar Codestral ó Python
Sa cheacht seo, bogaimid ón teoiric go dtí cód inrite. Úsáidfidh tú SDK Python Mistral AI chun ceisteanna a chur ar Codestral ar a dhá phointe deiridh, na paraiméadair chasta a choigeartú a dhéanann idirdhealú idir moladh úsáideach agus ceann fadachainteach, agus na patrúin a fheictear i bhformhór na gcomhtháthuithe sa saol mór a chur i bhfeidhm.
Suiteáil agus cumraíocht
Suiteáil an SDK le haon ordú amháin:
pip install mistralai
Faigh do eochair API ó console.mistral.ai agus léigh é ón timpeallacht seachas é a chódú go crua isteach i do chomhad:
import os
from mistralai.client import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
Tá dhá ardán ag freastal ar Codestral, agus roghnaíonn tú eatarthu nuair a chruthaíonn tú d’eochair. Oibríonn api.mistral.ai ar bhonn íocaíochta de réir úsáide le billeáil bunaithe ar úsáid: seo an bealach caighdeánach nuair is comhpháirt amháin i measc go leor eile i bhfeidhmchlár é Codestral. Is pointe deiridh tiomnaithe é codestral.mistral.ai, atá inrochtana saor in aisce nó trí shíntiús, deartha le haghaidh úsáide díreach ag forbróir laistigh dá eagarthóir.
Glao FIM iomlán
Seo glao FIM mionsonraithe leis na paraiméadair thábhachtacha go léir:
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)
An freagra a bhriseadh síos
Níl sa réad a fhilltear ach an téacs ginte. I dtáirgeadh, ba chóir duit trí phíosa eolais a sheiceáil go córasach: an comhlánú féin, an tomhaltas tocain a chinneann do bhille, agus an chúis stoptha, a insíonn duit ar chríochnaigh an tsamhail go nádúrtha nó ar bhual sí do theorainn.
# Rochtain ar an gcomhlánú ginte
text = response.choices[0].message.content
# Seiceáil líon na dtocain a úsáideadh
tokens_prompt = response.usage.prompt_tokens
tokens_completion = response.usage.completion_tokens
tokens_total = response.usage.total_tokens
# Seiceáil an chúis stoptha
reason = response.choices[0].finish_reason # "stop", "length", etc.
Is comhartha soiléir é finish_reason de "length" ar leath do chuid glaonna: tá do max_tokens ró-íseal, agus tá cód gearrtha á sheachadadh agat do d’úsáideoirí.
Glao comhrá le haghaidh giniúint cóid
Nuair nach bhfuil cúrsóir i lár comhaid—mar shampla le haghaidh giniúint iomlán, míniú, nó athchóiriú—glacann an pointe deiridh comhrá seilbh. Ansin, cuimsíonn an teachtaireacht chórais formáid an aschuir, rud a sheachnaíonn an gá leis an bhfreagra a ghlanadh ina dhiaidh sin:
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)
Paraiméadair chasta
Cuirann an péire min_tokens / max_tokens fad an aschuir i gcrích. Tá an t-urlár úsáideach agus tú ag giniúint bloc nach féidir a bheith níos giorrá ná toirt áirithe, mar shampla feidhm lena láimhseáil earráidí.
# min_tokens: éigníonn fad íosta aschuir
# max_tokens: teorannaíonn an fad uasta
response = client.fim.complete(
model="codestral-latest",
prompt=prompt,
suffix=suffix,
min_tokens=20,
max_tokens=300,
)
Bíonn ról difriúil ag tocain stoptha: stopann siad an ghiniúint ar phatrún sonrach, ag coinneáil an chomhlánaithe laistigh de scóip na feidhme reatha in ionad ligean don tsamhail dul i mbun slabhrú isteach sa chéad cheann eile.
# Stop an ghiniúint ar phatrúin shonracha
response = client.fim.complete(
model="codestral-latest",
prompt=prompt,
suffix=suffix,
stop=["\n\n", "\nclass ", "\ndef "], # Stop roimh fheidhm/aicme nua
)
Ar deireadh, rialaíonn an teocht an inathraitheacht. Ag 0, tugann an t-ionchur céanna an t-aschur céanna i gcónaí, rud a éilíonn uathchomhlánú. Timpeall 0.3, molann an tsamhail leaganacha éagsúla, rud atá suimiúil agus tú ag taispeáint moltaí iolracha. Ag 0.7, tá tú i mód brainstorming cóid, atá úsáideach chun cur chuige a iniúchadh ach nach oiriúnach do shreabha eagarthóireachta.
# temperature=0: cinntitheach (uathchomhlánú)
# temperature=0.3: beagán cruthaitheach (moltaí iolracha)
# temperature=0.7: cruthaitheach (brainstorming cóid)
response = client.fim.complete(
model="codestral-latest",
prompt=prompt,
suffix=suffix,
temperature=0.3,
top_p=0.95,
)
Dhá phatrún le cóipeáil agus greamú
Atáirgeann an chéad cheann iompraíocht IDE: roinneann tú ábhar an chomhaid ag suíomh an chúrsóra, agus is iad an leid agus an iarmhír an dá leath.
def autocomplete_ide(file_content: str, cursor_position: int) -> str:
"""Simulates IDE auto-completion with 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
Uathoibríonn an dara ceann doiciméadú do thionscadal atá ann cheana: cuirfeadh tú feidhm isteach, faigheann tú a docstring, agus cuireann an treoir chórais formáid amháin i bhfeidhm ionas go gcuirtear an toradh isteach gan aon eagarthóireacht bhreise.
def generate_docstring(function_code: str) -> str:
"""Generates a docstring for a Python function."""
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
Láimhseáil earráidí
Theipfidh ar ghlao líonra sooner nó later, agus tá leathnú eagarthóra a thuileann ar earráid bailíochtaithe níos measa ná leathnú gan aon chomhlánú. Dá bhrí sin, cuimsigh do chuid glaonna i gcónaí:
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}")
Príomhphointí
- Nochtann an SDK
mistralaiclient.fim.complete()le haghaidh FIM agusclient.chat.complete()le haghaidh comhrá - Tá na paraiméadair
promptagussuffixsonrach don phointe deiridh FIM - Úsáid
temperature=0le haghaidh uathchomhlánaithe,0.2-0.7le haghaidh giniúint chruthaitheach - Teorannaíonn
stopan ghiniúint go bloc cóid comhleanúnach - Rialaíonn
min_tokensagusmax_tokensfad an aschuir - Láimhseáil earráidí HTTP i gcónaí i gcód táirgeachta