Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Agenti za kod u praksi: API, Vibe Code CLI i Vibe Code Web

Lekcija 8 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Tri načina za stavljanje agenta na posao
  2. Putem Mistral API-ja
  3. Putem Vibe Codea lokalno: CLI i VS Code proširenje
  4. Putem Vibe Code Weba
  5. Usporedba triju putova
  6. Što u praksi čini razliku
  7. Ključne točke

Lekcija je ponovno napisana 2. studenoga 2026. Budući da je Devstral uklonjen s API-ja 31. srpnja 2026., API primjeri ovdje koriste Mistral Small 4. Odjeljak o Vibeu odražava trenutnu dokumentaciju za Vibe Code: instalacija, ugrađeni model (Mistral Medium 3.5) i tri sučelja—CLI, VS Code proširenje i Vibe Code Web. Izvori: Instalacija i postavljanje · Odabir CLI, VS Code ili web sesija · Konfiguracija.

Tri načina za stavljanje agenta na posao

Agentički model vrijedi onoliko koliko ga dobro povežeš sa stvarnim radom. Mistral nudi tri puta: API, gdje gradiš vlastitog agenta; Vibe Code lokalno, u svom terminalu ili VS Codeu; i Vibe Code Web, koji pokreće agenta u udaljenom sandboxu nasuprot GitHub repozitoriju. Svaki odgovara drugom dijelu programerova dana.

Putem Mistral API-ja

API je najfleksibilnije sučelje: omogućuje ti izgradnju vlastitih agentičkih tijekova rada s vlastitim alatima i logikom upravljanja. Kreni od najjednostavnijeg slučaja, poziva chata bez alata. Ovdje šaljemo ranjivu funkciju za autentifikaciju Mistral Smallu 4 i tražimo dijagnozu. Postavljanje temperature=0 nije dekorativno: za sigurnosnu analizu želiš reproducibilne rezultate, a ne varijacije od jednog pokretanja do drugog.

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)

Agentički način mijenja prirodu razmjene. Umjesto primanja teksta, deklariraš alate koje model može zatražiti da pozove, a model vraća tool_calls—naziv alata i njegove argumente. Tri alata u nastavku čine minimalnu osnovu za agenta za kod: čitanje datoteke, pisanje datoteke, pokretanje naredbe. S njima uputa „dodaj tipske napomene svim datotekama u src/utils/“ postaje izvršiva, dok bi u načinu chata ostala samo prijedlog.

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

Imaj na umu da se ništa ne izvršava samo od sebe: petlja—pozovi alat, vrati izlaz modelu, zatraži sljedeći korak—ostaje u potpunosti tvoja odgovornost. To je cijena fleksibilnosti, a upravo je to ono što Vibe CLI rješava umjesto tebe.

Putem Vibe Codea lokalno: CLI i VS Code proširenje

Vibe Code je „code“ način rada Vibea, Mistralovog agenta. Lokalno dolazi u dva oblika koji dijele isti pogon, konfiguraciju i povijest sesija: CLI, u tvom terminalu, i VS Code proširenje, koje dodaje kontekst uređivača (aktivna datoteka, odabir, razlike). Instalacija CLI-ja zahtijeva jedan redak na macOSu i Linuxu:

# 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

Zatim se prebaci u svoj projekt i pokreni vibe. Pri prvom pokretanju, čarobnjak će te tražiti da se prijaviš sa svojim Mistral računom (Vibe Code je uključen u planove, s ograničenjima korištenja ovisno o planu) ili da uneseš API ključ. Nakon toga razgovaraš s agentom kao s kolegom koji ima ruke 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 osigurava alate (čitanje/pisanje datoteka, naredbe ljuske) i agentičku petlju koju si morao ručno napisati koristeći API. Dolazi s ugrađenim modelom, Mistral Medium 3.5, a naredba /model omogućuje ti odabir drugog među onima koji su konfigurirani (Small 4, Codestral, lokalni model…). Promjene i naredbe prolaze kroz sustav odobravanja koji konfiguriraš po agentu: pregledaj ga prije nego mu povjeriš važan repozitorij. Za automatizaciju, vibe --prompt pokreće neinteraktivno izvršavanje, što je korisno u kontinuiranoj integraciji.

Putem Vibe Code Weba

Vibe Code Web treće je sučelje: kokpit za udaljene agente. Stvaraš projekt iz jednog ili više GitHub repozitorija pod istim vlasnikom, pokrećeš sesiju s preciznom uputom, a agent radi u sandboxu kojim upravlja oblak: klonira, planira, modificira, pokreće naredbe i testove, a zatim priprema granu ili pull request za tebe da ga pregledaš na GitHubu. Nije potrebna lokalna kopija, a tvoje računalo može ostati zatvoreno dok agent radi. Iz CLI-ja, naredba /teleport prenosi tekuću sesiju na web.

Odaberi CLI ili proširenje kada zadatak ovisi o datotekama, uslugama ili tajnama koje postoje samo na tvom računalu.

Usporedba triju putova

KriterijPython APIVibe Code (CLI, VS Code)Vibe Code Web
Agentička petljaTi je pišešUgrađenaUgrađena
Pristup datotekamaPutem tvojih alataLokalna radna kopijaUdaljeni sandbox, GitHub repozitorij
ModelOnaj koji pozovešUgrađen Medium 3.5, ostali opcionalniVibe Code pogon
Neinteraktivni načinDaDa (vibe --prompt, samo CLI)Ne
Slučaj upotrebeCjevovodi, prilagođeni proizvodiSvakodnevni razvojDugotrajni zadaci na udaljenom repozitoriju

Čitajući zdesna nalijevo, ova tablica opisuje gradijent kontrole: što se više pomičeš prema API-ju, to više ti odlučuješ o svemu, uključujući i ono što može poći po zlu.

Što u praksi čini razliku

Kvaliteta rezultata manje ovisi o modelu, a više o tome kako formuliraš svoj zahtjev. „Dodaj validaciju“ ostavlja agentu da izmisli lokaciju, stil i pravila; „Dodaj validaciju e-pošte u src/auth/validators.py koristeći postojeći uzorak“ daje mu datoteku, konvenciju i granicu. U istom duhu, eksplicitno navedi relevantne datoteke i ograničenja projekta umjesto da se nadaš da će ih pogoditi.

Verifikacija ostaje neupitna: kompetentan agent ipak može uvesti regresiju, posebno kada dira više datoteka odjednom. Uvedi naviku pregledavanja razlika (diff) prije prihvaćanja, baš kao što bi to učinio za pull request novog zaposlenika. I imaj na umu konačno okruženje: odabir pravog alata. Koristi Vibe Code lokalno za svakodnevni razvoj, Vibe Code Web za dugotrajne zadatke na udaljenom repozitoriju, a API za vlastite cjevovode.

Ključne točke

  • API daje potpunu kontrolu: ti pišeš alate i agentičku petlju
  • Vibe Code se instalira s curl -LsSf https://mistral.ai/vibe/install.sh | bash (ili uv tool install mistral-vibe) i dolazi s Mistral Medium 3.5
  • CLI i VS Code proširenje dijele konfiguraciju i sesije; vibe --prompt služi za automatizaciju
  • Vibe Code Web pokreće agenta u udaljenom sandboxu i proizvodi grane i pull requestove
  • Precizne upute i pregled razlika (diff) ostaju ključni