Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

API Codestral i bPython

Ceacht 3 as 14 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Glaoch ar Codestral ó Python
  2. Suiteáil agus cumraíocht
  3. Glao FIM iomlán
  4. Glao comhrá le haghaidh giniúint cóid
  5. Paraiméadair chasta
  6. Dhá phatrún le cóipeáil agus greamú
  7. Láimhseáil earráidí
  8. Príomhphointí

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 mistralai client.fim.complete() le haghaidh FIM agus client.chat.complete() le haghaidh comhrá
  • Tá na paraiméadair prompt agus suffix sonrach don phointe deiridh FIM
  • Úsáid temperature=0 le haghaidh uathchomhlánaithe, 0.2-0.7 le haghaidh giniúint chruthaitheach
  • Teorannaíonn stop an ghiniúint go bloc cóid comhleanúnach
  • Rialaíonn min_tokens agus max_tokens fad an aschuir
  • Láimhseáil earráidí HTTP i gcónaí i gcód táirgeachta