Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għodda code_interpreter: Ħaddem Python

Lezzjoni 9 / 18 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ħaddem il-Kodiċi fil-Cloud ta’ Mistral
  2. Oħloq Aġent b’Code Interpreter
  3. Ibbotta Eżekuzzjoni
  4. Struttura tar-Rispons
  5. X’Tibdel l-Għodda fil-Prattika
  6. Ikkombina ma’ Għodod Oħra
  7. Limitazzjonijiet tas-Sandbox
  8. Punti Ewlenin

Ħaddem il-Kodiċi fil-Cloud ta’ Mistral

L-għodda code_interpreter tippermetti lill-aġent tiegħek jikteb u jħaddem kodiċi Python ġewwa kontenitur iżolat (sandboxed). Hija l-għażla ideali għall-kalkoli, l-analiżi tad-data, il-ġenerazzjoni ta’ grafiċi u l-validazzjoni tal-kodiċi. Dan mhux biss dwar il-konvenjenza: LLM li “jikkalkula” f’moħħu jipproduċi riżultat plawżibbli, mhux wieħed korrett. Billi tagħti din l-operazzjoni lil interpretur reali, inti tissostitwixxi l-previżjoni tat-tokens b’eżekuzzjoni verifikabbli, u tagħtik kodiċi li tista’ tirrevedi.

Oħloq Aġent b’Code Interpreter

L-istruzzjonijiet għal dan l-aġent jeħtieġu li juri l-kodiċi qabel ma jħaddmu, u b’hekk jagħtuk punt ta’ kontroll fuq x’inhu qed jiġi eżegwit attwalment.

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}
)

Ibbotta Eżekuzzjoni

Talba sempliċi għal kalkolu biżżejjed biex tħaddem l-għodda; m’hemmx bżonn ta’ istruzzjoni speċjali min-naħa tiegħek.

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

L-aġent imbagħad jikteb skritt Python biex jikkalkula s-sekwenza, iħaddmu fis-sandbox, u jippreżenta r-riżultati flimkien ma’ spjegazzjonijiet. L-għoxrin valur li tirċievi ġejjin minn eżekuzzjoni attwali: ikunu eżatti anke lil hinn mill-punt fejn mudell normalment jibda jagħmel żbalji.

Struttura tar-Rispons

Tista’ taqra dan il-mekkaniżmu direttament fl-entrati ritornati, u l-kodiċi tiegħek irid jiddistingwi bejn it-test u r-riżultati tal-eżekuzzjoni.

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}")

L-aġent jibda b’message.output li jħabbar x’se jagħmel. Imbagħad jiġi l-tool.execution fejn jiġi eżegwit il-kodiċi: info.code fih l-iskritt, u info.code_output fih l-output tiegħu. It-tieni message.output jagħlaq is-sekwenza, li fih l-aġent jinterpreta u jispjega r-riżultati. Dawn iż-żewġ oqsma, info.code u info.code_output, huma t-traċċa tal-awditjar tiegħek—żommhom fil-logs tal-applikazzjoni tiegħek, peress li jħalluk terġa’ tgħid u tikkontesta kwalunkwe ċifra prodotta mill-aġent.

X’Tibdel l-Għodda fil-Prattika

L-analiżi tad-data hija l-każ ta’ użu l-aktar immedjat. Ipprovdi serje ta’ valuri u itlob statistika: il-medja, il-medjana u d-devjazzjoni standard jiġu kkalkolati, mhux stmati.

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."""
)

Il-ġenerazzjoni ta’ grafiċi testendi din il-kapaċità b’mod naturali, peress li l-ambjent jinkludi libreriji għall-plotting.

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%"
)

L-aġent juża matplotlib biex jiġġenera l-grafiku. Ir-riżultat huwa fajl ta’ immaġni aċċessibbli fir-rispons—għalhekk kun żgur li l-kodiċi tal-qari tiegħek jittratta dan il-każ, inkella tispiċċa turi biss il-kumment testwali li jakkumpanjah.

Il-validazzjoni tal-kodiċi hija t-tielet każ ta’ użu, inqas ovvju iżda prezzjuż. Ibgħat funzjoni u l-każijiet tat-test li trid tkopri: l-aġent mhux biss jirraġuna dwar il-kodiċi, iżda jħaddmu wkoll. Fl-eżempju hawn taħt, l-input "Madam" jiżvela difett li reviżjoni sempliċi tal-kodiċi x’aktarx titlef.

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"
"""
)

Il-matematika applikata tikkumplimenta l-lista: soluzzjoni ta’ sistemi ta’ ekwazzjonijiet, alġebra lineari, ottimizzazzjoni. Hawnhekk ukoll, ir-rispons jiddependi fuq solvitur, mhux fuq l-intuwizzjoni.

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

Ikkombina ma’ Għodod Oħra

Aġent jista’ jkollu għodod multipli attivati fl-istess ħin, u dan huwa spiss fejn tidher il-valur reali: it-tiftix iġib data friska li l-kodiċi jibdel f’analiżi.

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."
)

L-aġent jagħżel awtomatikament liema għodda juża f’kull pass. F’din it-talba, iħabbat iż-żewġ għodod flimkien: ma tistax tikkalkula bidla mingħajr ma l-ewwel tikseb il-valuri, u ma tistax tikseb dawk il-valuri mingħajr aċċess għall-web.

Limitazzjonijiet tas-Sandbox

Dan l-ambjent iżolat jimponi restrizzjonijiet li għandek tkun taf bihom qabel ma tfassal l-applikazzjoni tiegħek. Il-libreriji huma limitati: pakketti standard ta’ Python huma disponibbli—numpy, pandas, matplotlib, fost oħrajn—iżda mhux il-pakketti kollha ta’ partijiet terzi, li jeskludi d-dipendenzi interni tiegħek. Il-kodiċi m’għandux aċċess għan-network, allura d-data trid tilħaq permezz tal-kuntest jew għodda oħra, qatt permezz ta’ sejħa HTTP miktuba fl-iskritt. Il-ħin ta’ eżekuzzjoni huwa limitat, allura proċessi li jdumu ħafna jiġu interrotti: aqsam volumi kbar minflok ma tama f’daqqa waħda. Fl-aħħar nett, m’hemm l-ebda persistenza bejn is-sejħiet; fajl maħluq waqt eżekuzzjoni waħda ma jinstabx fil-prossima.

Punti Ewlenin

  • code_interpreter iħaddem Python f’sandbox sikur fuq in-naħa ta’ Mistral
  • Ir-rispons fih il-kodiċi eżegwit (info.code) u l-output tiegħu (info.code_output)
  • Ideali għall-kalkoli, l-analiżi tad-data u l-ġenerazzjoni ta’ grafiċi
  • Jista’ jiġi kkombinat ma’ għodod oħra (web_search, eċċ.)
  • Is-sandbox għandu limitazzjonijiet: l-ebda aċċess għan-network, libreriji limitati, l-ebda persistenza