Sotaġenti: Iddelega Kompiti Speċjalizzati
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru, 2026. Il-fajls tal-aġenti eżempju issa jużaw ċwievet iddokumentati minn Vibe:
instructions(mhuxsystem_prompt),active_model(mhuxmodel), blokki[tools.<tool>]għall-approvazzjonijiet (iċ-ċavettaauto_approvema teżistix f’fajl ta’ aġent), u ismijiet reali tal-għodod (edit, mhuxedit_file; l-ebda għoddalist_dir). Tifkira mil-Lezzjoni 3:safetyhija 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-
descriptiontiegħ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_modeltiegħ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), uenable_subagents = falsef’config.tomljipprojbixxi 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-
instructionsiridu jkunu kompletament awtonomi: l-ebda mistoqsija mhija permessa - Dejjem speċifika format ċar tal-output fil-prompt