Orodje code_interpreter: Izvajanje kode Python
Na tej strani
Izvajanje kode v oblaku Mistral
Orodje code_interpreter omogoča tvojemu agentu, da napiše in izvrši kodo Python v izoliranem vsebniku (sandbox). Je idealna izbira za izračune, analizo podatkov, ustvarjanje grafikonov in validacijo kode. Ne gre le za priročnost: veliki jezikovni model (LLM), ki „računa” v svoji glavi, proizvede verjeten rezultat, ne nujno pravilnega. S prenosom operacije na pravi interpreter nadomestiš napovedovanje žetonov z preverljivim izvajanjem, kar ti daje kodo, ki jo lahko pregledaš.
Ustvarjanje agenta z interpreterjem kode
Navodila za tega agenta zahtevajo, da prikaže kodo pred njenim izvajanjem, kar ti daje nadzorno točko nad tem, kaj se dejansko izvrši.
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}
)
Sprožitev izvajanja
Za sprožitev orodja zadostuje preprosta zahteva za izračun; posebna navodila s tvoje strani niso potrebna.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Calculate the first 20 Fibonacci numbers."
)
Agent nato napiše skript Python za izračun zaporedja, ga zažene v izoliranem okolju in predstavi rezultate skupaj s pojasnili. Dobljenih dvajset vrednosti izvira iz dejanskega izvajanja: bodo točne tudi onkraj točke, kjer bi model običajno začel delati napake.
Struktura odgovora
Ta mehanizem lahko prebereš neposredno iz vrnjenih vnosov; tvoja koda mora razlikovati med besedilom in rezultati izvajanja.
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}")
Agent začne z message.output, ki napoveduje, kaj namerava storiti. Sledi tool.execution, kjer se koda izvrši: info.code vsebuje skript, info.code_output pa njegov izpis. Zaporedje zaključi drugo sporočilo message.output, v katerem agent interpretira in pojasni rezultate. Ti dve polji, info.code in info.code_output, sta tvoja revizijska sled – hrani ju v dnevnikih svoje aplikacije, saj ti omogočata ponovitev in izpodbijanje katere koli številke, ki jo proizvede agent.
Kaj orodje spremeni v praksi
Analiza podatkov je najbolj neposredna uporaba. Zagotovi niz vrednosti in zahtevaj statistiko: povprečje, mediana in standardni odklon se izračunajo, ne ocenijo.
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."""
)
Ustvarjanje grafikonov naravno nadgrajuje to zmogljivost, saj okolje vključuje knjižnice za risanje grafikov.
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%"
)
Agent uporabi matplotlib za generiranje grafikona. Rezultat je slikovna datoteka, dostopna v odgovoru – zato poskrbi, da tvoja koda za branje obravnava ta primer, sicer boš prikazal le spremno besedilo.
Validacija kode je tretji primer uporabe, manj očiten, a dragocen. Predloži funkcijo in testne primere, ki jih je treba pokriti: agent se o kodi ne le razmišlja, temveč jo tudi zažene. V spodnjem primeru vhod "Madam" razkrije napako, ki bi jo preprost pregled kode verjetno spregledal.
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"
"""
)
Uporabna matematika zaokroži seznam: reševanje sistemov enačb, linearna algebra, optimizacija. Tudi tukaj odgovor temelji na reševalniku, ne na intuiciji.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Solve the system of equations: 2x + 3y = 12, 4x - y = 5"
)
Kombiniranje z drugimi orodji
Agent ima lahko hkrati omogočenih več orodij in prav tu se pogosto pokaže prava vrednost: iskanje prinese sveže podatke, ki jih koda pretvori v analizo.
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."
)
Agent samodejno izbere, katero orodje uporabiti v vsakem koraku. Pri tej zahtevi ju poveže v verigo: spremembe ne moreš izračunati, ne da bi najprej pridobil vrednosti, teh vrednosti pa ne moreš dobiti brez dostopa do spleta.
Omejitve izoliranega okolja (Sandbox)
To izolirano okolje nalaga omejitve, ki jih moraš poznati pred načrtovanjem svoje aplikacije. Knjižnice so omejene: na voljo so standardni paketi Python – numpy, pandas, matplotlib med drugimi – ne pa vsi paketi tretjih strani, kar izključuje tvoje interne odvisnosti. Koda nima dostopa do omrežja, zato morajo podatki do nje prispeti prek konteksta ali drugega orodja, nikoli prek klica HTTP, zapisanega v skriptu. Čas izvajanja je omejen, zato se dolgotrajni procesi prekinejo: velike količine razdeli na manjše dele, namesto da bi upal na en sam prehod. Nazadnje, med klici ni trajnosti; datoteka, ustvarjena med enim izvajanjem, v naslednjem ne bo najdena.
Ključne ugotovitve
code_interpreterizvaja Python v varnem izoliranem okolju na strani Mistral- Odgovor vsebuje izvršeno kodo (
info.code) in njen izpis (info.code_output) - Idealno za izračune, analizo podatkov in ustvarjanje grafikonov
- Lahko se kombinira z drugimi orodji (web_search itd.)
- Izolirano okolje ima omejitve: brez dostopa do omrežja, omejene knjižnice, brez trajnosti