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

Sotaġenti: Iddelega Kompiti Speċjalizzati

Lezzjoni 5 / 14 Aġġornat 2 ta’ Novembru 2026 Avvanzat
F'din il-paġna
  1. Il-Prinċipju tad-Delega
  2. Konfigurazzjoni ta’ Sotaġent
  3. Każijiet ta’ Użu Konkreti
  4. Iddisinnjar ta’ Sotaġent Tajjeb
  5. Regoli Stabbiliti minn Vibe
  6. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru, 2026. Il-fajls tal-aġenti eżempju issa jużaw ċwievet iddokumentati minn Vibe: instructions (mhux system_prompt), active_model (mhux model), blokki [tools.<tool>] għall-approvazzjonijiet (iċ-ċavetta auto_approve ma teżistix f’fajl ta’ aġent), u ismijiet reali tal-għodod (edit, mhux edit_file; l-ebda għodda list_dir). Tifkira mil-Lezzjoni 3: safety hija indikatur viżiv, mhux permess. Sors: Configuration reference.

Il-Prinċipju tad-Delega

F’proġetti kumplessi, ċerti kompiti huma indipendenti minn xulxin: lanaliżi tas-sigurtà ta’ fajl waqt li proċess ieħor jiġġenera t-testijiet. Minflok ma tittratta kollox b’mod sekwenzjali, Mistral Vibe jħallik tiddelega kompiti lis-sotaġenti. Sotaġent huwa aġent li jaħdem b’mod indipendenti, jikkompleta l-missjoni tiegħu, u jirritorna riżultat testwali lill-aġent prinċipali. Ma jistax jagħmel mistoqsijiet lill-utent: irid ikun kompletament awtonomu.

Dan il-vincolu huwa ċ-ċavetta għal kollox li jmiss, u jixraq dettall. Sotaġent jaħdem fil-kuntest tiegħu stess, mingħajr aċċess għall-konversazzjoni kurrenti—ma jaf xejn dwar dak li spjegajt lill-aġent prinċipali ħames minuti ilu. Ma jistax juża ask_user_question u trid jimmaniġġja l-ambigwità waħdu. Jirritorna test li l-aġent prinċipali mbagħad jintegra fir-risposta tiegħu. Peress li huwa maqtugħ mill-iskambju, jagħmel sens biss meta jiġi ddisinjat għal kompitu speċifiku u ddefinit sew.

Konfigurazzjoni ta’ Sotaġent

Biex tbiddel aġent f’sotaġent, żid il-qasam agent_type = "subagent" fil-fajl .toml. Il-bqija tal-konfigurazzjoni ssegwi r-regoli tas-soltu għall-aġenti personalizzati.

# ~/.vibe/agents/test-generator.toml
display_name = "Test Generator"
description = "Generates unit tests for given functions."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral"  # alias declared in config.toml (Lesson 2)

instructions = """
You receive source code. Generate comprehensive unit tests:
- Nominal case tests
- Edge case tests (null, undefined, empty strings)
- Expected error tests
Framework: Use the project's test framework (Jest, Vitest, Pytest...).
Return only the test code, ready to copy.
"""

enabled_tools = [
  "read_file",
  "grep",
]

Innota n-nuqqas ta’ ask_user_question fl-għodod: dan mhux żball. Sotaġent ma jistax jitlob kjarifiki, u s-sistema prompt tikkumpensa għal din l-impossibbiltà billi tispeċifika minn qabel il-qafas tat-test li għandu jintuża u l-format eżatt tar-risposta.

Każijiet ta’ Użu Konkreti

L-ewwel benefiċċju huwa x-xogħol parallel. L-aġent prinċipali jista’ jassenja diversi kompiti simultanjament lil sotaġenti differenti, li kull wieħed jaħdem fuq tiegħu qabel ma jirritorna r-riżultat tiegħu.

Main Agent
├── Subagent "test-generator" → generates tests
├── Subagent "doc-writer" → generates documentation
└── Subagent "security-checker" → analyzes vulnerabilities

It-tieni benefiċċju jikkonċerna kompiti altamente speċjalizzati. Uħud jeħtieġu sistema prompt radikalment differenti minn dik tal-aġent prinċipali; minflok ma tgħabbi aġent wieħed b’istruzzjonijiet kontradittorji, tiddelega. L-ottimizzatur SQL hawn taħt huwa eżempju tajjeb: il-prompt tiegħu jiddiskuti biss dwar indiċi, pjanijiet ta’ eżekuzzjoni, u mistoqsijiet N+1, li ma jkollhom l-ebda sens f’aġent ġeneralista.

