Subagentai: deleguokite specializuotas užduotis
Šiame puslapyje
Pamoka atnaujinta 2026 m. lapkričio 2 d. Pavyzdiniai agentų failai dabar naudoja Vibe dokumentuotus raktus:
instructions(vietojsystem_prompt),active_model(vietojmodel),[tools.<tool>]blokus patvirtinimams (raktoauto_approveagentų faile nėra) ir tikrus įrankių pavadinimus (edit, o needit_file; įrankiolist_dirnėra). Priminimas iš 3 pamokos:safetyyra vizualinis indikatorius, o ne leidimas. Šaltinis: Konfigūracijos nuoroda.
Delegavimo principas
Sudėtinguose projektuose tam tikros užduotys yra nepriklausomos viena nuo kitos: pavyzdžiui, vienas procesas analizuoja failo saugumą, o kitu metu generuojami testai. Vietoj to, kad viską atliktumėte nuosekliai, Mistral Vibe leidžia deleguoti užduotis subagentams. Subagentas yra agentas, kuris veikia nepriklausomai, įvykdo savo misiją ir grąžina tekstinį rezultatą pagrindiniam agentui. Jis negali klausti naudotojo: jis privalo būti visiškai autonominis.
Šis apribojimas yra viso to, kas seka, raktas, ir jis nusipelno išsamaus paaiškinimo. Subagentas veikia savo kontekste, neturėdamas prieigos prie dabartinio pokalbio – jis nieko nežino apie tai, ką pagrindiniam agentui paaiškinai prieš penkias minutes. Jis negali naudoti ask_user_question ir privalo savarankiškai spręsti bet kokius neaiškumus. Jis grąžina tekstą, kurį pagrindinis agentas tada integruoja į savo atsakymą. Kadangi jis yra atkirstas nuo exchanges, jis turi prasmę tik tada, kai sukurtas konkrečiai, aiškiai apibrėžtai užduočiai.
Subagento konfigūravimas
Norint paversti agentą subagentu, į .toml failą reikia pridėti lauką agent_type = "subagent". Likusi konfigūracija laikosi įprastų tinkintų agentų taisyklių.
# ~/.vibe/agents/test-generator.toml
display_name = "Testų generatorius"
description = "Generuoja vienetinius testus nurodytoms funkcijoms."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral" # aliasas, deklaruotas config.toml (2 pamoka)
instructions = """
Gaunate源代码 kodą. Sugeneruokite išsamius vienetinius testus:
- Nominalių atvejų testai
- Ribinių atvejų testai (null, undefined, tuščios eilutės)
- Tikėtinų klaidų testai
Karkasas: Naudokite projekto testų karkasą (Jest, Vitest, Pytest...).
Grąžinkite tik testų kodą, paruoštą kopijuoti.
"""
enabled_tools = [
"read_file",
"grep",
]
Atkreipkite dėmesį, kad įrankių sąraše nėra ask_user_question: tai nėra klaida. Subagentas negali prašyti patikslinimų, o sistemos promptas kompensuoja šią negalimybę iš anksto nurodydamas, kurį testų karkasą naudoti ir kokio tikslaus atsakymo formato tikėtis.
Konkretūs naudojimo atvejai
Pirmasis privalumas – lygiagretus darbas. Pagrindinis agentas gali vienu metu priskirti kelias užduotis skirtingiems subagentams, kurių kiekvienas dirba savarankiškai, kol grąžina savo rezultatą.
Pagrindinis agentas
├── Subagentas "test-generator" → generuoja testus
├── Subagentas "doc-writer" → generuoja dokumentaciją
└── Subagentas "security-checker" → analizuoja pažeidžiamumus
Antrasis privalumas susijęs su labai specializuotomis užduotimis. Kai kurioms jų reikia sistemos prompto, kuris radikaliai skiriasi nuo pagrindinio agento; vietoj to, kad perkrautumėte vieną agentą prieštaraujančiomis instrukcijomis, geriau deleguoti. Toliau pateiktas SQL optimizatorius yra geras pavyzdys: jo prompte kalbama tik apie indeksus, vykdymo planus ir N+1 užklausas, kas bendro pobūdžio agentui neturėtų jokios prasmės.
# ~/.vibe/agents/sql-optimizer.toml
display_name = "SQL optimizatorius"
description = "Analizuoja ir optimizuoja SQL užklausas."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5" # Vibe integruotas modelis
instructions = """
Analizuokite pateiktas SQL užklausas:
1. Nustatykite našumo problemas (N+1, pilnas nuskaitymas, trūkstamas indeksas)
2. Pasiūlykite optimizuotas užklausas
3. Pasiūlykite sukurtinus indeksus
Grąžinkite struktūruotą ataskaitą su „prieš“ ir „po“ kiekvienai užklausai.
"""
enabled_tools = ["read_file", "grep"]
Trečiasis, mažiau akivaizdus privalumas – saugumo izoliacija. Subagentas su safety = "safe" negali modifikuoti failų, net jei pagrindinis agentas veikia destructive režimu: leidimai nėra paveldimi žemyn. Taigi galite dirbti leidžiamuoju režimu, patikėdami analizes ribotiems subagentams, kurie neturi jokios galimybės veikti saugykloje.
# Subagentas, kuris gali TIK skaityti
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Vibe taip pat turi integruotą explore subagentą, kurį jis naudoja automatiškai, kai jam reikia peržiūrėti jūsų kodų bazę norint atsakyti į klausimą. Jis veikia tik skaitymo režimu ir grąžina to, ką rado, santrauką – būtent tokį modelį atkartojate kurdami savo subagentus.
Gero subagento kūrimas
Viskas sukasi apie sistemos prompto autonomiją: jame turi būti visos instrukcijos, būtinos subagentui pasiekti tikslą niekada neklausiant klausimų. Tai reikalauja numatyti atvejus, kai kas nors nepavyksta, ir tiksliai užrašyti, ką agentas tokiose situacijose privalo daryti, kaip parodyta šiame pavyzdyje.
instructions = """
Analizuokite VISUS projekto TypeScript failus.
Jei failas nerastas, pereikite prie kito.
Jei testų karkaso nepavyksta identifikuoti, pagal nutylėjimą naudokite Vitest.
Visada grąžinkite rezultatą, net jei jis dalinis.
"""
Du refleksai užbaigia šį darbą. Suteikite subagentui tiksliai tuos įrankius, kurių jam reikia – analizės subagentui nereikia write_file – ir sistemos prompte nurodykite tikėtiną išvesties formatą. Pagrindinis agentas privalo galėti panaudoti rezultatą be dviprasmybių: būtent jis, o ne tu, pirmasis perskaitys šį tekstą.
Vibe nustatytos taisyklės
Vibe dokumentacija nurodo keletą taisyklių, kurias verta žinoti prieš kuriant subagentus:
- subagentas pagrindiniam agentui grąžina tik tekstą ir negali klausti naudotojo klausimų;
- jis gali naudoti tik integruotus įrankius, kuriuos leidžia jo failas, niekada – MCP įrankių, jungčių ar papildinių, ir niekada su didesniais leidimais nei tėvinis agentas: jo
[tools.<tool>]blokai gali jį tik papildomai apriboti, bet ne išplėsti; - jo
descriptionyra privalomas: tai nurodo agentui, kada jį naudoti; failas be aprašymo yra pažymimas vėliavėle, o ne įkeliamas; - jis veikia savo
active_modelarba, jei jis nenustatytas, sesijos modeliu; - pagrindinis agentas jį paleidžia per delegavimą, naudodamas
taskįrankį; jis nėra pasirenkamas su--agent; - pagal nutylėjimą vienu metu gali egzistuoti ir veikti iki 32 subagentų (
max_subagents,max_concurrent_subagents), oenable_subagents = falsefaileconfig.tomlvisiškai uždraudžia bet kokį delegavimą.
Neturint tinkinto subagento, agentas vis tiek gali paleisti bendrąjį subagentą, aprūpintą savo instrukcijomis ir įrankiais.
Svarbiausi punktai
- Subagentas yra nepriklausomas agentas, kuris negali sąveikauti su naudotoju
- Konfigūruokite jį naudodami
agent_type = "subagent".tomlfaile - Subagentai idealiai tinka lygiagrečiam darbui ir specializuotoms užduotims
- Jie suteikia natūralią saugumo izoliaciją
instructionsprivalo būti visiškai autonominės: jokių klausimų neleidžiama- Visada nurodykite aiškų išvesties formatą prompte