Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Allagendid: spetsialiseeritud ülesannete delegeerimine

Õppetund 5 / 14 Värskendatud 2. november 2026 Edasijõudnutele
Sellel lehel
  1. Delegeerimise printsiip
  2. Allagendi konfigureerimine
  3. Konkreetsed kasutusjuhud
  4. Hea allagendi kujundamine
  5. Vibe’i kehtestatud reeglid
  6. Peamised punktid

Tund uuendatud 2. novembril 2026. Näidisagentide failid kasutavad nüüd Vibe’i dokumenteeritud võtmeid: instructions (mitte system_prompt), active_model (mitte model), heakskiitude jaoks [tools.<tool>] plokke (võti auto_approve agentide failis ei eksisteeri) ja tegelikke tööriistade nimesid (edit, mitte edit_file; tööriista list_dir pole). Meeldetuletus 3. tunnist: safety on visuaalne indikaator, mitte luba. Allikas: Konfiguratsiooni viide.

Delegeerimise printsiip

Keerukates projektides on teatud ülesanded üksteisest sõltumatud: näiteks analüüsib üks protsess faili turvalisust, samal ajal kui teine genereerib teste. Kõige järjestikuse käsitlemise asemel võimaldab Mistral Vibe sul delegeerida ülesandeid allagentidele. Allagent on agent, mis käivitub iseseisvalt, viib oma missiooni lõpule ja tagastab peaagendile tekstilise tulemuse. See ei saa kasutajalt küsimusi esitada: see peab olema täielikult autonoomne.

See piirang on kõige järgneva võti ja väärib täpsemat selgitust. Allagent töötab omaenda kontekstis, tal puudub juurdepääs praegusele vestlusele – ta ei tea midagi sellest, mida sa peaagendile viis minutit tagasi selgitasid. Ta ei saa kasutada ask_user_question ja peab ebaselgusega ise hakkama saama. Ta tagastab teksti, mille peaagent seejärel oma vastusesse integreerib. Kuna ta on vahetusest lõigatud, on mõttekas kasutada allagente ainult siis, kui need on loodud konkreetse, hästi määratletud ülesande jaoks.

Allagendi konfigureerimine

Agendi allagendiks muutmiseks lisa .toml faili väli agent_type = "subagent". Ülejäänud konfiguratsioon järgib kohandatud agentide tavalisi reegleid.

# ~/.vibe/agents/test-generator.toml
display_name = "Testide generaator"
description = "Genereerib antud funktsioonidele üksusteste."
agent_type = "subagent"
safety = "neutral"
active_model = "codestral"  # alias, mis on deklareeritud config.toml failis (2. tund)

instructions = """
Saad lähtekoodi. Genereeri põhjalikud üksustestid:
- Nominaaljuhtumite testid
- Piirjuhtumite testid (null, undefined, tühjad stringid)
- Oodatavate vigade testid
Raamistik: Kasuta projekti testiraamistikku (Jest, Vitest, Pytest...).
Tagasta ainult testikood, valmis kopeerimiseks.
"""

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

Pane tähele ask_user_question puudumist tööriistade seas: see pole unustus. Allagent ei saa täpsustust küsida ja süsteemne vihje kompenseerib seda võimatust, määrates ette kasutatava testiraamistiku ja täpse vastuse vormingu.

Konkreetsed kasutusjuhud

Esimene eelis on paralleeltöö. Peaagent saab määrata mitu ülesannet samaaegselt erinevatele allagentidele, millest igaüks töötab omaette, enne kui tulemuse tagastab.

Peaagent
├── Allagent "test-generator" → genereerib teste
├── Allagent "doc-writer" → genereerib dokumentatsiooni
└── Allagent "security-checker" → analüüsib haavatavusi

Teine eelis puudutab kõrgelt spetsialiseeritud ülesandeid. Mõned nõuavad süsteemset vihjet, mis erineb radikaalselt peaagendi omast; ühe agendi ülekoormamise asemel vastuoluliste juhistega delegeerid ülesande. Allpool olev SQL-i optimeerija on hea näide: selle vihje räägib ainult indeksitest, täitmiskavadest ja N+1 päringutest, millel poleks üldises agendis mõtet.

