Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Subagentai: deleguokite specializuotas užduotis

Paskaita 5 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Pažengusiems
Šiame puslapyje
  1. Delegavimo principas
  2. Subagento konfigūravimas
  3. Konkretūs naudojimo atvejai
  4. Gero subagento kūrimas
  5. Vibe nustatytos taisyklės
  6. Svarbiausi punktai

Pamoka atnaujinta 2026 m. lapkričio 2 d. Pavyzdiniai agentų failai dabar naudoja Vibe dokumentuotus raktus: instructions (vietoj system_prompt), active_model (vietoj model), [tools.<tool>] blokus patvirtinimams (rakto auto_approve agentų faile nėra) ir tikrus įrankių pavadinimus (edit, o ne edit_file; įrankio list_dir nėra). Priminimas iš 3 pamokos: safety yra 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 description yra privalomas: tai nurodo agentui, kada jį naudoti; failas be aprašymo yra pažymimas vėliavėle, o ne įkeliamas;
  • jis veikia savo active_model arba, 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), o enable_subagents = false faile config.toml visiš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" .toml faile
  • Subagentai idealiai tinka lygiagrečiam darbui ir specializuotoms užduotims
  • Jie suteikia natūralią saugumo izoliaciją
  • instructions privalo būti visiškai autonominės: jokių klausimų neleidžiama
  • Visada nurodykite aiškų išvesties formatą prompte