Subagenti: deleģē specializētus uzdevumus
Šajā lapā
Nodarbība atjaunināta 2026. gada 2. novembrī. Piemēra aģentu faili tagad izmanto Vibe dokumentētos atslēgvārdus:
instructions(nevissystem_prompt),active_model(nevismodel),[tools.<tool>]blokus apstiprinājumiem (atslēgaauto_approveaģenta failā neeksistē) un īstus rīku nosaukumus (edit, nevisedit_file; rīkslist_dirnepastāv). Atgādinājums no 3. nodarbības:safetyir vizuāls indikators, nevis atļauja. Avots: Konfigurācijas atsauce.
Deleģēšanas princips
Sarežģītos projektos daži uzdevumi ir neatkarīgi cits no cita: piemēram, faila drošības analīze notiek paralēli testa ģenerēšanas procesam. Tā vietā, lai visu veiktu secīgi, Mistral Vibe ļauj deleģēt uzdevumus subagentiem. Subagents ir aģents, kas darbojas neatkarīgi, pabeidz savu misiju un atgriež teksta rezultātu galvenajam aģentam. Tas nevar uzdot jautājumus lietotājam: tam jābūt pilnībā autonomam.
Šis ierobežojums ir visu turpmāko darbību atslēga, un tas ir pelnījis detalizētu skaidrojumu. Subagents darbojas savā kontekstā, tam nav piekļuves pašreizējai sarunai — tas nezina neko no tā, ko tu galvenajam aģentam paskaidroji pirms piecām minūtēm. Tas nevar izmantot ask_user_question un patstāvīgi jātiek galā ar neskaidrībām. Tas atgriež tekstu, ko galvenais aģents pēc tam integrē savā atbildē. Tā kā tas ir atgriezts no sarunas, tam ir jēga tikai tad, ja tas ir izstrādāts konkrētam, precīzi definētam uzdevumam.
Subagenta konfigurēšana
Lai pārvērstu aģentu par subagentu, pievieno lauku agent_type = "subagent" failā .toml. Pārējā konfigurācija seko parastajiem pielāgotu aģentu noteikumiem.
# ~/.vibe/agents/test-generator.toml
display_name = "Testu ģenerators"
description = "Ģenerē vienības testus dotajām funkcijām."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral" # alias, kas deklarēts config.toml (2. nodarbība)
instructions = """
Tu saņem pirmkodu. Ģenerē visaptverošus vienības testus:
- Nominālo gadījumu testi
- Robežgadījumu testi (null, undefined, tukšas virknes)
- Paredzamo kļūdu testi
Ietvars: Izmanto projekta testēšanas ietvaru (Jest, Vitest, Pytest...).
Atgriez tikai testa kodu, gatavu kopēšanai.
"""
enabled_tools = [
"read_file",
"grep",
]
Ņem vērā ask_user_question trūkumu rīku sarakstā: tā nav kļūda. Subagents nevar lūgt precizējumus, un sistēmas prompts kompensē šo neiespējamību, iepriekš norādot izmantojamo testēšanas ietvaru un precīzu atbildes formātu.
Konkrēti lietojuma gadījumi
Pirmā priekšrocība ir paralēls darbs. Galvenais aģents var vienlaikus deleģēt vairākus uzdevumus dažādiem subagentiem, no kuriem katrs strādā savrupi, pirms atgriež savu rezultātu.
Galvenais aģents
├── Subagents "test-generator" → ģenerē testus
├── Subagents "doc-writer" → ģenerē dokumentāciju
└── Subagents "security-checker" → analizē ievainojamības
Otrā priekšrocība attiecas uz augsti specializētiem uzdevumiem. Daži no tiem prasa sistēmas promptu, kas radikāli atšķiras no galvenā aģenta prompta; tā vietā, lai pārslogotu vienu aģentu ar pretrunīgiem norādījumiem, tu deleģē uzdevumu. Zemāk redzamais SQL optimizētājs ir labs piemērs: tā prompts runā tikai par indeksiem, izpildes plāniem un N+1 vaicājumiem, kam vispārīgā aģentā nebūtu jēgas.
# ~/.vibe/agents/sql-optimizer.toml
display_name = "SQL optimizētājs"
description = "Analizē un optimizē SQL vaicājumus."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5" # Vibe iebūvēts modelis
instructions = """
Analizē sniegtos SQL vaicājumus:
1. Identificē veiktspējas problēmas (N+1, pilna skenēšana, trūkstošs indekss)
2. Piedāvā optimizētus vaicājumus
3. Ieteic izveidojamos indeksus
Atgriez strukturētu ziņojumu ar „pirms/pēc" salīdzinājumu katram vaicājumam.
"""
enabled_tools = ["read_file", "grep"]
Trešā priekšrocība, kas ir mazāk acīmredzama, ir drošības izolācija. Subagents ar safety = "safe" nevar modificēt failus, pat ja galvenais aģents darbojas destructive režīmā: atļaujas netiek mantotas uz leju. Tādējādi tu vari strādāt permisivā režīmā, uzticot analīzes ierobežotiem subagentiem, kuriem nav iespējas ietekmēt repozitoriju.
# Subagents, kas var TIKAI lasīt
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Vibe nodrošina arī iebūvētu explore subagentu, ko tas automātiski izmanto, kad tam jāšķērso tavs koda bāze, lai atbildētu uz jautājumu. Tas darbojas tikai lasīšanas režīmā un atgriež kopsavilkumu par atrasto — tieši tādu pašu modeli, ko tu atkārto ar saviem subagentiem.
Laba subagenta izstrāde
Viss balstās uz sistēmas prompta autonomiju: tajā jābūt visiem norādījumiem, kas subagentam nepieciešami, lai sasniegtu mērķi, nekad neuzdodot jautājumus. Tas prasa paredzēt gadījumus, kad kaut kas noiet greizi, un precīzi pierakstīt, ko aģentam šādās situācijās darīt, kā redzams šajā piemērā.
instructions = """
Analizē VISUS projekta TypeScript failus.
Ja fails nav atrasts, pārej pie nākamā.
Ja testēšanas ietvaru nevar identificēt, pēc noklusējuma izmanto Vitest.
Vienmēr atgriez rezultātu, pat ja tas ir daļējs.
"""
Šo darbu papildina divi refleksi. Piešķir subagentam stingri tikai tos rīkus, kas tam nepieciešami — analīzes subagentam nav vajadzīgs write_file — un sistēmas promptā norādi paredzamo izvades formātu. Galvenajam aģentam jāspēj izmantot rezultātu bez neskaidrībām: tieši tas, nevis tu, pirmo reizi lasīs šo tekstu.
Vibe noteiktie noteikumi
Vibe dokumentācija precizē vairākus noteikumus, kas jāzina pirms subagentu izstrādes:
- subagents galvenajam aģentam atgriež tikai tekstu un nevar uzdot jautājumus lietotājam;
- tas var izmantot tikai iebūvētos rīkus, ko atļauj tā fails, nekad MCP rīkus, konektorus vai spraudņus, un nekad ar plašākām atļaujām nekā vecākaģentam: tā
[tools.<tool>]bloki to var tikai papildus ierobežot, nevis paplašināt; - tā
descriptionir obligāts: tas norāda aģentam, kad to izmantot; fails bez apraksta tiek atzīmēts kā problemātisks, nevis ielādēts; - tas darbojas ar savu
active_modelvai, ja tas nav iestatīts, ar sesijas modeli; - galvenais aģents to palaiž, deleģējot uzdevumu, izmantojot rīku
task; to neizvēlas ar--agent; - pēc noklusējuma var eksistēt un vienlaikus darboties līdz 32 subagentiem (
max_subagents,max_concurrent_subagents), unenable_subagents = falsefailāconfig.tomlaizliedz jebkādu deleģēšanu.
Pat bez pielāgota subagenta aģents joprojām var palaist vispārēju subagentu, kas aprīkots ar saviem norādījumiem un rīkiem.
Galvenās atziņas
- Subagents ir neatkarīgs aģents, kas nevar mijiedarboties ar lietotāju
- Konfigurē to ar
agent_type = "subagent"failā.toml - Subagenti ir ideāli piemēroti paralēlam darbam un specializētiem uzdevumiem
- Tie nodrošina dabisku drošības izolāciju
instructionsjābūt pilnībā autonomiem: jautājumi nav atļauti- Vienmēr norādi skaidru izvades formātu promptā