Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Agenti za kodiranje v praksi: API, Vibe Code CLI in Vibe Code Web

Lekcija 8 od 14 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Trije načini za uporabo agenta
  2. Prek API-ja Mistral
  3. Lokalno prek Vibe Code: CLI in razširitev za VS Code
  4. Prek Vibe Code Web
  5. Primerjava treh poti
  6. Kaj v praksi naredi razliko
  7. Ključne ugotovitve

Lekcija ponovno napisana 2. novembra 2026. Ker je bil Devstral 31. julija 2026 umaknjen iz API-ja, primeri API-ja tukaj uporabljajo Mistral Small 4. Razdelek o Vibeu odraža trenutno dokumentacijo Vibe Code: namestitev, vgrajeni model (Mistral Medium 3.5) in tri površine – CLI, razširitev za VS Code ter Vibe Code Web. Viri: Namestitev in nastavitev · Izbira sej CLI, VS Code ali web · Konfiguracija.

Trije načini za uporabo agenta

Agentski model je dober toliko, kolikor dobro ga povežeš z realnim delom. Mistral ponuja tri poti: API, kjer si agenta zgradiš sam; Vibe Code lokalno, v terminalu ali VS Code; in Vibe Code Web, ki agenta zažene v oddaljenem peskovniku zoper GitHub skladišče. Vsaka ustreza drugemu delu razvijalčevega dneva.

Prek API-ja Mistral

API je najbolj prilagodljiv vmesnik: omogoča ti gradnjo lastnih agentskih delotokov z lastnimi orodji in nadzorno logiko. Začni z najpreprostejšim primerom, klicem klepeta brez orodij. Tukaj pošljemo ranljivo funkcijo za avtentikacijo modelu Mistral Small 4 in zahtevamo diagnozo. Nastavitev temperature=0 ni zgolj dekorativna: pri varnostni analizi želiš ponovljive rezultate, ne variacij med posameznimi zagoni.

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)

Agentski način spremeni naravo izmenjave. Namesto prejemanja besedila deklariraš orodja, ki jih model lahko zahteva za klic, model pa vrne tool_calls – ime orodja in njegove argumente. Spodnja tri orodja tvorijo minimalno osnovo za agenta za kodiranje: branje datoteke, zapisovanje v datoteko, zagon ukaza. Z njimi postane navodilo „dodaj tipske namige vsem datotekam v src/utils/” izvedljivo, medtem ko bi v načinu klepeta ostalo le predlog.

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}")

Upoštevaj, da se nič ne izvrši samodejno: zanka – klic orodja, vrnitev izhoda modelu, zahteva za naslednji korak – ostaja v celoti tvoja odgovornost. To je cena prilagodljivosti in prav to je tisto, kar CLI Vibe opravi namesto tebe.

Lokalno prek Vibe Code: CLI in razširitev za VS Code

Vibe Code je način „code” Vibea, Mistralovega agenta. Lokalno je na voljo v dveh oblikah, ki si delita isti pogon, konfiguracijo in zgodovino sej: CLI v terminalu in razširitev za VS Code, ki doda kontekst urejevalnika (aktivna datoteka, izbor, razlike). Namestitev CLI-ja na macOS in Linuxu zahteva eno vrstico:

# 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

Nato se pomakni v svoje projekt in zaženi vibe. Ob prvem zagonu te čarovnik pozove, da se prijaviš s svojim računom Mistral (Vibe Code je vključen v načrte, z omejitvami uporabe glede na načrt) ali vpišeš ključ API. Nato z agentom govoriš kot s kolegom, ki ima roke 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 zagotavlja orodja (branje/zapisovanje datotek, ukazi lupine) in agentsko zanko, ki si jo moral pri API-ju napisati ročno. Priložen ima vgrajen model, Mistral Medium 3.5, ukaz /model pa ti omogoča izbiro drugega med konfiguriranimi (Small 4, Codestral, lokalni model …). Spremembe in ukazi gredo skozi sistem odobritve, ki ga konfiguriraš na agenta: pregledaj ga, preden mu zaupaš pomembno skladišče. Za avtomatizacijo vibe --prompt zažene neinteraktivno izvajanje, kar je uporabno pri neprekinjeni integraciji.

Prek Vibe Code Web

Vibe Code Web je tretja površina: kokpit za oddaljene agente. Ustvariš projekt iz enega ali več GitHub skladišč pod istim lastnikom, začneš sejo s preciznim navodilom in agent dela v peskovniku, ki ga upravlja oblak: klonira, načrtuje, spreminja, izvaja ukaze in teste, nato pa pripravi vejo ali zahtevek za združitev (pull request), ki ga pregledaš v GitHubu. Lokalna kopija ni potrebna, tvoj računalnik pa lahko med delom agenta ostane zaprt. Iz CLI-ja ukaz /teleport prenese tekočo sejo na splet.

CLI ali razširitev izberi, ko naloga temelji na datotekah, storitvah ali skrivnostih, prisotnih le na tvojem računalniku.

Primerjava treh poti

MeriloPython APIVibe Code (CLI, VS Code)Vibe Code Web
Agentska zankaNapišeš jo samVgrajenaVgrajena
Dostop do datotekPrek tvojih orodijLokalna delovna kopijaOddaljeni peskovnik, GitHub skladišče
ModelTisti, ki ga pokličešVgrajen Medium 3.5, drugi opcijskiPogon Vibe Code
Neinteraktivni načinDaDa (vibe --prompt, samo CLI)Ne
Primer uporabeCevovodi, izdelki po meriVsakodnevni razvojDolgotrajne naloge na oddaljenem skladišču

Če tabelo bereš od desne proti levi, opisuje gradient nadzora: bolj ko se premikaš proti API-ju, več se odločaš sam, vključno s tem, kaj se lahko pokvari.

Kaj v praksi naredi razliko

Kakovost rezultatov je manj odvisna od modela kot od načina, kako oblikuješ svojo zahtevo. „Dodaj validacijo” prepusti agentu, da si izmisli lokacijo, slog in pravila; „Dodaj validacijo e-pošte v src/auth/validators.py z uporabo obstoječega vzorca” pa mu da datoteko, konvencijo in meje. V istem duhu izrecno navedi ustrezne datoteke in omejitve projekta, namesto da upaš, da jih bo uganil.

Preverjanje ostaja nepogrešljivo: usposobljen agent lahko še vedno vnese regresijo, še posebej ko se dotakne več datotek hkrati. Naj ti postane navada, da pred sprejemom pregledaš razlike (diff), prav tako kot bi pri zahtevku za združitev novega sodelavca. In imej v mislih končno nastavitev: izbiro pravega orodja. Vibe Code lokalno uporabi za vsakodnevni razvoj, Vibe Code Web za dolgotrajne naloge na oddaljenem skladišču in API za svoje cevovode.

Ključne ugotovitve

  • API daje popoln nadzor: ti napišeš orodja in agentsko zanko
  • Vibe Code namestiš z curl -LsSf https://mistral.ai/vibe/install.sh | bash (ali uv tool install mistral-vibe) in prihaja z Mistral Medium 3.5
  • CLI in razširitev za VS Code si delita konfiguracijo in seje; vibe --prompt je za avtomatizacijo
  • Vibe Code Web zažene agenta v oddaljenem peskovniku in ustvari veje ter zahtevke za združitev
  • Natančna navodila in pregled razlik ostajata bistvena