Agenti kódu v praxi: API, Vibe Code CLI a Vibe Code Web
Na této stránce
Lekce přepsána 2. listopadu 2026. Protože byl Devstral 31. července 2026 odstraněn z API, příklady API zde používají Mistral Small 4. Sekce Vibe odráží aktuální dokumentaci Vibe Code: instalace, vestavěný model (Mistral Medium 3.5) a tři rozhraní – CLI, rozšíření VS Code a Vibe Code Web. Zdroje: Instalace a nastavení · Volba mezi CLI, VS Code nebo webovými relacemi · Konfigurace.
Tři způsoby, jak nasadit agenta do práce
Agentní model je jen tak dobrý, jak dobře ho propojíš s reálnou prací. Mistral nabízí tři cesty: API, kde si svého agenta postavíš sám; Vibe Code lokálně ve tvém terminálu nebo VS Code; a Vibe Code Web, který spouští agenta ve vzdáleném sandboxu proti repozitáři na GitHubu. Každá z nich sedí na jinou část vývojářova dne.
Prostřednictvím Mistral API
API je nejflexibilnější rozhraní: umožňuje ti budovat vlastní agentní workflow s tvými vlastními nástroji a řídicí logikou. Začni tím nejjednodušším případem, voláním chatu bez nástrojů. Zde odešleme funkci pro autentizaci s bezpečnostní slabinou modelu Mistral Small 4 a požádáme o diagnózu. Nastavení temperature=0 není jen dekorace: pro bezpečnostní analýzu potřebuješ reprodukovatelné výsledky, ne variace od jednoho spuštění 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)
Agentní režim mění povahu výměny. Místo přijímání textu deklarujete nástroje, které může model požádat o zavolání, a model vrací tool_calls – název nástroje a jeho argumenty. Níže uvedené tři nástroje tvoří minimální základ pro agenta kódu: čtení souboru, zápis do souboru, spuštění příkazu. S nimi se instrukce „pidej typové anotace ke všem souborům v src/utils/“ stane proveditelnou, zatímco v režimu chatu by zůstala pouze návrhem.
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 se nic nespustí samo: smyčka – zavolat nástroj, vrátit výstup modelu, požádat o další krok – zůstává zcela na tobě. To je cena za flexibilitu a přesně to za tebe řeší CLI Vibe.
Lokálně přes Vibe Code: CLI a rozšíření VS Code
Vibe Code je režim „code“ produktu Vibe, agenta od Mistralu. Lokálně existuje ve dvou formách, které sdílejí stejný engine, konfiguraci a historii relací: CLI v tvém terminálu a rozšíření VS Code, které přidává kontext editoru (aktivní soubor, výběr, diffy). Instalace CLI zabere na macOS a Linuxu jeden řádek:
# Oficiální instalátor (nainstaluje uv, pokud je třeba, a poté balíček mistral-vibe)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Nebo manuální instalace
uv tool install mistral-vibe
Poté přejdi do svého projektu a spusť vibe. Při prvním spuštění tě průvodce vyzve k přihlášení pomocí tvého účtu Mistral (Vibe Code je součástí plánů, limity využití závisí na plánu) nebo k zadání API klíče. Poté komunikuješ s agentem jako s kolegou, který má ruce 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 (čtení/zápis souborů, příkazy shellu) i agentní smyčku, kterou jsi musel při použití API psát ručně. Je dodáván s vestavěným modelem Mistral Medium 3.5 a příkaz /model ti umožňuje vybrat jiný z těch nakonfigurovaných (Small 4, Codestral, lokální model…). Změny a příkazy procházejí schvalovacím systémem, který si pro každého agenta nastavíš: zkontroluj je, než agentovi svěříš důležitý repozitář. Pro automatizaci slouží vibe --prompt, které spustí neinteraktivní provedení, užitečné v continuous integration.
Prostřednictvím Vibe Code Web
Vibe Code Web je třetí rozhraní: kokpit pro vzdálené agenty. Vytvoříš projekt z jednoho nebo více repozitářů na GitHubu pod stejným vlastníkem, spustíš relaci s přesnou instrukcí a agent pracuje ve sandboxu spravovaném v cloudu: naklonuje repozitář, naplánuje změny, upraví kód, spustí příkazy a testy, a poté pro tebe připraví větev nebo pull request k revizi na GitHubu. Není potřeba žádná lokální kopie a tvůj stroj může zůstat uzamčený, zatímco agent pracuje. Z CLI příkaz /teleport přenese probíhající relaci na web.
CLI nebo rozšíření zvol, když úkol závisí na souborech, službách nebo tajných klíčích, které jsou přítomny pouze na tvém stroji.
Srovnání tří cest
| Kritérium | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Agentní smyčka | Píšeš ji ty | Vestavěná | Vestavěná |
| Přístup k souborům | Přes tvé nástroje | Lokální pracovní kopie | Vzdálený sandbox, GitHub repo |
| Model | Ten, který zavoláš | Vestavěný Medium 3.5, ostatní volitelné | Engine Vibe Code |
| Neinteraktivní režim | Ano | Ano (vibe --prompt, pouze CLI) | Ne |
| Případ použití | Pipeline, vlastní produkty | Denní vývoj | Dlouhodobé úlohy na vzdáleném repu |
Čteno zprava doleva tato tabulka popisuje gradient kontroly: čím více se posouváš směrem k API, tím více rozhoduješ o všem, včetně toho, co se může rozbít.
Co v praxi dělá rozdíl
Kvalita výsledků závisí méně na modelu než na tom, jak formuluješ svůj požadavek. „Pidej validaci“ nechává agenta vymyslet si umístění, styl a pravidla; „Pidej validaci e-mailu v src/auth/validators.py pomocí existujícího vzoru“ mu dává soubor, konvenci a hranice. Ve stejném duchu explicitně cituj relevantní soubory a omezení projektu, místo abys doufal, že je uhodne.
Ověření zůstává nepostradatelné: kompetentní agent může stále zavést regresi, zejména když sahá do více souborů najednou. Zvykni si před přijetím změn zkontrolovat diff, stejně jako bys to udělal u pull requestu od nového zaměstnance. A měj na paměti finální nastavení: výběr správného nástroje. Pro denní vývoj používej Vibe Code lokálně, pro dlouhodobé úlohy na vzdáleném repu Vibe Code Web a pro vlastní pipeline API.
Klíčové poznatky
- API poskytuje totální kontrolu: píšeš nástroje i agentní smyčku
- Vibe Code se instaluje příkazem
curl -LsSf https://mistral.ai/vibe/install.sh | bash(nebouv tool install mistral-vibe) a je dodáván s Mistral Medium 3.5 - CLI a rozšíření VS Code sdílejí konfiguraci a relace;
vibe --promptslouží pro automatizaci - Vibe Code Web spouští agenta ve vzdáleném sandboxu a vytváří větve a pull requesty
- Přesné instrukce a revize diffů zůstávají zásadní