Koda aģenti praksē: API, Vibe Code CLI un Vibe Code Web
Šajā lapā
Nodarbība pārrakstīta 2026. gada 2. novembrī. Tā kā Devstral tika izņemts no API 2026. gada 31. jūlijā, šeit esošie API piemēri izmanto Mistral Small 4. Vibe sadaļa atspoguļo aktuālo Vibe Code dokumentāciju: instalēšanu, iebūvēto modeli (Mistral Medium 3.5) un trīs saskarnes — CLI, VS Code paplašinājumu un Vibe Code Web. Avoti: Instalēšana un iestatīšana · CLI, VS Code vai tīmekļa sesiju izvēle · Konfigurācija.
Trīs veidi, kā likt aģentam strādāt
Aģenta modelis ir tik labs, cik laba ir tā pieslēgšana reālam darbam. Mistral piedāvā trīs ceļus: API, kur tu pats veido savu aģentu; Vibe Code lokāli, savā terminālī vai VS Code; un Vibe Code Web, kas darbina aģentu attālinātā smilškastē (sandbox), strādājot ar GitHub repozitoriju. Katrs no tiem der dažādai izstrādātāja dienas daļai.
Caur Mistral API
API ir elastīgākā saskarne: tas ļauj tev veidot savus aģentu darbplūsmas ar saviem rīkiem un vadības loģiku. Sāc ar vienkāršāko gadījumu — čata izsaukumu bez rīkiem. Šeit mēs nosūtām neaizsargātu autentifikācijas funkciju uz Mistral Small 4 un lūdzam diagnostiku. Iestatījums temperature=0 nav tikai dekorācija: drošības analīzei tev vajag reproducējamus rezultātus, nevis variācijas no viena gājiena uz nākamo.
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)
Aģenta režīms maina mijiedarbības dabu. Teksta saņemšanas vietā tu deklarē rīkus, kurus modelis var pieprasīt izsaukt, un modelis atgriež tool_calls — rīka nosaukumu un tā argumentus. Trīs zemāk esošie rīki veido minimālo pamatu koda aģentam: nolasīt failu, rakstīt failu, izpildīt komandu. Ar tiem instrukcija „pievieno tipu norādes visiem failiem mapē src/utils/” kļūst izpildāma, savukārt čata režīmā tā paliktu tikai ieteikums.
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}")
Ņem vērā, ka nekas netiek izpildīts automātiski: cikls — izsauc rīku, atgriez izvadi modelim, praso nākamo soli — paliek pilnībā tavā ziņā. Tā ir elastīguma cena, un tieši to Vibe CLI paveic tavā vietā.
Caur Vibe Code lokāli: CLI un VS Code paplašinājums
Vibe Code ir Vibe, Mistral aģenta, „koda” režīms. Lokāli tas nāk divos veidos, kuriem ir kopīgs dzinējs, konfigurācija un sesiju vēsture: CLI tavā terminālī un VS Code paplašinājums, kas pievieno redaktora kontekstu (aktīvais fails, atlase, atšķirības). CLI instalēšana macOS un Linux prasa tikai vienu rindiņu:
# Oficiālais instalētājs (instalē uv, ja nepieciešams, tad mistral-vibe pakotni)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Vai manuāla instalēšana
uv tool install mistral-vibe
Tad dodieties uz savu projektu un palaid vibe. Pirmajā palaišanā vednis piedāvās pierakstīties ar savu Mistral kontu (Vibe Code ir iekļauts tarifu plānos, ar lietojuma limitiem atkarībā no plāna) vai ievadīt API atslēgu. Pēc tam tu runā ar aģentu kā ar kolēģi, kuram ir rokas uz tastatūras:
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 pats nodrošina rīkus (failu lasīšana/rakstīšana, čaulas komandas) un aģenta ciklu, kas tev bija jāraksta ar rokām, strādājot ar API. Tas nāk ar iebūvētu modeli Mistral Medium 3.5, un komanda /model ļauj izvēlēties citu no konfigurētajiem (Small 4, Codestral, lokāls models…). Izmaiņas un komandas iziet caur apstiprināšanas sistēmu, ko tu konfigurē katram aģentam atsevišķi: pārskati to, pirms uztic tam svarīgu repozitoriju. Automatizācijai vibe --prompt veic neinteraktīvu izpildi, kas noder nepārtrauktajā integrācijā.
Caur Vibe Code Web
Vibe Code Web ir trešā saskarne: vadības pults attālinātiem aģentiem. Tu izveido projektu no viena vai vairākiem GitHub repozitorijiem pie viena īpašnieka, sāc sesiju ar precīzu instrukciju, un aģents strādā mākoņa pārvaldītā smilškastē: tas klonē, plāno, modificē, palaiž komandas un testus, pēc tam sagatavo zaru vai vilkšanas pieprasījumu (pull request), ko tu vari pārskatīt GitHub. Lokāla kopija nav nepieciešama, un tavs dators var palikt slēgts, kamēr aģents strādā. No CLI komanda /teleport pārnes notiekošo sesiju uz tīmekli.
Izvēlies CLI vai paplašinājumu, ja uzdevums ir atkarīgs no failiem, servisiem vai noslēpumiem, kas pieejami tikai tavā mašīnā.
Trīs ceļu salīdzinājums
| Kritērijs | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Aģenta cikls | Tu to raksti | Iebūvēts | Iebūvēts |
| Pieeja failiem | Caur taviem rīkiem | Lokāla darba kopija | Attālināta smilškaste, GitHub repozitorijs |
| Modelis | Tas, ko tu izsauc | Iebūvēts Medium 3.5, citi pēc izvēles | Vibe Code dzinējs |
| Neinteraktīvs režīms | Jā | Jā (vibe --prompt, tikai CLI) | Nē |
| Lietojuma gadījums | Darbplūsmas, pielāgoti produkti | Ikdienas izstrāde | Ilgstoši uzdevumi attālinātā repozitorijā |
Lasot no labās uz kreiso pusi, šī tabula apraksta kontroles gradientu: jo vairāk tu virzies uz API, jo vairāk tu pats lemj par visu, tostarp par to, kas var salūzt.
Kas praksē rada atšķirību
Rezultātu kvalitāte ir mazāk atkarīga no modeļa un vairāk no tā, kā tu formulē savu pieprasījumu. „Pievieno validāciju” ļauj aģentam pašam izgudrot atrašanās vietu, stilu un noteikumus; „Pievieno e-pasta validāciju failā src/auth/validators.py, izmantojot esošo paraugu” dod tam failu, konvenciju un robežas. Tādā pašā garā eksplicīti norādi attiecīgos failus un projekta ierobežojumus, nevis ceri, ka tas tos uzminēs.
Verifikācija paliek neapstrīdama: kompetents aģents joprojām var ieviest regresiju, it īpaši, ja tas vienlaikus aizskar vairākus failus. Pieradi pārskatīt atšķirības (diff) pirms to apstiprināšanas, tieši tāpat kā darītu ar jauna darbinieka vilkšanas pieprasījumu. Un paturi prātā galīgo iestatījumu: pareizā rīka izvēli. Izmanto Vibe Code lokāli ikdienas izstrādei, Vibe Code Web ilgstošiem uzdevumiem attālinātā repozitorijā un API savām darbplūsmām.
Galvenās atziņas
- API dod pilnīgu kontroli: tu pats raksti rīkus un aģenta ciklu
- Vibe Code instalē ar
curl -LsSf https://mistral.ai/vibe/install.sh | bash(vaiuv tool install mistral-vibe) un nāk ar Mistral Medium 3.5 - CLI un VS Code paplašinājumam ir kopīga konfigurācija un sesijas;
vibe --promptdomāts automatizācijai - Vibe Code Web darbina aģentu attālinātā smilškastē un ģenerē zarus un vilkšanas pieprasījumus
- Precīzas instrukcijas un atšķirību pārskatīšana joprojām ir būtiskas