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

Uirlis code_interpreter: Rith Python

Ceacht 9 as 18 Nuashonraithe 2 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Rith Cód sa Scamall Mistral
  2. Gníomhaire a Chruthú le Code Interpreter
  3. Feidhmiú a Thosú
  4. Struchtúr na Freagartha
  5. Cad a Athraíonn an Uirlis sa Chleachtas
  6. Comhcheangal le hUirlisí Eile
  7. Teorainneacha na Gainimhlinne
  8. Príomhphointí

Rith Cód sa Scamall Mistral

Ligeann an uirlis code_interpreter do d’ghníomhaire cód Python a scríobh agus a rith laistigh de choimeádán gainimh (sandboxed). Is é an rogha idéalach é seo le haghaidh ríomhaireachtaí, anailís sonraí, giniúint cairteacha, agus bailíochtú cóid. Ní ábhar áisiúlachta amháin atá ann: nuair a “ríomhann” LLM ina cheann féin, bíonn toradh inchreidte ann, ní toradh cruinn. Trí an oibríocht a aistriú chuig ateangaire fíor, cuirtear tuar tocain in ionad feidhmithe incháilte, rud a thugann cód duit is féidir leat a athbhreithniú.

Gníomhaire a Chruthú le Code Interpreter

Éilíonn treoracha an ghníomhaire seo go dtaispeánfaidh sé an cód sula ndéanfaidh sé é a rith, rud a thugann pointe rialaithe duit ar an méid a ritheann i ndáiríre.

from mistralai.client import Mistral
import os

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

agent = client.beta.agents.create(
    model="mistral-medium-latest",
    name="Code Agent",
    instructions="""You are a Python programming assistant.
- Use the code interpreter to run code when necessary
- Always show the code before executing it
- Explain results clearly""",
    tools=[{"type": "code_interpreter"}],
    completion_args={"temperature": 0.3, "top_p": 0.95}
)

Feidhmiú a Thosú

Tá iarratas ríomha simplí go leor chun an uirlis a spreagadh; níl aon treoir speisialta uait.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Calculate the first 20 Fibonacci numbers."
)

Ansin scríobhann an gníomhaire script Python chun an seicheamh a ríomh, ritheann sé sa ghaineamhlann, agus cuireann sé na torthaí i láthair mar aon le míniúcháin. Tagann an fhíor fheidhmiú as na fiche luach a fhaigheann tú: beidh siad cruinn fiú thar an bpointe a dtosaíonn samhaltóir de ghnáth ag déanamh botúin.

Struchtúr na Freagartha

Is féidir leat an mheicníocht seo a léamh go díreach sna hiontrálacha a filltear, agus caithfidh do chód idirdhealú a dhéanamh idir téacs agus torthaí feidhmithe.

for entry in response.outputs:
    if entry.type == "message.output":
        # First response: "I will calculate..." or final result
        print(f"Message: {entry.content}")

    elif entry.type == "tool.execution":
        # Executed code and result
        print(f"Code: {entry.info.code}")
        print(f"Output: {entry.info.code_output}")

Tosaíonn an gníomhaire le message.output ag fógrú cad atá sé ar tí a dhéanamh. Ansin tagann an tool.execution áit a ritheann an cód: tá an script in info.code, agus tá a aschur in info.code_output. Dúnann dara message.output an seicheamh, áit a ndéanann an gníomhaire na torthaí a léirmhíniú agus a mhíniú. Is iad an dá réimse seo, info.code agus info.code_output, do lorg iniúchta—coinnigh iad i do logaí feidhmchláir, mar ligeann siad duit aon fhigiúr a tháirgeann an gníomhaire a athsheinm agus a cheistiú.

Cad a Athraíonn an Uirlis sa Chleachtas

Is é an anailís sonraí an cás úsáide is láithrí. Tabhair sraith luachanna agus iarr staitisticí: ríomhtar an meán, an meánluach, agus an diall caighdeánach, ní dhéantar meastachán orthu.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="""Here are the monthly sales (in K€): 
    Jan: 120, Feb: 135, Mar: 142, Apr: 128, May: 155, Jun: 168
    Calculate the mean, median, standard deviation, and trend."""
)

