Uirlis code_interpreter: Rith Python
Ar an leathanach seo
Rith Cód sa Scamall Mistral
Ligeann an uirlis code_interpreter do d’ghníomhaire cód Python a scríobh agus a rith laistigh de choimeádán gainimh (sandboxed). Is é an rogha idéalach é seo le haghaidh ríomhaireachtaí, anailís sonraí, giniúint cairteacha, agus bailíochtú cóid. Ní ábhar áisiúlachta amháin atá ann: nuair a “ríomhann” LLM ina cheann féin, bíonn toradh inchreidte ann, ní toradh cruinn. Trí an oibríocht a aistriú chuig ateangaire fíor, cuirtear tuar tocain in ionad feidhmithe incháilte, rud a thugann cód duit is féidir leat a athbhreithniú.
Gníomhaire a Chruthú le Code Interpreter
Éilíonn treoracha an ghníomhaire seo go dtaispeánfaidh sé an cód sula ndéanfaidh sé é a rith, rud a thugann pointe rialaithe duit ar an méid a ritheann i ndáiríre.
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}
)
Feidhmiú a Thosú
Tá iarratas ríomha simplí go leor chun an uirlis a spreagadh; níl aon treoir speisialta uait.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Calculate the first 20 Fibonacci numbers."
)
Ansin scríobhann an gníomhaire script Python chun an seicheamh a ríomh, ritheann sé sa ghaineamhlann, agus cuireann sé na torthaí i láthair mar aon le míniúcháin. Tagann an fhíor fheidhmiú as na fiche luach a fhaigheann tú: beidh siad cruinn fiú thar an bpointe a dtosaíonn samhaltóir de ghnáth ag déanamh botúin.
Struchtúr na Freagartha
Is féidir leat an mheicníocht seo a léamh go díreach sna hiontrálacha a filltear, agus caithfidh do chód idirdhealú a dhéanamh idir téacs agus torthaí feidhmithe.
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}")
Tosaíonn an gníomhaire le message.output ag fógrú cad atá sé ar tí a dhéanamh. Ansin tagann an tool.execution áit a ritheann an cód: tá an script in info.code, agus tá a aschur in info.code_output. Dúnann dara message.output an seicheamh, áit a ndéanann an gníomhaire na torthaí a léirmhíniú agus a mhíniú. Is iad an dá réimse seo, info.code agus info.code_output, do lorg iniúchta—coinnigh iad i do logaí feidhmchláir, mar ligeann siad duit aon fhigiúr a tháirgeann an gníomhaire a athsheinm agus a cheistiú.
Cad a Athraíonn an Uirlis sa Chleachtas
Is é an anailís sonraí an cás úsáide is láithrí. Tabhair sraith luachanna agus iarr staitisticí: ríomhtar an meán, an meánluach, agus an diall caighdeánach, ní dhéantar meastachán orthu.
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."""
)
Leathnaíonn giniúint cairteacha ar an gcumas seo go nádúrtha, ós rud é go bhfuil leabharlanna plotála san áireamh sa timpeallacht.
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%"
)
Úsáideann an gníomhaire matplotlib chun an chairt a ghiniúint. Is comhad íomhá é an toradh atá inrochtana sa fhreagra—mar sin déan cinnte go láimhsíonn do chód léitheoireachta an cás seo, nó críochnóidh tú ag taispeáint an nóta tráchta téacsúil atá ina theannta amháin.
Is é bailíochtú cóid an tríú cás úsáide, nach bhfuil chomh soiléir sin ach atá luachmhar. Cuir feidhm agus na cásanna tástála le clúdach faoi bhráid: ní dhéanann an gníomhaire réasúnú faoin gcód amháin, ritheann sé é. Sa sampla thíos, nochtann an t-ionchur "Madam" locht nach dtabharfadh athbhreithniú simplí cód air dócha.
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"
"""
)
Cuireann matamaitic fheidhmeach críoch leis an liosta: córais cothromóidí a réiteach, ailgéabar líneach, optamú. Arís anseo, braitheann an fhreagra ar réiteoir, ní ar intuíocht.
response = client.beta.conversations.start(
agent_id=agent.id,
inputs="Solve the system of equations: 2x + 3y = 12, 4x - y = 5"
)
Comhcheangal le hUirlisí Eile
Is féidir go mbeidh roinnt uirlisí cumasaithe ag gníomhaire ag an am céanna, agus is minic gurb ansin a fheictear an fíorluach: tugann cuardach sonraí úra isteach a ndéanann cód anailís orthu.
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."
)
Roghnaíonn an gníomhaire go huathoibríoch cé acu uirlis le húsáid ag gach céim. San iarratas seo, slabhraíonn sé an dá cheann: ní féidir leat athrú a ríomh gan na luachanna a fháil ar dtús, agus ní féidir leat na luachanna sin a fháil gan rochtain ar an ngréasán.
Teorainneacha na Gainimhlinne
Forchuireann an timpeallacht aonair seo srianta ar chóir duit a bheith ar an eolas fúthu sula ndearann tú d’fheidhmchlár. Tá leabharlanna teoranta: tá pacáistí caighdeánacha Python ar fáil—numpy, pandas, matplotlib, i measc cinn eile—ach níl gach pacáiste tríú páirtí ann, rud a chuireann do spleáchais inmheánacha as an áireamh. Níl rochtain líonra ag an gcód, mar sin caithfidh sonraí teacht chuige trí chomhthéacs nó trí uirlis eile, riamh trí ghlao HTTP a scríobhtar sa script. Tá am feidhmithe teoranta, mar sin bristear próisis fhada: bris toirteanna móra ina bpíosaí in ionad súil a bheith agat le pas amháin. Ar deireadh, níl aon mharthanacht idir glaonna; ní aimsítear comhad a cruthaíodh le linn feidhmithe amháin sa chéad fheidhmiú eile.
Príomhphointí
- Ritheann
code_interpreterPython i ngaineamhlann shlán ar thaobh Mistral - Tá an cód a feidhmíodh (
info.code) agus a aschur (info.code_output) sa fhreagra - Idealach le haghaidh ríomhaireachtaí, anailís sonraí, agus giniúint cairteacha
- Is féidir é a chomhcheangal le huirlisí eile (web_search, srl.)
- Tá teorainneacha ag an ngaineamhlann: gan rochtain líonra, leabharlanna teoranta, gan mharthanacht