Gyakorlati kódügynökök: API, Vibe Code CLI és Vibe Code Web
Ezen az oldalon
Lecke átírva: 2026. november 2. Mivel a Devstralt 2026. július 31-én eltávolították az API-ból, az itt szereplő API-példák a Mistral Small 4 modellt használják. A Vibe rész a jelenlegi Vibe Code dokumentációt tükrözi: telepítés, beépített modell (Mistral Medium 3.5) és a három felület – CLI, VS Code bővítmény és Vibe Code Web. Források: Telepítés és beállítás · Válassz CLI, VS Code vagy webes munkamenetet · Konfiguráció.
Három módszer az ügynök munkára fogására
Egy ügynökmodell csak annyira jó, amennyire sikerül összekapcsolnod a valós munkával. A Mistral három utat kínál: az API-t, ahol saját ügynököt építhetsz; a Vibe Code-ot helyben, a terminálodban vagy a VS Code-ban; valamint a Vibe Code Webet, amely távoli homokozóban futtatja az ügynököt egy GitHub-tárolóval szemben. Mindegyik a fejlesztői napod más-más szakaszához illik.
A Mistral API-n keresztül
Az API a legrugalmasabb felület: lehetővé teszi, hogy saját eszközeiddel és vezérlési logikáddal építsd fel saját ügynöki munkafolyamataidat. Kezdjük a legegyszerűbb esettel: egy eszközök nélküli chat-hívással. Itt beküldünk egy sebezhető hitelesítési függvényt a Mistral Small 4 modellnek, és diagnózist kérünk. A temperature=0 beállítás nem díszítés: biztonsági elemzésnél reprodukálható eredményekre van szükséged, nem pedig futtatásonkénti változékonyságra.
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)
Az ügynöki mód megváltoztatja a kommunikáció természetét. Szöveg fogadása helyett olyan eszközöket deklarálhatsz, amelyeket a modell meghívhat, a modell pedig tool_calls objektumokat ad vissza – ezek tartalmazzák az eszköz nevét és argumentumait. Az alábbi három eszköz alkotja a kódügynök minimális alapját: fájl olvasása, fájl írása, parancs futtatása. Ezekkel az „adj típusjelöléseket a src/utils/ összes fájljához“ utasítás végrehajthatóvá válik, míg chat módban csupán javaslat maradna.
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}")
Vedd észre, hogy semmi sem hajtódik végre magától: a ciklus – eszköz meghívása, kimenet visszaküldése a modellnek, következő lépés kérése – teljes mértékben a te felelősséged. Ez a rugalmasság ára, és pontosan ezt kezeli helyetted a Vibe CLI.
Helyi Vibe Code: a CLI és a VS Code bővítmény
A Vibe Code a Vibe, azaz a Mistral ügynökének „kód“ módja. Helyi szinten két formában érhető el, amelyek ugyanazt a motort, konfigurációt és munkamenet-előzményeket használják: a CLI a terminálodban, és a VS Code bővítmény, amely szerkesztői kontextust ad hozzá (aktív fájl, kijelölés, diffek). A CLI telepítése macOS és Linux alatt egyetlen sor:
# Hivatalos telepítő (szükség esetén telepíti az uv-t, majd a mistral-vibe csomagot)
curl -LsSf https://mistral.ai/vibe/install.sh | bash
# Vagy manuális telepítés
uv tool install mistral-vibe
Ezután navigálj a projekted könyvtárába, és futtasd a vibe parancsot. Első indításkor egy varázsló kérni fogja, hogy jelentkezz be a Mistral-fiókodba (a Vibe Code része az előfizetéseknek, a használati korlátok az előfizetési csomagtól függenek), vagy add meg az API-kulcsodat. Ezután úgy beszélgethetsz az ügynökkel, mint egy kollégával, akinek a keze a billentyűzeten van:
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.
A Vibe maga biztosítja az eszközöket (fájl olvasás/írás, shell parancsok) és azt az ügynöki ciklust, amelyet az API használatakor kézzel kellett megírnod. Alapértelmezetten egy beépített modellt, a Mistral Medium 3.5-öt tartalmazza, a /model parancs pedig lehetővé teszi más, konfigurált modellek (Small 4, Codestral, helyi modell stb.) kiválasztását. A módosítások és parancsok egy jóváhagyási rendszeren mennek keresztül, amelyet ügynökönként konfigurálhatsz: tekintsd át őket, mielőtt megbízod az ügynököt egy fontos tárolóval. Automatizáláshoz a vibe --prompt parancs nem interaktív végrehajtást végez, ami folyamatos integráció esetén hasznos.
A Vibe Code Weben keresztül
A Vibe Code Web a harmadik felület: egy irányítópult távoli ügynökök számára. Létrehozhatsz egy projektet egy vagy több, ugyanazon tulajdonoshoz tartozó GitHub-tárolóból, elindíthatsz egy munkamenetet egy pontos utasítással, és az ügynök egy felhő által kezelt homokozóban dolgozik: klónozza a kódot, tervez, módosít, parancsokat és teszteket futtat, majd előkészít egy branchet vagy pull requestet, amelyet te a GitHubon bírálsz el. Nincs szükség helyi másolatra, és a géped zárva maradhat, miközben az ügynök dolgozik. A CLI-ből a /teleport parancs áthelyezi a folyamatban lévő munkamenetet a webes felületre.
A CLI-t vagy a bővítményt akkor válaszd, ha a feladat olyan fájloktól, szolgáltatásoktól vagy titkoktól függ, amelyek csak a saját gépeden érhetők el.
A három út összehasonlítása
| Kritérium | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Ügynöki ciklus | Te írod meg | Beépített | Beépített |
| Fájlhozzáférés | A saját eszközeiden keresztül | Helyi munkamásolat | Távoli homokozó, GitHub tároló |
| Modell | Amit meghívsz | Beépített Medium 3.5, mások opcionálisak | Vibe Code motor |
| Nem interaktív mód | Igen | Igen (vibe --prompt, csak CLI) | Nem |
| Használati eset | Folyamatok, egyedi termékek | Napi fejlesztés | Hosszú futású feladatok távoli tárolón |
Jobbról balra olvasva ez a táblázat a kontroll fokozatosságát írja le: minél inkább az API felé mész, annál több mindent te döntesz el, beleértve azt is, mi romolhat el.
Ami a gyakorlatban számít
Az eredmény minősége kevésbé függ a modelltől, mint attól, hogyan fogalmazod meg a kérésedet. A „adj hozzá validálást“ utasítás az ügynökre bízza a helyszín, stílus és szabályok kitalálását; a „adj hozzá e-mail validálást a src/auth/validators.py fájlban a meglévő mintát követve“ megadja a fájlt, a konvenciót és a határokat. Ugyanebben a szellemben hivatkozz expliciten a releváns fájlokra és projektkorlátokra, ahelyett, hogy remélnéd, hogy kitalálja őket.
Az ellenőrzés nem tárgyalható: egy hozzáértő ügynök is okozhat regressziót, különösen, ha egyszerre több fájlt érint. Szoktasd rá magad, hogy elfogadás előtt átnézed a diffet, ugyanúgy, mint egy új munkatárs pull requestjét. És tartsd szem előtt a végső beállítást: a megfelelő eszköz kiválasztását. Használd a helyi Vibe Code-ot a napi fejlesztéshez, a Vibe Code Webet a távoli tárolón futó hosszú feladatokhoz, az API-t pedig a saját folyamataidhoz.
Főbb megállapítások
- Az API teljes kontrollt biztosít: te írod meg az eszközöket és az ügynöki ciklust
- A Vibe Code telepítése:
curl -LsSf https://mistral.ai/vibe/install.sh | bash(vagyuv tool install mistral-vibe), és a Mistral Medium 3.5 modellt tartalmazza - A CLI és a VS Code bővítmény megosztja a konfigurációt és a munkameneteket; a
vibe --promptaz automatizálást szolgálja - A Vibe Code Web távoli homokozóban futtatja az ügynököt, és brancheket valamint pull requesteket készít elő
- A pontos utasítások és a diffek áttekintése továbbra is elengedhetetlen