Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Aġenti tal-Kodiċi fil-Prattika: API, Vibe Code CLI, u Vibe Code Web

Lezzjoni 8 / 14 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Tliet modi biex tħaddem aġent
  2. Permezz tal-Mistral API
  3. Permezz ta’ Vibe Code lokalment: il-CLI u l-estensjoni ta’ VS Code
  4. Permezz ta’ Vibe Code Web
  5. Tqabbil tat-tliet mogħdijiet
  6. X’jagħmel id-differenza fil-prattika
  7. Punti Ewlenin

Lezzjoni miktuba mill-ġdid fit-2 ta’ Novembru 2026. Peress li Devstral tneħħa mill-API fil-31 ta’ Lulju 2026, l-eżempji tal-API hawnhekk jużaw Mistral Small 4. It-taqsima Vibe tirrifletti d-dokumentazzjoni attwali ta’ Vibe Code: l-installazzjoni, il-mudell integrat (Mistral Medium 3.5), u t-tliet wiċċiet—CLI, l-estensjoni ta’ VS Code, u Vibe Code Web. Sorsi: Install and setup · Choose CLI, VS Code, or web sessions · Configuration.

Tliet modi biex tħaddem aġent

Mudell aġentiku huwa tajjeb daqs kemm tkun kapaċi tgħaqqdu max-xogħol reali. Mistral joffri tliet mogħdijiet: l-API, fejn tibni l-aġent tiegħek stess; Vibe Code lokalment, fit-terminal jew f’VS Code tiegħek; u Vibe Code Web, li jħaddem l-aġent f’sandbox remot kontra repository ta’ GitHub. Kull wieħed jaqbel għal parti differenti mill-ġurnata ta’ żviluppatur.

Permezz tal-Mistral API

L-API hija l-aktar interfaċċa flessibbli: tippermettilek tibni flussi ta’ ħidma aġentiċi tiegħek stess bl-għodod u l-loġika ta’ kontroll tiegħek. Ibda bl-aktar każ sempliċi, sejħa ta’ chat mingħajr għodod. Hawnhekk nibagħtu funzjoni ta’ awtentikazzjoni vulnerabbli lil Mistral Small 4 u nitolbu dijanjożi. Li tissettja temperature=0 mhuwiex dekorattiv: għall-analiżi tas-sigurtà, trid riżultati riproduċibbli, mhux varjazzjoni minn ġirja għall-oħra.

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)

Il-modalità aġentika tbiddel in-natura tal-iskambju. Minflok tirċievi test, tiddikjara għodod li l-mudell jista’ jitlob biex isejjaħ, u l-mudell jirritorna tool_calls—isem għodda u l-argumenti tagħha. It-tliet għodod hawn taħt jiffurmaw il-fondazzjoni minima għal aġent tal-kodiċi: aqra fajl, ikteb fajl, ħaddem kmand. Bihom, l-istruzzjoni “żid hints tat-tip għall-fajls kollha f’src/utils/” issir eżegwibbli, filwaqt li fil-modalità chat tibqa’ sempliċiment suġġeriment.

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

Innota li xejn ma jiġi eżegwit waħdu: iċ-ċiklu—sejjaħ l-għodda, erġa’ lura l-output lill-mudell, itlob għall-pass li jmiss—jibqa’ kompletament ir-responsabbiltà tiegħek. Dak huwa l-prezz tal-flessibbiltà, u huwa eżattament dak li l-Vibe CLI jimmaniġġja għalik.

Permezz ta’ Vibe Code lokalment: il-CLI u l-estensjoni ta’ VS Code

Vibe Code huwa l-modalità “code” ta’ Vibe, l-aġent ta’ Mistral. Lokalment, jiġi f’żewġ forom li jaqsmu l-istess magna, konfigurazzjoni u storja tas-sessjoni: il-CLI, fit-terminal tiegħek, u l-estensjoni ta’ VS Code, li żżid il-kuntest tal-editur (fajl attiv, selezzjoni, differenzi). L-installazzjoni tal-CLI tieħu linja waħda fuq macOS u 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

