Aġenti tal-Kodiċi fil-Prattika: API, Vibe Code CLI, u Vibe Code Web
F'din il-paġna
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
| Kriterju | Python API | Vibe Code (CLI, VS Code) | Vibe Code Web |
|---|---|---|---|
| Ċiklu aġentiku | Tiktebu int | Integrat | Integrat |
| Aċċess għall-fajls | Permezz tal-għodod tiegħek | Kopja tax-xogħol lokali | Sandbox remot, repo ta’ GitHub |
| Mudell | Dak li ssejjaħ | Medium 3.5 integrat, oħrajn opzjonali | Magna ta’ Vibe Code |
| Modalità mhux interattiva | Iva | Iva (vibe --prompt, CLI biss) | Le |
| Każ ta’ użu | Pipelines, prodotti custom | Żvilupp ta’ kuljum | Kompiti 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(jewuv 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 --prompthuwa 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