Agenti kódu v praxi: API, Vibe Code CLI a Vibe Code Web
Na tejto strane
Lekcia prepísaná 2. novembra 2026. Keďže bol Devstral 31. júla 2026 odstránený z API, príklady API tu používajú Mistral Small 4. Sekcia Vibe odráža aktuálnu dokumentáciu Vibe Code: inštalácia, vstavaný model (Mistral Medium 3.5) a tri rozhrania – CLI, rozšírenie pre VS Code a Vibe Code Web. Zdroje: Inštalácia a nastavenie · Výber medzi CLI, VS Code alebo webovými reláciami · Konfigurácia.
Tri spôsoby, ako nasadiť agenta do práce
Agentický model je taký dobrý, ako dobre ho prepojíš s reálnou prácou. Mistral ponúka tri cesty: API, kde si zostavíš vlastného agenta; Vibe Code lokálne, v termináli alebo vo VS Code; a Vibe Code Web, ktorý spúšťa agenta vo vzdialenom pieskovisku proti repozitáru GitHub. Každá z nich sedí na inú časť dňa vývojára.
Prostredníctvom Mistral API
API je najflexibilnejšie rozhranie: umožňuje ti budovať vlastné agentické workflow s tvojimi vlastnými nástrojmi a riadiacou logikou. Začni najjednoduchším prípadom, volaním chatu bez nástrojov. Tu odovzdáme funkciu zraniteľného overovania modelu Mistral Small 4 a požiadame o diagnostiku. Nastavenie temperature=0 nie je len dekorácia: pri bezpečnostnej analýze chceš reprodukovateľné výsledky, nie variácie od jedného spustenia k druhému.
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)
Agentický režim mení povahu výmeny. Namiesto prijímania textu deklaruješ nástroje, ktoré môže model požiadať o zavolanie, a model vráti tool_calls – názov nástroja a jeho argumenty. Tri nižšie uvedené nástroje tvoria minimálny základ pre agenta kódu: čítať súbor, zapisovať do súboru, spustiť príkaz. S nimi sa inštrukcia „pridaj typové nápovedy do všetkých súborov v src/utils/“ stáva vykonateľnou, zatiaľ čo v režime chatu by zostala len návrhom.
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}")
Všimni si, že sa nič nevykoná samo: slučka – zavolať nástroj, vrátiť výstup modelu, požiadať o ďalší krok – zostáva úplne na tebe. To je cena za flexibilitu a presne to za teba vybavuje Vibe CLI.
Lokálne cez Vibe Code: CLI a rozšírenie pre VS Code
Vibe Code je režim „code“ produktu Vibe, agenta od Mistralu. Lokálne existuje v dvoch formách, ktoré zdieľajú rovnaký engine, konfiguráciu a históriu relácií: CLI v tvojom termináli a rozšírenie pre VS Code, ktoré pridáva kontext editora (aktívny súbor, výber, diffy). Inštalácia CLI zaberie jeden riadok na macOS a Linuxe:
# Oficiálny inštalátor (nainštaluje uv, ak je potrebné, potom balík mistral-vibe)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Alebo manuálna inštalácia
uv tool install mistral-vibe
Potom prejdite do svojho projektu a spustite vibe. Pri prvom spustení ťa sprievodca vyzve na prihlásenie pomocou účtu Mistral (Vibe Code je súčasťou plánov, s limitmi využívania v závislosti od plánu) alebo na zadanie API kľúča. Potom komunikuješ s agentom ako s kolegom, ktorý má ruky na klávesnici:
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 poskytuje nástroje samo (čítanie/zápis súborov, príkazy shellu) aj agentickú slučku, ktorú si musel pri API napísať ručne. Dodáva sa s vstavaným modelom, Mistral Medium 3.5, a príkaz /model ti umožňuje vybrať iný z tých, ktoré sú nakonfigurované (Small 4, Codestral, lokálny model…). Zmeny a príkazy prechádzajú schvaľovacím systémom, ktorý konfigurujete pre každého agenta: skontroluj ho skôr, než mu zveríš dôležitý repozitár. Pre automatizáciu slúži vibe --prompt, ktoré spustí neinteraktívne vykonanie, užitočné pri kontinuálnej integrácii.
Prostredníctvom Vibe Code Web
Vibe Code Web je tretie rozhranie: kokpit pre vzdialených agentov. Vytvoríš projekt z jedného alebo viacerých repozitárov GitHub pod rovnakým vlastníkom, spustíš reláciu s presnou inštrukciou a agent pracuje v pieskovisku spravovanom v cloude: naklonuje repozitár, naplánuje prácu, upraví kód, spustí príkazy a testy, a potom pre teba pripraví vetvu alebo pull request na kontrolu v GitHub-e. Nie je potrebná žiadna lokálna kópia a tvoj počítač môže zostať uzavretý, kým agent pracuje. Z CLI príkaz /teleport prenesie prebiehajúcu reláciu na web.
CLI alebo rozšírenie si vyber vtedy, keď úloha závisí od súborov, služieb alebo tajomstiev, ktoré sú prítomné len na tvojom stroji.
Porovnanie troch ciest
| Kritérium | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Agentická slučka | Napíšeš ju ty | Vstavaná | Vstavaná |
| Prístup k súborom | Cez tvoje nástroje | Lokálna pracovná kópia | Vzdialené pieskovisko, repozitár GitHub |
| Model | Ten, ktorý zavoláš | Vstavaný Medium 3.5, ostatné voliteľné | Engine Vibe Code |
| Neinteraktívny režim | Áno | Áno (vibe --prompt, len CLI) | Nie |
| Prípad použitia | Pipeline, vlastné produkty | Denný vývoj | Dlhodobé úlohy na vzdialenom repozitári |
Ak čítaš túto tabuľku sprava doľava, opisuje gradient kontroly: čím viac sa posúvaš smerom k API, tým viac rozhoduješ o všetkom, vrátane toho, čo sa môže pokaziť.
Čo v praxi robí rozdiel
Kvalita výsledkov závisí menej od modelu a viac od toho, ako sformuluješ svoju požiadavku. „Pridaj validáciu“ necháva agenta vymyslieť si umiestnenie, štýl a pravidlá; „Pridaj validáciu e-mailu v súbore src/auth/validators.py podľa existujúceho vzoru“ mu dáva súbor, konvenciu a hranice. V rovnakom duchu explicitne cituj relevantné súbory a obmedzenia projektu, namiesto toho, aby si dúfal, že ich uhádne.
Overovanie zostáva nenegotiovateľné: kompetentný agent môže stále zaviesť regresiu, najmä keď sa dotýka viacerých súborov naraz. Urob si zvykom skontrolovať diff pred tým, než ho prijmeš, rovnako ako by si to urobil pri pull requeste od nového zamestnanca. A maj na pamäti finálne nastavenie: výber správneho nástroja. Použi Vibe Code lokálne pre denný vývoj, Vibe Code Web pre dlhodobé úlohy na vzdialenom repozitári a API pre vlastné pipeline.
Kľúčové poznatky
- API poskytuje totálnu kontrolu: píšeš nástroje aj agentickú slučku
- Vibe Code sa inštaluje príkazom
curl -LsSf https://mistral.ai/vibe/install.sh | bash(alebouv tool install mistral-vibe) a dodáva sa s modelom Mistral Medium 3.5 - CLI a rozšírenie pre VS Code zdieľajú konfiguráciu a relácie;
vibe --promptslúži na automatizáciu - Vibe Code Web spúšťa agenta vo vzdialenom pieskovisku a produkuje vetvy a pull requesty
- Presné inštrukcie a kontrola diffu zostávajú nevyhnutné