Koodiagendid praktikas: API, Vibe Code CLI ja Vibe Code Web
Sellel lehel
Tund kirjutati ümber 2. novembril 2026. Kuna Devstral eemaldati API-st 31. juulil 2026, kasutavad siinsed API näited Mudelit Mistral Small 4. Vibe’i jaotis peegeldab jooksvat Vibe Code’i dokumentatsiooni: paigaldamine, sisseehitatud mudel (Mistral Medium 3.5) ja kolm kasutusviisi – CLI, VS Code’i laiendus ning Vibe Code Web. Allikad: Paigaldamine ja seadistamine · Vali CLI, VS Code või veebiseansid · Konfiguratsioon.
Kolm viisi agendi tööle rakendamiseks
Agentne mudel on nii hea, kui hästi sa selle reaalse tööga ühendad. Mistral pakub kolme teed: API, kus ehidad oma agendi ise; Vibe Code kohapeal, kas terminalis või VS Code’is; ning Vibe Code Web, mis käitab agenti kauges liivakastis GitHubi hoidla vastu. Igaüks neist sobib arendaja päeva erinevateks osadeks.
Läbi Mistrali API
API on kõige paindlikum liides: see võimaldab sul luua oma agentseid töövooge oma tööriistade ja juhtimisloogikaga. Alusta lihtsaimast juhtumist – vestluskõnest ilma tööriistadeta. Siin saadame Mistral Small 4-le haavatava autentimisfunktsiooni ja palume diagnoosi. Parameetri temperature=0 määramine pole iluasi: turvaanalüüsi jaoks vajad korratavaid tulemusi, mitte variatsioone ühest käivitusest teise.
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{
"role": "system",
"content": "You are an expert development agent. Analyze the provided code and propose improvements."
},
{
"role": "user",
"content": """Here is a Python file that handles authentication.
Identify security issues and propose fixes:
def login(username, password):
query = f"SELECT * FROM users WHERE username='{username}' AND password='{password}'"
user = db.execute(query).fetchone()
if user:
session['user_id'] = user['id']
return True
return False
"""
}
],
temperature=0,
max_tokens=2000,
)
print(response.choices[0].message.content)
Agentne režiim muudab suhtluse olemust. Teksti vastuvõtmise asemel deklareerid tööriistad, mida mudel võib paluda kutsuda, ja mudel tagastab tool_calls – tööriista nime ja selle argumendid. Allpool olevad kolm tööriista moodustavad koodiagendi minimaalse aluse: faili lugemine, faili kirjutamine, käsu käivitamine. Nendega muutub käsk „lisa tüübivihjed kõigile failidele kaustas src/utils/“ täidetavaks, samas kui vestlusrežiimis jääks see vaid soovituseks.
tools = [
{
"type": "function",
"function": {
"name": "read_file",
"description": "Read the contents of a source file",
"parameters": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Relative path to the file"
}
},
"required": ["path"]
}
}
},
{
"type": "function",
"function": {
"name": "write_file",
"description": "Write content to a file",
"parameters": {
"type": "object",
"properties": {
"path": {"type": "string"},
"content": {"type": "string"}
},
"required": ["path", "content"]
}
}
},
{
"type": "function",
"function": {
"name": "run_command",
"description": "Execute a shell command",
"parameters": {
"type": "object",
"properties": {
"command": {"type": "string"}
},
"required": ["command"]
}
}
}
]
response = client.chat.complete(
model="mistral-small-2603",
messages=[
{
"role": "user",
"content": "Explore the project and add Python type hints to all files in the src/utils/ directory"
}
],
tools=tools,
tool_choice="auto",
)
# Process the tool calls returned by the model
for tool_call in response.choices[0].message.tool_calls:
print(f"Tool: {tool_call.function.name}")
print(f"Arguments: {tool_call.function.arguments}")
Pane tähele, et midagi ei käivitu iseenesest: tsükkel – kutsu tööriist, tagasta väljund mudelile, küsi järgmist sammu – jääb täielikult sinu vastutusele. See on paindlikkuse hind ja täpselt see, mida Vibe CLI sinu eest haldab.
Läbi Vibe Code’i kohapeal: CLI ja VS Code’i laiendus
Vibe Code on Vibe’i, Mistrali agendi, „koodi“ režiim. Kohapeal on see saadaval kahel kujul, mis jagavad sama mootorit, konfiguratsiooni ja seansiajalugu: CLI sinu terminalis ja VS Code’i laiendus, mis lisab redaktori konteksti (aktiivne fail, valik, erinevused). CLI paigaldamine võtab macOS-is ja Linuxis ühe rea:
# Ametlik paigaldaja (paigaldab vajadusel uv ja seejärel mistral-vibe paketi)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Või käsitsi paigaldamine
uv tool install mistral-vibe
Seejärel liigu oma projekti kausta ja käivita vibe. Esimesel käivitamisel küsib nõustaja sisselogimist oma Mistrali kontoga (Vibe Code kuulub paketidesse, kasutuspiirangud sõltuvad paketist) või API-võtme sisestamist. Seejärel suhtled agendiga nagu kolleegiga, kelle käed on klaviatuuril:
Explain this project's architecture.
Add an API route /health that returns the server status, along with its test.
Run the test suite and fix what fails.
Vibe pakub tööriistu ise (faili lugemine/kirjutamine, shelli käsud) ja agentset tsüklit, mille pidid API-ga käsitsi kirjutama. Sellega kaasneb sisseehitatud mudel, Mistral Medium 3.5, ning käsk /model võimaldab valida teise konfigureeritud mudelite hulgast (Small 4, Codestral, kohalik mudel…). Muudatused ja käsud läbivad kinnitussüsteemi, mille saad iga agendi jaoks eraldi seadistada: vaata need üle, enne kui usaldad agenti olulise hoidlaga. Automatiseerimiseks käivitab vibe --prompt mitteinteraktiivse täitmise, mis on kasulik pidevas integratsioonis.
Läbi Vibe Code Webi
Vibe Code Web on kolmas kasutusviis: kokpit kaugagentide jaoks. Lood projekti ühest või mitmest sama omaniku GitHubi hoidlast, käivitad seansi täpse juhendiga ja agent töötab pilve hallatavas liivakastis: see kloonib, planeerib, muudab, käivitab käske ja teste ning valmistab seejärel ette haru või tõmbetaotluse, mida saad GitHubis üle vaadata. Kohalikku koopiat pole vaja ja sinu masin võib agendi töö ajal suletud jääda. CLI-st viib käsk /teleport käimasoleva seansi veebi.
Vali CLI või laiendus siis, kui ülesanne sõltub failidest, teenustest või saladustest, mis eksisteerivad ainult sinu masinas.
Kolme tee võrdlus
| Kriteerium | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Agentne tsükkel | Kirjutad ise | Sisseehitatud | Sisseehitatud |
| Failide juurdepääs | Läbi sinu tööriistade | Kohalik töökoopia | Kauge liivakast, GitHubi hoidla |
| Mudel | See, mida kutsud | Sisseehitatud Medium 3.5, teised valikulised | Vibe Code’i mootor |
| Mitteinteraktiivne režiim | Jah | Jah (vibe --prompt, ainult CLI) | Ei |
| Kasutusjuhtum | Torustikud, kohandatud tooted | Igapäevane arendus | Pikaajalised ülesanded kauges hoidlas |
Seda tabelit vasakult paremale lugedes kirjeldab see kontrolli gradienti: mida rohkem liigud API poole, seda rohkem otsustad kõike, sealhulgas seda, mis võib katki minna.
Mis teeb praktikas vahet
Tulemuse kvaliteet sõltub vähem mudelist ja rohkem sellest, kuidas oma päringu sõnastad. „Lisa valideerimine“ jätab agendile võimaluse välja mõelda asukoht, stiil ja reeglid; „Lisa e-posti valideerimine faili src/auth/validators.py, kasutades olemasolevat mustrit“ annab talle faili, konventsiooni ja piiri. Samas vaimus viita sõnaselgelt asjakohastele failidele ja projekti piirangutele, selle asemel et loota, et mudel need ära arvab.
Kontrollimine jääb tingimatuks: pädev agent võib siiski sisse tuua regressiooni, eriti kui ta puudutab korraga mitut faili. Tee harjumuseks vaadata erinevused (diff) üle enne nende aktsepteerimist, täpselt nagu teeksid seda uue töötaja tõmbetaotluse puhul. Ja pea meeles lõplikku seadistust: õige tööriista valimist. Kasuta igapäevaseks arenduseks kohalikku Vibe Code’i, kauges hoidlas pikaajaliste ülesannete jaoks Vibe Code Webi ja oma torustike jaoks API-t.
Peamised punktid
- API annab täieliku kontrolli: kirjutad ise tööriistad ja agentse tsükli
- Vibe Code paigaldatakse käsuga
curl -LsSf https://mistral.ai/vibe/install.sh | bash(võiuv tool install mistral-vibe) ja kaasneb Mudeliga Mistral Medium 3.5 - CLI ja VS Code’i laiendus jagavad konfiguratsiooni ja seansse;
vibe --prompton mõeldud automatiseerimiseks - Vibe Code Web käitab agenti kauges liivakastis ja loob harusid ning tõmbetaotlusi
- Täpsed juhised ja erinevuste ülevaatus jäävad hädavajalikuks