Għodda code_interpreter: Ħaddem Python
F'din il-paġna
Ħ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_interpreteriħ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