Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Gyakorlati kódügynökök: API, Vibe Code CLI és Vibe Code Web

8. lecke 14 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Három módszer az ügynök munkára fogására
  2. A Mistral API-n keresztül
  3. Helyi Vibe Code: a CLI és a VS Code bővítmény
  4. A Vibe Code Weben keresztül
  5. A három út összehasonlítása
  6. Ami a gyakorlatban számít
  7. Főbb megállapítások

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ériumPython APIVibe Code (CLI, VS Code)Vibe Code Web
Ügynöki ciklusTe írod megBeépítettBeépített
FájlhozzáférésA saját eszközeiden keresztülHelyi munkamásolatTávoli homokozó, GitHub tároló
ModellAmit meghívszBeépített Medium 3.5, mások opcionálisakVibe Code motor
Nem interaktív módIgenIgen (vibe --prompt, csak CLI)Nem
Használati esetFolyamatok, egyedi termékekNapi fejlesztésHosszú 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 (vagy uv 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 --prompt az 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