Nástroj code_interpreter: Spúšťanie Pythonu
Na tejto strane
Spúšťanie kódu v cloude Mistral
Nástroj code_interpreter umožňuje tvojmu agentovi písať a spúšťať kód Python v izolovanom kontajneri (sandbox). Je ideálnou voľbou pre výpočty, analýzu dát, generovanie grafov a overovanie kódu. Nejde len o pohodlie: LLM, ktorý „počíta“ v hlave, produkuje vierohodný výsledok, nie nutne správny. Prenesením operácie na skutočný interpret nahradíš predpovedanie tokenov overiteľným vykonaním, čím získaš kód, ktorý môžeš skontrolovať.
Vytvorenie agenta s Code Interpreter
Inštrukcie pre tohto agenta vyžadujú, aby zobrazil kód pred jeho vykonaním, čím ti poskytuje kontrolný bod nad tým, čo sa skutočne spustí.
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}
)
Spustenie vykonania
Na aktiváciu nástroja stačí jednoduchá požiadavka na výpočet; nie je potrebná žiadna špeciálna inštrukcia od teba.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Calculate the first 20 Fibonacci numbers."
)
Agent následne napíše skript v Pythone na výpočet postupnosti, spustí ho v sandboxe a predstaví výsledky spolu s vysvetleniami. Dvadsať hodnôt, ktoré dostaneš, pochádza zo skutočného vykonania: budú presné aj za bodom, kde model zvyčajne začína robiť chyby.
Štruktúra odpovede
Tento mechanizmus môžeš čítať priamo v vrátených záznamoch a tvoj kód musí rozlišovať medzi textom a výsledkami vykonania.
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 položkou message.output, ktorá oznamuje, čo chystá urobiť. Nasleduje tool.execution, kde sa kód spustí: info.code obsahuje skript a info.code_output drží jeho výstup. Sekvenciu uzatvára druhá položka message.output, v ktorej agent interpretuje a vysvetľuje výsledky. Tieto dve polia, info.code a info.code_output, sú tvojím auditným záznamom – uchovávaj ich v logoch svojej aplikácie, pretože ti umožňujú replayovať a spochybniť akúkoľvek hodnotu vyprodukovanú agentom.
Čo nástroj mení v praxi
Analýza dát je najbezprostrednejším prípadom použitia. Poskytni sériu hodnôt a požiadaj o štatistiky: priemer, medián a smerodajná odchýlka sa vypočítajú, nie odhadnú.
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."""
)
Generovanie grafov prirodzene rozširuje túto schopnosť, keďže prostredie obsahuje knižnice na vykresľovanie.
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 použije knižnicu matplotlib na vygenerovanie grafu. Výsledkom je obrazový súbor dostupný v odpovedi – uisti sa preto, že tvoj čítací kód tento prípad obsluhuje, inak skončíš len pri zobrazení sprievodného textového komentára.
Overovanie kódu je tretím prípadom použitia, menej zrejmým, no cenným. Predlož funkciu a testovacie prípady, ktoré má pokryť: agent o kóde nielen uvažuje, ale aj ho spustí. V nižšie uvedenom príklade vstup "Madam" odhalí chybu, ktorú by jednoduchá kontrola kódu pravdepodobne prehliadla.
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"
"""
)
Aplikovaná matematika uzatvára zoznam: riešenie sústav rovníc, lineárna algebra, optimalizácia. Aj tu sa odpoveď opiera o riešiteľ, nie o intuíciu.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Solve the system of equations: 2x + 3y = 12, 4x - y = 5"
)
Kombinácia s inými nástrojmi
Agent môže mať súčasne povolených viacero nástrojov a práve tu sa často prejavuje skutočná hodnota: vyhľadávanie prináša čerstvé dáta, ktoré kód transformuje na analýzu.
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 automaticky vyberie, ktorý nástroj použiť v každom kroku. V tejto požiadavke ich zreťazí: zmenu nemôžeš vypočítať bez predchádzajúceho získania hodnôt a tieto hodnoty nemôžeš získať bez prístupu na web.
Obmedzenia sandboxu
Toto izolované prostredie ukladá obmedzenia, ktoré by si mal poznať pred navrhovaním svojej aplikácie. Knižnice sú obmedzené: štandardné balíky Pythonu sú dostupné – numpy, pandas, matplotlib a ďalšie – ale nie všetky balíky tretích strán, čo vylučuje tvoje interné závislosti. Kód nemá prístup k sieti, takže dáta sa k nemu musia dostať cez kontext alebo iný nástroj, nikdy nie prostredníctvom HTTP volania napísaného v skripte. Čas vykonania je ohraničený, takže dlho bežiace procesy sa prerušia: veľké objemy rozdeľuj namiesto toho, aby si dúfal v jeden priechod. Nakoniec, medzi volaniami neexistuje perzistencia; súbor vytvorený počas jedného vykonania sa v ďalšom nenájde.
Kľúčové poznatky
code_interpreterspúšťa Python v zabezpečenom sandboxe na strane Mistral- Odpoveď obsahuje vykonaný kód (
info.code) a jeho výstup (info.code_output) - Ideálne pre výpočty, analýzu dát a generovanie grafov
- Dá sa kombinovať s inými nástrojmi (web_search atď.)
- Sandbox má obmedzenia: žiadny prístup k sieti, obmedzené knižnice, žiadna perzistencia