Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Kodo agentai praktikoje: API, Vibe Code CLI ir Vibe Code Web

Paskaita 8 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Trys būdai priversti agentą dirbti
  2. Per „Mistral“ API
  3. Per „Vibe Code“ lokaliai: CLI ir VS Code plėtinys
  4. Per „Vibe Code Web“
  5. Trijų kelių palyginimas
  6. Kas praktiškai lemia skirtumą
  7. Svarbiausi punktai

Pamoka perrašyta 2026 m. lapkričio 2 d. Kadangi Devstral buvo pašalintas iš API 2026 m. liepos 31 d., čia pateikiami API pavyzdžiai naudoja „Mistral Small 4“. Skirsnis apie „Vibe“ atspindi naujausią „Vibe Code“ dokumentaciją: diegimą, integruotą modelį („Mistral Medium 3.5“) ir tris sąsajas – CLI, VS Code plėtinį bei „Vibe Code Web“. Šaltiniai: Diegimas ir nustatymas · Pasirinkimas tarp CLI, VS Code arba web sesijų · Konfigūracija.

Trys būdai priversti agentą dirbti

Agentinis modelis yra toks geras, kaip gerai jį sujungi su realiu darbu. „Mistral“ siūlo tris kelius: API, kuriame kuri savo agentą; „Vibe Code“ lokaliai, savo terminale arba VS Code; ir „Vibe Code Web“, kuris paleidžia agentą nuotolinėje smėlio dėžėje (sandbox) dirbti su „GitHub“ saugykla. Kiekvienas tinka skirtingai programuotojo dienos daliai.

Per „Mistral“ API

API yra lanksčiausia sąsaja: ji leidžia kurti savo agentines darbo eigas su savo įrankiais ir valdymo logika. Pradėk nuo paprasčiausio atvejo – pokalbio užklausos be įrankių. Čia pateikiame pažeidžiamą autentifikavimo funkciją „Mistral Small 4“ modeliui ir prašome diagnozės. Nustatyti temperature=0 nėra tik dekoracija: atliekant saugumo analizę tau reikia atkuriamų rezultatų, o ne variacijų nuo vieno paleidimo iki kito.

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)

Agentinis režimas pakeičia bendravimo pobūdį. Užuot gavęs tekstą, tu apibrėži įrankius, kuriuos modelis gali prašyti iškviesti, o modelis grąžina tool_calls – įrankio pavadinimą ir jo argumentus. Toliau pateikti trys įrankiai sudaro minimalų kodo agento pagrindą: skaityti failą, rašyti failą, vykdyti komandą. Su jais instrukcija „pridėti tipų užuominas visiems failams aplanke src/utils/“ tampa vykdoma, tuo tarpu pokalbio režime ji liktų tik pasiūlymu.

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

Atkreipk dėmesį, kad niekas nevykdoma automatiškai: ciklas – iškviesti įrankį, grąžinti išvestį modeliui, paprašyti kito žingsnio – lieka visiškai tavo atsakomybe. Tai yra lankstumo kaina, ir būtent tai „Vibe“ CLI atlieka už tave.

Per „Vibe Code“ lokaliai: CLI ir VS Code plėtinys

„Vibe Code“ yra „Vibe“ – „Mistral“ agento – „kodo“ režimas. Lokaliai jis egzistuoja dviem pavidalais, kurie dalijasi tuo pačiu varikliu, konfigūracija ir sesijų istorija: CLI (komandinė eilutė) tavo terminale ir VS Code plėtinys, kuris suteikia redaktoriaus kontekstą (aktyvus failas, žymėjimas, skirtumai). CLI diegimas „macOS“ ir „Linux“ sistemoms užtrunka vieną eilutę:

# Oficialus diegiklis (prireikus įdiegia uv, tada mistral-vibe paketą)
curl -LsSf https://mistral.ai/vibe/install.sh | bash

# Arba rankinis diegimas
uv tool install mistral-vibe

