Agenti za kod u praksi: API, Vibe Code CLI i Vibe Code Web
Na ovoj stranici
Lekcija je ponovno napisana 2. studenoga 2026. Budući da je Devstral uklonjen s API-ja 31. srpnja 2026., API primjeri ovdje koriste Mistral Small 4. Odjeljak o Vibeu odražava trenutnu dokumentaciju za Vibe Code: instalacija, ugrađeni model (Mistral Medium 3.5) i tri sučelja—CLI, VS Code proširenje i Vibe Code Web. Izvori: Instalacija i postavljanje · Odabir CLI, VS Code ili web sesija · Konfiguracija.
Tri načina za stavljanje agenta na posao
Agentički model vrijedi onoliko koliko ga dobro povežeš sa stvarnim radom. Mistral nudi tri puta: API, gdje gradiš vlastitog agenta; Vibe Code lokalno, u svom terminalu ili VS Codeu; i Vibe Code Web, koji pokreće agenta u udaljenom sandboxu nasuprot GitHub repozitoriju. Svaki odgovara drugom dijelu programerova dana.
Putem Mistral API-ja
API je najfleksibilnije sučelje: omogućuje ti izgradnju vlastitih agentičkih tijekova rada s vlastitim alatima i logikom upravljanja. Kreni od najjednostavnijeg slučaja, poziva chata bez alata. Ovdje šaljemo ranjivu funkciju za autentifikaciju Mistral Smallu 4 i tražimo dijagnozu. Postavljanje temperature=0 nije dekorativno: za sigurnosnu analizu želiš reproducibilne rezultate, a ne varijacije od jednog pokretanja do drugog.
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)
Agentički način mijenja prirodu razmjene. Umjesto primanja teksta, deklariraš alate koje model može zatražiti da pozove, a model vraća tool_calls—naziv alata i njegove argumente. Tri alata u nastavku čine minimalnu osnovu za agenta za kod: čitanje datoteke, pisanje datoteke, pokretanje naredbe. S njima uputa „dodaj tipske napomene svim datotekama u src/utils/“ postaje izvršiva, dok bi u načinu chata ostala samo prijedlog.
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}")
Imaj na umu da se ništa ne izvršava samo od sebe: petlja—pozovi alat, vrati izlaz modelu, zatraži sljedeći korak—ostaje u potpunosti tvoja odgovornost. To je cijena fleksibilnosti, a upravo je to ono što Vibe CLI rješava umjesto tebe.
Putem Vibe Codea lokalno: CLI i VS Code proširenje
Vibe Code je „code“ način rada Vibea, Mistralovog agenta. Lokalno dolazi u dva oblika koji dijele isti pogon, konfiguraciju i povijest sesija: CLI, u tvom terminalu, i VS Code proširenje, koje dodaje kontekst uređivača (aktivna datoteka, odabir, razlike). Instalacija CLI-ja zahtijeva jedan redak na macOSu i Linuxu:
# Official installer (installs uv if needed, then the mistral-vibe package)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Or manual installation
uv tool install mistral-vibe
Zatim se prebaci u svoj projekt i pokreni vibe. Pri prvom pokretanju, čarobnjak će te tražiti da se prijaviš sa svojim Mistral računom (Vibe Code je uključen u planove, s ograničenjima korištenja ovisno o planu) ili da uneseš API ključ. Nakon toga razgovaraš s agentom kao s kolegom koji ima ruke na tipkovnici:
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 sam osigurava alate (čitanje/pisanje datoteka, naredbe ljuske) i agentičku petlju koju si morao ručno napisati koristeći API. Dolazi s ugrađenim modelom, Mistral Medium 3.5, a naredba /model omogućuje ti odabir drugog među onima koji su konfigurirani (Small 4, Codestral, lokalni model…). Promjene i naredbe prolaze kroz sustav odobravanja koji konfiguriraš po agentu: pregledaj ga prije nego mu povjeriš važan repozitorij. Za automatizaciju, vibe --prompt pokreće neinteraktivno izvršavanje, što je korisno u kontinuiranoj integraciji.
Putem Vibe Code Weba
Vibe Code Web treće je sučelje: kokpit za udaljene agente. Stvaraš projekt iz jednog ili više GitHub repozitorija pod istim vlasnikom, pokrećeš sesiju s preciznom uputom, a agent radi u sandboxu kojim upravlja oblak: klonira, planira, modificira, pokreće naredbe i testove, a zatim priprema granu ili pull request za tebe da ga pregledaš na GitHubu. Nije potrebna lokalna kopija, a tvoje računalo može ostati zatvoreno dok agent radi. Iz CLI-ja, naredba /teleport prenosi tekuću sesiju na web.
Odaberi CLI ili proširenje kada zadatak ovisi o datotekama, uslugama ili tajnama koje postoje samo na tvom računalu.
Usporedba triju putova
| Kriterij | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Agentička petlja | Ti je pišeš | Ugrađena | Ugrađena |
| Pristup datotekama | Putem tvojih alata | Lokalna radna kopija | Udaljeni sandbox, GitHub repozitorij |
| Model | Onaj koji pozoveš | Ugrađen Medium 3.5, ostali opcionalni | Vibe Code pogon |
| Neinteraktivni način | Da | Da (vibe --prompt, samo CLI) | Ne |
| Slučaj upotrebe | Cjevovodi, prilagođeni proizvodi | Svakodnevni razvoj | Dugotrajni zadaci na udaljenom repozitoriju |
Čitajući zdesna nalijevo, ova tablica opisuje gradijent kontrole: što se više pomičeš prema API-ju, to više ti odlučuješ o svemu, uključujući i ono što može poći po zlu.
Što u praksi čini razliku
Kvaliteta rezultata manje ovisi o modelu, a više o tome kako formuliraš svoj zahtjev. „Dodaj validaciju“ ostavlja agentu da izmisli lokaciju, stil i pravila; „Dodaj validaciju e-pošte u src/auth/validators.py koristeći postojeći uzorak“ daje mu datoteku, konvenciju i granicu. U istom duhu, eksplicitno navedi relevantne datoteke i ograničenja projekta umjesto da se nadaš da će ih pogoditi.
Verifikacija ostaje neupitna: kompetentan agent ipak može uvesti regresiju, posebno kada dira više datoteka odjednom. Uvedi naviku pregledavanja razlika (diff) prije prihvaćanja, baš kao što bi to učinio za pull request novog zaposlenika. I imaj na umu konačno okruženje: odabir pravog alata. Koristi Vibe Code lokalno za svakodnevni razvoj, Vibe Code Web za dugotrajne zadatke na udaljenom repozitoriju, a API za vlastite cjevovode.
Ključne točke
- API daje potpunu kontrolu: ti pišeš alate i agentičku petlju
- Vibe Code se instalira s
curl -LsSf https://mistral.ai/vibe/install.sh | bash(iliuv tool install mistral-vibe) i dolazi s Mistral Medium 3.5 - CLI i VS Code proširenje dijele konfiguraciju i sesije;
vibe --promptsluži za automatizaciju - Vibe Code Web pokreće agenta u udaljenom sandboxu i proizvodi grane i pull requestove
- Precizne upute i pregled razlika (diff) ostaju ključni