# ~/.vibe/agents/sql-optimizer.toml
display_name = "SQL Optimizer"
description = "Analyzes and optimizes SQL queries."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5"  # model built into Vibe

instructions = """
Analyze the provided SQL queries:
1. Identify performance issues (N+1, full scan, missing index)
2. Propose optimized queries
3. Suggest indexes to create
Return a structured report with before/after for each query.
"""

enabled_tools = ["read_file", "grep"]

It-tielet benefiċċju, inqas ovvju, huwa l-iżolament tas-sigurtà. Sotaġent b’safety = "safe" ma jistax jimmodifika fajls, anke jekk l-aġent prinċipali jaħdem f’modalità destructive: il-permessi ma jintirtux ‘l isfel. Għalhekk tista’ taħdem f’modalità permissiva waqt li tafdalanaliżi lil sotaġenti ristretti li m’għandhom l-ebda mod kif jaġixxu fuq ir-repożitorju.

# Subagent that can ONLY read
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Vibe jipprovdi wkoll sotaġent explore integrat, li juża awtomatikament meta jkollu bżonn jgħaddi mill-kodiċi tiegħek biex iwieġeb mistoqsija. Jaħdem f’modalità ta’ qari biss (read-only) u jirritorna sommarju ta’ dak li sab—eżattament il-mudell li tirreplika bis-sotaġenti tiegħek stess.

Iddisinnjar ta’ Sotaġent Tajjeb

Kollox jiddependi mill-awtonomija tas-sistema prompt: trid fiha l-istruzzjonijiet kollha meħtieġa biex is-sotaġent jasal sal-aħħar mingħajr qatt ma jagħmel mistoqsija. Dan jeħtieġ li tbassar il-każijiet fejn affarijiet imorru ħażin u tiktbu eżattament x’għandu jagħmel l-aġent f’dawk is-sitwazzjonijiet, bħall-eżempju li ġej.

instructions = """
Analyze ALL TypeScript files in the project.
If a file is not found, move to the next one.
If the test framework is not identifiable, use Vitest by default.
Always return a result, even if partial.
"""

Żewġ riflessi jikkompletaw dan ix-xogħol. Agħti lis-sotaġent strettament l-għodod li jeħtieġ—aġent tal-analiżi m’għandux bżonn write_file—u speċifika l-format tal-output mistenni fis-sistema prompt. L-aġent prinċipali għandu jkun kapaċi jisfrutta r-riżultat mingħajr ambigwità: huwa, mhux int, se jaqra dan it-test l-ewwel.

Regoli Stabbiliti minn Vibe

Id-dokumentazzjoni ta’ Vibe tispeċifika diversi regoli li jixraq tkun taf qabel ma tfassal is-sotaġenti tiegħek:

  • sotaġent jirritorna biss test lill-aġent prinċipali u ma jistax jagħmel mistoqsijiet lill-utent;
  • jista’ juża biss l-għodod integrati li l-fajl tiegħu jawtorizza, qatt mhux għodod MCP, konnetturi, jew plugins, u qatt b’permessi usa’ mill-aġent ġenitur: il-blokki [tools.<tool>] tiegħu jistgħu jirrestrinġuh aktar, mhux jespanduh;
  • id-description tiegħu hija obbligatorja: dan jindika lill-aġent meta għandu jużah; fajl mingħajr deskrizzjoni jiġi mmarkat minflok ma jiġi mgħobbi;
  • jaħdem fuq l-active_model tiegħu, jew fuq il-mudell tas-sessjoni jekk l-ebda wieħed ma huwa stabbilit;
  • l-aġent prinċipali jniedih permezz tad-delega, bl-użu tal-għodda task; ma jintgħażilx b’--agent;
  • b’mod default, sa 32 sotaġent jistgħu jeżistu u jaħdmu simultanjament (max_subagents, max_concurrent_subagents), u enable_subagents = false f’config.toml jipprojbixxi d-delega kollha.

Mingħajr sotaġent personalizzat, l-aġent xorta jista’ jniedi sotaġent ġeneriku mgħammar bl-istruzzjonijiet u l-għodod tiegħu stess.

Punti Ewlenin

  • Sotaġent huwa aġent indipendenti li ma jistax jinteraġixxi mal-utent
  • Ikkonfigurah b’agent_type = "subagent" fil-fajl .toml
  • Is-sotaġenti huma ideali għax-xogħol parallel u kompiti speċjalizzati
  • Joffru iżolament naturali tas-sigurtà
  • L-instructions iridu jkunu kompletament awtonomi: l-ebda mistoqsija mhija permessa
  • Dejjem speċifika format ċar tal-output fil-prompt