Tööriist code_interpreter: Pythoni käivitamine
Sellel lehel
Koodi käivitamine Mistrali pilves
Tööriist code_interpreter võimaldab sinu agendil kirjutada ja käivitada Pythoni koodi liivakastiga isoleeritud konteineris. See on ideaalne valik arvutuste, andmeanalüüsi, diagrammide loomise ja koodi valideerimise jaoks. See ei puuduta ainult mugavust: LLM, mis „arvutab“ oma peas, toodab usutava, mitte tingimata õige tulemuse. Tehte delegeerimisega tegelikule interpretaatorile asendad tokenite ennustamise kontrollitava täitmisega, saades tulemuseks koodi, mida saad üle vaadata.
Code Interpreteriga agendi loomine
Selle agendi juhised nõuavad, et kood näidataks enne selle käivitamist, andes sulle kontrollpunkti selle üle, mida tegelikult käivitatakse.
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}
)
Täitmise käivitamine
Lihtne arvutustaotlus piisab tööriista käivitamiseks; sinult pole vaja erilisi juhiseid.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Calculate the first 20 Fibonacci numbers."
)
Agent kirjutab seejärel Pythoni skripti jada arvutamiseks, käivitab selle liivakastis ja esitab tulemused koos selgitustega. Saadavad kakskümmend väärtust pärinevad tegelikust täitmisest: need on täpsed isegi seal, kus mudel tavaliselt vigu tegema hakkaks.
Vastuse struktuur
Seda mehhanismi saad lugeda otse tagastatud kirjetest ja sinu kood peab eristama teksti ning täitmise tulemusi.
for entry in response.outputs:
if entry.type == "message.output":
# Esimene vastus: "I will calculate..." või lõpptulemus
print(f"Message: {entry.content}")
elif entry.type == "tool.execution":
# Käivitatud kood ja tulemus
print(f"Code: {entry.info.code}")
print(f"Output: {entry.info.code_output}")
Agent alustab sõnumiga message.output, teatades, mida ta kavatseb teha. Järgneb tool.execution, kus kood käivitub: info.code sisaldab skripti ja info.code_output selle väljundit. Jada lõpetab teine message.output, milles agent tõlgendab ja selgitab tulemusi. Need kaks välja, info.code ja info.code_output, on sinu auditeerimisjälg – hoia neid oma rakenduse logides, kuna need võimaldavad sul agendi toodetud arve uuesti esitada ja vaidlustada.
Mida tööriist praktikas muudab
Andmeanalüüs on kõige ilmsem kasutusjuhtum. Esita väärtuste jada ja küsi statistikat: keskmine, mediaan ja standardhälve arvutatakse, mitte ei hinnata.
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."""
)
Diagrammide loomine laiendab seda võimekust loomulikult, kuna keskkond sisaldab joonistamise teeke.
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 kasutab diagrammi loomiseks matplotlib’i. Tulemuseks on pildifail, millele vastuses ligi pääseb – seega veendu, et sinu lugemiskood seda juhtumit käsitleb, muidu kuvad vaid kaasnevat tekstikommentaari.
Koodi valideerimine on kolmas, vähem ilmne, kuid väärtuslik kasutusjuhtum. Esita funktsioon ja testjuhtumid, mida katma tuleb: agent ei mõtle koodist lihtsalt läbi, vaid käivitab selle. Allpool toodud näites paljastab sisend "Madam" vea, mille lihtne koodiülevaatus tõenäoliselt märkamata jätaks.
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"
"""
)
Rakendusmatemaatika ümbritseb seda nimekirja: võrrandisüsteemide lahendamine, lineaarne algebra, optimeerimine. Ka siin tugineb vastus lahendajale, mitte intuitsioonile.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Solve the system of equations: 2x + 3y = 12, 4x - y = 5"
)
Kombineerimine teiste tööriistadega
Agendil võib olla samaaegselt lubatud mitu tööriista ja sageli ilmneb tegelik väärtus just siis: otsing toob värsked andmed, mille kood muudab analüüsiks.
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 valib automaatselt, millist tööriista igas etapis kasutada. Selles taotluses aheldab ta need kaks: muutust ei saa arvutada, enne kui väärtused on hangitud, ja neid väärtusi ei saa hankida ilma veebiühenduseta.
Liivakasti piirangud
See isoleeritud keskkond seab piiranguid, mida peaksid teadma enne oma rakenduse kavandamist. Teegid on piiratud: standardsed Pythoni paketid on saadaval – näiteks numpy, pandas, matplotlib –, kuid mitte kõik kolmandate osapoolte paketid, mis välistab sinu sisemised sõltuvused. Koodil puudub võrguühendus, seega peavad andmed jõudma sinna konteksti või mõne muu tööriista kaudu, mitte kunagi skripti kirjutatud HTTP-päringuga. Täitmisaeg on piiratud, seega katkestatakse pikalt kestvad protsessid: jaga suured mahud osadeks, selle asemel et loota ühele läbimisele. Lõpuks, kõnede vahel puudub püsivus; ühe täitmise käigus loodud faili järgmises ei leita.
Peamised punktid
code_interpreterkäivitab Pythoni turvalises liivakastis Mistrali poolel- Vastus sisaldab käivitatud koodi (
info.code) ja selle väljundit (info.code_output) - Ideaalne arvutuste, andmeanalüüsi ja diagrammide loomise jaoks
- Saab kombineerida teiste tööriistadega (web_search jne)
- Liivakastil on piirangud: puudub võrguühendus, piiratud teegid, puudub püsivus