Imbagħad immur fil-proġett tiegħek u ħaddem vibe. Fl-ewwel tnedija, wizard jitloblek tidħol bil-kont Mistral tiegħek (Vibe Code huwa inkluż fil-pjanijiet, b’limiti ta’ użu li jiddependu mill-pjan) jew daħħal ċavetta API. Imbagħad titkellem mal-aġent bħallikieku huwa kollega b’idejh fuq it-tastiera:

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 jipprovdi l-għodod innifsu (qari/kitba ta’ fajls, kmands tal-qoxra) u ċ-ċiklu aġentiku li kellek tikteb bl-idejn bl-API. Jiġi b’mudell integrat, Mistral Medium 3.5, u l-kmand /model jippermettilek tagħżel ieħor minn dawk ikkonfigurati (Small 4, Codestral, mudell lokali…). Il-bidliet u l-kmandi jgħaddu minn sistema ta’ approvazzjoni li tikkonfigura għal kull aġent: irrevediha qabel ma tifda repository importanti miegħu. Għall-awtomazzjoni, vibe --prompt iħaddem eżekuzzjoni mhux interattiva, utli fl-integrazzjoni kontinwa.

Permezz ta’ Vibe Code Web

Vibe Code Web huwa t-tielet wiċċ: cockpit għal aġenti remoti. Toħloq proġett minn repository wieħed jew aktar ta’ GitHub taħt l-istess sid, tibda sessjoni b’istruzzjoni preċiża, u l-aġent jaħdem f’sandbox immaniġġjat mis-sħab: jikklonja, jippjana, jimmodifika, iħaddem kmands u testijiet, imbagħad iħejji fergħa jew pull request biex tirrevedi f’GitHub. M’hemmx bżonn ta’ kopja lokali, u l-magna tiegħek tista’ tibqa’ magħluqa waqt li l-aġent jaħdem. Mill-CLI, il-kmand /teleport jittrasferixxi sessjoni għaddejja għall-web.

Agħżel il-CLI jew l-estensjoni meta l-kompitu jiddependi fuq fajls, servizzi, jew sigrieti preżenti biss fuq il-magna tiegħek.

Tqabbil tat-tliet mogħdijiet

KriterjuPython APIVibe Code (CLI, VS Code)Vibe Code Web
Ċiklu aġentikuTiktebu intIntegratIntegrat
Aċċess għall-fajlsPermezz tal-għodod tiegħekKopja tax-xogħol lokaliSandbox remot, repo ta’ GitHub
MudellDak li ssejjaħMedium 3.5 integrat, oħrajn opzjonaliMagna ta’ Vibe Code
Modalità mhux interattivaIvaIva (vibe --prompt, CLI biss)Le
Każ ta’ użuPipelines, prodotti customŻvilupp ta’ kuljumKompiti fit-tul fuq repo remot

Jekk taqra minn lemin għal xellug, din it-tabella tiddeskrivi gradjent ta’ kontroll: aktar ma timxi lejn l-API, aktar tiddeċiedi kollox int, inkluż x’jista’ jinkiser.

X’jagħmel id-differenza fil-prattika

Il-kwalità tar-riżultat tiddependi inqas fuq il-mudell milli fuq kif tifformula t-talba tiegħek. “Żid validazzjoni” iħalli lill-aġent jinventa l-post, l-istil u r-regoli; “Żid validazzjoni tal-email f’src/auth/validators.py billi tuża l-mudell eżistenti” jagħtih il-fajl, il-konvenzjoni u l-limitu. Bl-istess spirit, iċċita espliċitament fajls rilevanti u restrizzjonijiet tal-proġett minflok ma tittama li jindovina huma.

Il-verifika tibqa’ mhux negozjabbli: aġent kompetenti jista’ xorta jintroduċi regressjoni, speċjalment meta jmiss bosta fajls f’daqqa. Agħmilha drawwa li tirrevedi d-differenza (diff) qabel ma taċċettaha, eżattament kif tagħmel għal pull request ta’ impjegat ġdid. U żomm f’moħħok l-aħħar setting: li tagħżel l-għodda t-tajba. Uża Vibe Code lokalment għall-iżvilupp ta’ kuljum, Vibe Code Web għal kompiti fit-tul fuq repo remot, u l-API għall-pipelines tiegħek stess.

Punti Ewlenin

  • L-API tagħti kontroll totali: int tikteb l-għodod u ċ-ċiklu aġentiku
  • Vibe Code jinstalla b’curl -LsSf https://mistral.ai/vibe/install.sh | bash (jew uv tool install mistral-vibe) u jiġi ma’ Mistral Medium 3.5
  • Il-CLI u l-estensjoni ta’ VS Code jaqsmu l-konfigurazzjoni u s-sessjonijiet; vibe --prompt huwa għall-awtomazzjoni
  • Vibe Code Web iħaddem l-aġent f’sandbox remot u jipproduċi fergħat u pull requests
  • Istruzzjonijiet preċiżi u r-reviżjoni tad-differenzi jibqgħu essenzjali