Leathnaíonn giniúint cairteacha ar an gcumas seo go nádúrtha, ós rud é go bhfuil leabharlanna plotála san áireamh sa timpeallacht.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Create a bar chart of cloud market shares in Europe: AWS 31%, Azure 25%, GCP 11%, OVH 8%, Others 25%"
)

Úsáideann an gníomhaire matplotlib chun an chairt a ghiniúint. Is comhad íomhá é an toradh atá inrochtana sa fhreagra—mar sin déan cinnte go láimhsíonn do chód léitheoireachta an cás seo, nó críochnóidh tú ag taispeáint an nóta tráchta téacsúil atá ina theannta amháin.

Is é bailíochtú cóid an tríú cás úsáide, nach bhfuil chomh soiléir sin ach atá luachmhar. Cuir feidhm agus na cásanna tástála le clúdach faoi bhráid: ní dhéanann an gníomhaire réasúnú faoin gcód amháin, ritheann sé é. Sa sampla thíos, nochtann an t-ionchur "Madam" locht nach dtabharfadh athbhreithniú simplí cód air dócha.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="""Check if this function is correct:
    
def is_palindrome(s):
    return s == s[::-1]

Test it with: "radar", "hello", "kayak", "Madam"
"""
)

Cuireann matamaitic fheidhmeach críoch leis an liosta: córais cothromóidí a réiteach, ailgéabar líneach, optamú. Arís anseo, braitheann an fhreagra ar réiteoir, ní ar intuíocht.

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Solve the system of equations: 2x + 3y = 12, 4x - y = 5"
)

Comhcheangal le hUirlisí Eile

Is féidir go mbeidh roinnt uirlisí cumasaithe ag gníomhaire ag an am céanna, agus is minic gurb ansin a fheictear an fíorluach: tugann cuardach sonraí úra isteach a ndéanann cód anailís orthu.

agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="Complete Analyst",
    description="Search + Calculation",
    instructions="Search for recent data then analyze it with code.",
    tools=[
        {"type": "web_search"},
        {"type": "code_interpreter"}
    ]
)

response = client.beta.conversations.start(
    agent_id=agent.id,
    inputs="Find the current price of Bitcoin and calculate its percentage change over the last 30 days."
)

Roghnaíonn an gníomhaire go huathoibríoch cé acu uirlis le húsáid ag gach céim. San iarratas seo, slabhraíonn sé an dá cheann: ní féidir leat athrú a ríomh gan na luachanna a fháil ar dtús, agus ní féidir leat na luachanna sin a fháil gan rochtain ar an ngréasán.

Teorainneacha na Gainimhlinne

Forchuireann an timpeallacht aonair seo srianta ar chóir duit a bheith ar an eolas fúthu sula ndearann tú d’fheidhmchlár. Tá leabharlanna teoranta: tá pacáistí caighdeánacha Python ar fáil—numpy, pandas, matplotlib, i measc cinn eile—ach níl gach pacáiste tríú páirtí ann, rud a chuireann do spleáchais inmheánacha as an áireamh. Níl rochtain líonra ag an gcód, mar sin caithfidh sonraí teacht chuige trí chomhthéacs nó trí uirlis eile, riamh trí ghlao HTTP a scríobhtar sa script. Tá am feidhmithe teoranta, mar sin bristear próisis fhada: bris toirteanna móra ina bpíosaí in ionad súil a bheith agat le pas amháin. Ar deireadh, níl aon mharthanacht idir glaonna; ní aimsítear comhad a cruthaíodh le linn feidhmithe amháin sa chéad fheidhmiú eile.

Príomhphointí

  • Ritheann code_interpreter Python i ngaineamhlann shlán ar thaobh Mistral
  • Tá an cód a feidhmíodh (info.code) agus a aschur (info.code_output) sa fhreagra
  • Idealach le haghaidh ríomhaireachtaí, anailís sonraí, agus giniúint cairteacha
  • Is féidir é a chomhcheangal le huirlisí eile (web_search, srl.)
  • Tá teorainneacha ag an ngaineamhlann: gan rochtain líonra, leabharlanna teoranta, gan mharthanacht