# ~/.vibe/agents/sql-optimizer.toml
display_name = "SQL-i optimeerija"
description = "Analüüsib ja optimeerib SQL-päringuid."
agent_type = "subagent"
safety = "safe"
active_model = "mistral-medium-3.5"  # Vibe'i sisseehitatud mudel

instructions = """
Analüüsi esitatud SQL-päringuid:
1. Tuvasta jõudlusprobleemid (N+1, täisskaneerimine, puuduv indeks)
2. Paku välja optimeeritud päringud
3. Soovita loodavaid indekseid
Tagasta struktureeritud aruanne iga päringu kohta enne/pärast võrdlusega.
"""

enabled_tools = ["read_file", "grep"]

Kolmas, vähem ilmne eelis on turvalisuse isolatsioon. Allagent, millel on safety = "safe", ei saa faile muuta, isegi kui peaagent töötab destructive režiimis: õigused ei pärandu allapoole. Seega saad töötada lubavas režiimis, usaldades analüüse piiratud allagentidele, kellel pole võimalust repositooriumis toiminguid sooritada.

# Allagent, mis saab AINULT lugeda
agent_type = "subagent"
safety = "safe"
enabled_tools = ["read_file", "grep"]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Vibe pakub ka sisseehitatud explore allagenti, mida see kasutab automaatselt, kui peab küsimusele vastamiseks läbima sinu koodibaasi. See töötab ainult lugemisrežiimis ja tagastab kokkuvõtte leitudust – täpselt sama muster, mida kordad oma allagentide loomisel.

Hea allagendi kujundamine

Kõik sõltub süsteemse vihje autonoomiast: see peab sisaldama kõiki juhiseid, mida allagent vajab lõpuni jõudmiseks ilma kunagi küsimust esitamata. See nõuab olukordade ettenägemist, kus asjad võivad valesti minna, ja täpset kirjeldamist, mida agent nendes olukordades tegema peab, nagu järgmises näites.

instructions = """
Analüüsi KÕIKI projekti TypeScripti faile.
Kui faili ei leita, liigu järgmise juurde.
Kui testiraamistikku ei saa tuvastada, kasuta vaikimisi Vitesti.
Tagasta alati tulemus, isegi kui see on osaline.
"""

Selle töö lõpetamiseks on vaja kahte refleksit. Anna allagendile rangelt ainult need tööriistad, mida ta vajab – analüüsi allagent ei vaja write_file – ja määra süsteemses vihjes kindlaks oodatav väljundvorming. Peaagent peab saama tulemust kasutada ilma ebaselguseta: just tema, mitte sina, loeb seda teksti esimesena.

Vibe’i kehtestatud reeglid

Vibe’i dokumentatsioon täpsustab mitut reeglit, mida tasub teada enne allagentide kujundamist:

  • allagent tagastab peaagendile ainult teksti ja ei saa kasutajalt küsimusi esitada;
  • ta saab kasutada ainult sisseehitatud tööriistu, mida tema fail lubab, mitte kunagi MCP tööriistu, konnektoreid ega pistikprogramme, ja mitte kunagi laiemate õigustega kui emaagent: tema [tools.<tool>] plokid saavad teda veelgi piirata, kuid mitte laiendada;
  • tema description on kohustuslik: see annab agendile märku, millal teda kasutada; fail ilma kirjelduseta märgistatakse, mitte ei laadita;
  • ta käivitub oma active_model-il või sessiooni mudelil, kui seda pole määratud;
  • peaagent käivitab ta delegeerimise teel, kasutades task tööriista; teda ei valita lipuga --agent;
  • vaikimisi saab eksisteerida ja samaaegselt töötada kuni 32 allagenti (max_subagents, max_concurrent_subagents) ja enable_subagents = false seadistus failis config.toml keelab kogu delegeerimise.

Ilma kohandatud allagendita saab agent siiski käivitada üldise allagendi, mis on varustatud oma juhiste ja tööriistadega.

Peamised punktid

  • Allagent on sõltumatu agent, mis ei saa kasutajaga suhelda
  • Konfigureeri see võtmega agent_type = "subagent" .toml failis
  • Allagendid on ideaalsed paralleeltööks ja spetsialiseeritud ülesanneteks
  • Need pakuvad loomulikku turvalisuse isolatsiooni
  • instructions peab olema täielikult autonoomne: küsimused on keelatud
  • Määra vihjes alati selge väljundvorming