Tada pereik į savo projekto katalogą ir paleisk vibe. Pirmojo paleidimo metu vedlys paprašys prisijungti naudojant savo „Mistral“ paskyrą („Vibe Code“ įtrauktas į planus, naudojimo limitai priklauso nuo plano) arba įvesti API raktą. Tuomet gali bendrauti su agentu kaip su kolega, kurio rankos yra ant klaviatūros:

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“ pats pateikia įrankius (failų skaitymas/rašymas, shell komandos) ir agentinį ciklą, kurį naudojant API turėjai rašyti rankiniu būdu. Jame yra integruotas modelis „Mistral Medium 3.5“, o komanda /model leidžia pasirinkti kitą iš sukonfigūruotų („Small 4“, „Codestral“, lokalų modelį…). Pakeitimai ir komandos eina per patvirtinimo sistemą, kurią konfigūruoji kiekvienam agentui atskirai: peržiūrėk ją prieš patikėdamas agentui svarbią saugyklą. Automatizavimui vibe --prompt vykdo neinteraktyvų vykdymą, naudingą nuolatinės integracijos (CI) procesuose.

Per „Vibe Code Web“

„Vibe Code Web“ yra trečioji sąsaja: nuotolinių agentų valdymo skydas. Sukuri projektą iš vienos ar kelių „GitHub“ saugyklų, priklausančių tam pačiam savininkui, pradedi sesiją su tiksliu nurodymu, ir agentas dirba debesyje valdomoje smėlio dėžėje: jis klonuoja, planuoja, modifikuoja, vykdo komandas ir testus, o tada paruošia šaką arba „pull request“ peržiūrai „GitHub“. Vietinė kopija nereikalinga, o tavo kompiuteris gali likti uždarytas, kol agentas dirba. Iš CLI komanda /teleport perkelia vykdomą sesiją į web aplinką.

Pasirink CLI arba plėtinį, kai užduotis priklauso nuo failų, servisų arba paslapčių, esančių tik tavo kompiuteryje.

Trijų kelių palyginimas

KriterijusPython APIVibe Code (CLI, VS Code)Vibe Code Web
Agentinis ciklasRašai patsIntegruotasIntegruotas
Priėjimas prie failųPer tavo įrankiusVietinė darbo kopijaNuotolinė smėlio dėžė, GitHub saugykla
ModelisTas, kurį kvietiIntegruotas Medium 3.5, kiti pasirenkamiVibe Code variklis
Neinteraktyvus režimasTaipTaip (vibe --prompt, tik CLI)Ne
Naudojimo atvejisVamzdynai, individualūs produktaiKasdienė kūrybaIlgalaikės užduotys nuotolinėje saugykloje

Skaitant iš dešinės į kairę, ši lentelė apibūdina kontrolės gradientą: kuo labiau judi link API, tuo daugiau visko sprendi pats, įskaitant tai, kas gali sulūžti.

Kas praktiškai lemia skirtumą

Rezultatų kokybė priklauso mažiau nuo modelio, o daugiau nuo to, kaip suformuluoji savo prašymą. „Pridėti validavimą“ palieka agentui sugalvoti vietą, stilių ir taisykles; „Pridėti el. pašto validavimą faile src/auth/validators.py naudojant esamą šabloną“ nurodo failą, konvenciją ir ribas. Tuo pačiu principu aiškiai nurodyk susijusius failus ir projekto apribojimus, užuot tikėjęsis, kad agentas juos atspės.

Patikrinimas lieka būtinas: kompetentingas agentas vis tiek gali įvesti regresiją, ypač vienu metu liečiant kelis failus. Įprask peržiūrėti skirtumus (diff) prieš priimant pakeitimus, lygiai taip pat, kaip darytum naujo darbuotojo „pull request“ atveju. Ir nepamiršk galutinio nustatymo: tinkamo įrankio pasirinkimo. Naudok „Vibe Code“ lokaliai kasdienei kūrybai, „Vibe Code Web“ ilgalaikėms užduotims nuotolinėje saugykloje, o API – savo vamzdynams.

Svarbiausi punktai

  • API suteikia visišką kontrolę: tu rašai įrankius ir agentinį ciklą
  • „Vibe Code“ įdiegiamas komanda curl -LsSf https://mistral.ai/vibe/install.sh | bash (arba uv tool install mistral-vibe) ir tiekiamas su „Mistral Medium 3.5“
  • CLI ir VS Code plėtinys dalijasi konfigūracija ir sesijomis; vibe --prompt skirtas automatizavimui
  • „Vibe Code Web“ paleidžia agentą nuotolinėje smėlio dėžėje ir sukuria šakas bei „pull request“ užklausas
  • Tikslios instrukcijos ir skirtumų (diff) peržiūra lieka būtinos