Salt la conținutul principal
Română— Alege o limbă
Meniu

Agenți de cod în practică: API, Vibe Code CLI și Vibe Code Web

Lecția 8 din 14 Actualizată 2 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Trei modalități de a pune un agent la treabă
  2. Prin intermediul API-ului Mistral
  3. Prin Vibe Code local: CLI și extensia VS Code
  4. Prin Vibe Code Web
  5. Compararea celor trei căi
  6. Ce face diferența în practică
  7. Puncte cheie

Lecție rescrisă la 2 noiembrie 2026. Deoarece Devstral a fost eliminat din API la 31 iulie 2026, exemplele de API de aici utilizează Mistral Small 4. Secțiunea Vibe reflectă documentația curentă Vibe Code: instalare, modelul încorporat (Mistral Medium 3.5) și cele trei interfețe—CLI, extensia VS Code și Vibe Code Web. Surse: Instalare și configurare · Alegerea sesiunilor CLI, VS Code sau web · Configurare.

Trei modalități de a pune un agent la treabă

Un model agentiv este la fel de bun cât este modul în care îl conectați la munca reală. Mistral oferă trei căi: API-ul, unde vă construiți propriul agent; Vibe Code local, în terminal sau VS Code; și Vibe Code Web, care rulează agentul într-un sandbox la distanță față de un depozit GitHub. Fiecare se potrivește unei părți diferite a zilei unui dezvoltator.

Prin intermediul API-ului Mistral

API-ul este cea mai flexibilă interfață: vă permite să construiți propriile fluxuri de lucru agentive cu propriile instrumente și logica de control. Începeți cu cazul cel mai simplu, o apelare de chat fără instrumente. Aici trimitem o funcție de autentificare vulnerabilă către Mistral Small 4 și cerem un diagnostic. Setarea temperature=0 nu este decorativă: pentru analiza securității, doriți rezultate reproductibile, nu variații de la o execuție la alta.

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)

Modul agentiv schimbă natura schimbului. În loc să primiți text, declarați instrumentele pe care modelul le poate solicita să apeleze, iar modelul returnează tool_calls—un nume de instrument și argumentele sale. Cele trei instrumente de mai jos formează fundația minimă pentru un agent de cod: citirea unui fișier, scrierea unui fișier, rularea unei comenzi. Cu acestea, instrucțiunea „adăugați indicații de tip tuturor fișierelor din src/utils/“ devine executabilă, în timp ce în modul chat ar rămâne o simplă sugestie.

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

Rețineți că nimic nu se execută de la sine: bucla—apelarea instrumentului, returnarea ieșirii către model, solicitarea pasului următor—rămâne în întregime responsabilitatea dumneavoastră. Acesta este prețul flexibilității și este exact ceea ce gestionează CLI-ul Vibe pentru dumneavoastră.

Prin Vibe Code local: CLI și extensia VS Code

Vibe Code este modul „code“ al Vibe, agentul Mistral. Local, acesta vine în două forme care partajează același motor, aceeași configurare și același istoric de sesiuni: CLI, în terminalul dumneavoastră, și extensia VS Code, care adaugă contextul editorului (fișier activ, selecție, diferențe). Instalarea CLI necesită o singură linie pe macOS și Linux:

# 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

Apoi navigați în proiectul dumneavoastră și rulați vibe. La prima lansare, un asistent vă solicită să vă autentificați cu contul Mistral (Vibe Code este inclus în planuri, cu limite de utilizare în funcție de plan) sau să introduceți o cheie API. Apoi discutați cu agentul ca și cum ar fi un coleg cu mâinile pe tastatură:

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 furnizează chiar el instrumentele (citire/scriere fișiere, comenzi shell) și bucla agentivă pe care a trebuit să o scrieți manual cu API-ul. Este livrat cu un model încorporat, Mistral Medium 3.5, iar comanda /model vă permite să alegeți altul dintre cele configurate (Small 4, Codestral, un model local…). Modificările și comenzile trec printr-un sistem de aprobare pe care îl configurați per agent: revizuiți-l înainte de a-i acorda încredere pentru un depozit important. Pentru automatizare, vibe --prompt rulează o execuție non-interactivă, utilă în integrarea continuă.

Prin Vibe Code Web

Vibe Code Web este a treia interfață: un cockpit pentru agenți la distanță. Creați un proiect din unul sau mai multe depozite GitHub aparținând aceluiași proprietar, porniți o sesiune cu o instrucțiune precisă, iar agentul lucrează într-un sandbox gestionat în cloud: clonează, planifică, modifică, rulează comenzi și teste, apoi pregătește o ramură sau un pull request pe care să îl revizuiți în GitHub. Nu este necesară nicio copie locală, iar mașina dumneavoastră poate rămâne închisă în timp ce agentul lucrează. Din CLI, comanda /teleport transferă o sesiune în curs de desfășurare către web.

Alegeți CLI-ul sau extensia atunci când sarcina depinde de fișiere, servicii sau secrete prezente doar pe mașina dumneavoastră.

Compararea celor trei căi

CriteriuAPI PythonVibe Code (CLI, VS Code)Vibe Code Web
Buclă agentivăO scrieți dumneavoastrăÎncorporatăÎncorporată
Acces la fișierePrin instrumentele dumneavoastrăCopie de lucru localăSandbox la distanță, depozit GitHub
ModelCel pe care îl apelațiMedium 3.5 încorporat, altele opționaleMotor Vibe Code
Mod non-interactivDaDa (vibe --prompt, doar CLI)Nu
Caz de utilizarePipeline-uri, produse personalizateDezvoltare zilnicăSarcini de lungă durată pe un depozit la distanță

Citind de la dreapta la stânga, acest tabel descrie un gradient de control: cu cât vă îndreptați mai mult către API, cu atât decideți dumneavoastră totul, inclusiv ceea ce se poate strica.

Ce face diferența în practică

Calitatea rezultatelor depinde mai puțin de model și mai mult de modul în care formulați cererea. „Adăugați validare“ lasă agentul să inventeze locația, stilul și regulile; „Adăugați validarea e-mailului în src/auth/validators.py folosind modelul existent“ îi oferă fișierul, convenția și limita. În același spirit, citați explicit fișierele relevante și constrângerile proiectului, în loc să sperați că le va ghici.

Verificarea rămâne non-negociabilă: un agent competent poate introduce totuși o regresie, mai ales atunci când atinge mai multe fișiere simultan. Faceți un obicei din a revizui diferențele (diff) înainte de a le accepta, exact cum ați face pentru un pull request al unui nou angajat. Și aveți în vedere setarea finală: alegerea instrumentului potrivit. Utilizați Vibe Code local pentru dezvoltarea zilnică, Vibe Code Web pentru sarcini de lungă durată pe un depozit la distanță și API-ul pentru propriile pipeline-uri.

Puncte cheie

  • API-ul oferă control total: scrieți instrumentele și bucla agentivă
  • Vibe Code se instalează cu curl -LsSf https://mistral.ai/vibe/install.sh | bash (sau uv tool install mistral-vibe) și este livrat cu Mistral Medium 3.5
  • CLI-ul și extensia VS Code partajează configurația și sesiunile; vibe --prompt este pentru automatizare
  • Vibe Code Web rulează agentul într-un sandbox la distanță și produce ramuri și pull request-uri
  • Instrucțiunile precise și revizuirea diferențelor rămân esențiale