Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Alipalvelimet: Tehtävien delegointi erikoistuneille toimijoille

Oppitunti 5 / 14 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Delegoinnin periaate
  2. Alipalvelimen konfigurointi
  3. Konkreettiset käyttötapaukset
  4. Hyvän alipalvelimen suunnittelu
  5. Viben asettamat säännöt
  6. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026. Esimerkkiagenttitiedostot käyttävät nyt Viben dokumentoimia avaimia: instructions (ei system_prompt), active_model (ei model), [tools.<tool>]-lohkot hyväksyntöjä varten (auto_approve-avainta ei ole olemassa agenttitiedostossa) ja todellisia työkalujen nimiä (edit, ei edit_file; ei list_dir-työkalua). Muistutus oppitunnista 3: safety on visuaalinen indikaattori, ei käyttöoikeus. Lähde: Configuration reference.

Delegoinnin periaate

Monimutkaisissa projekteissa tietyt tehtävät ovat toisistaan riippumattomia: esimerkiksi tiedoston turvallisuuden analysointi samalla, kun toinen prosessi luo testejä. Kaiken käsittelyn sijaan peräkkäin Mistral Vibe antaa sinun delegoida tehtäviä alipalvelimille. Alipalvelin on agentti, joka suoritetaan itsenäisesti, completes tehtävänsä ja palauttaa tekstituloksen pääagentille. Se ei voi esittää kysymyksiä käyttäjälle: sen on oltava täysin autonominen.

Tämä rajoitus on kaiken seuraavan avain, ja se ansaitsee tarkennusta. Alipalvelin toimii omassa kontekstissaan ilman pääsyä nykyiseen keskusteluun – se ei tiedä mitään siitä, mitä selitit pääagentille viisi minuuttia sitten. Se ei voi käyttää ask_user_question-toimintoa, ja sen on hallittava epäselvyydet itse. Se palauttaa tekstiä, jonka pääagentti integroi sitten omaan vastaukseensa. Koska se on eristetty vuorovaikutuksesta, sillä on järkeä vain, kun se on suunniteltu tiettyä, hyvin määriteltyä tehtävää varten.

Alipalvelimen konfigurointi

Muuttaaksesi agentin alipalvelimeksi, lisää kenttä agent_type = "subagent" .toml-tiedostoon. Loput konfiguraatiosta noudattavat mukautettujen agenttien tavallisia sääntöjä.

# ~/.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",
]

Huomaa ask_user_question-työkalun puuttuminen: tämä ei ole vahinko. Alipalvelin ei voi pyytää tarkennuksia, ja järjestelmäkehote kompensoi tätä mahdottomuutta määrittelemällä etukäteen käytettävän testikehyksen ja tarkan vastausmuodon.

Konkreettiset käyttötapaukset

Ensimmäinen hyöty on rinnakkainen työskentely. Pääagentti voi antaa useita tehtäviä samanaikaisesti eri alipalvelimille, joista kukin työskentelee omalla tahollaan ennen tuloksensa palauttamista.

Main Agent
├── Subagent "test-generator" → generates tests
├── Subagent "doc-writer" → generates documentation
└── Subagent "security-checker" → analyzes vulnerabilities

Toinen hyöty liittyy erittäin erikoistuneisiin tehtäviin. Jotkin tehtävät vaativat järjestelmäkehotteen, joka poikkeaa radikaalisti pääagentin kehotteesta; yhden agentin kuormittamisen sijaan ristiriitaisilla ohjeilla delegoit tehtävän. Alla oleva SQL-optimoija on hyvä esimerkki: sen kehote puhuu vain indekseistä, suoritus-suunnitelmista ja N+1-kyselyistä, mikä ei olisi järkevää yleiskäyttöisessä agentissa.

# ~/.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"]

Kolmas, vähemmän ilmeinen hyöty on turvallisuuden eristäminen. Alipalvelin, jonka safety = "safe", ei voi muokata tiedostoja, vaikka pääagentti toimisi destructive-tilassa: käyttöoikeudet eivät periydy alaspäin. Voit siis työskennellä sallivassa tilassa samalla, kun uskot analyysit rajoitetuille alipalvelimille, joilla ei ole mahdollisuutta toimia repositoriossa.

# 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 tarjoaa myös sisäänrakennetun explore-alipalvelimen, jota se käyttää automaattisesti, kun sen tarvitsee traversoida koodikantaasi vastatakseen kysymykseen. Se toimii vain luku -tilassa ja palauttaa yhteenvedon löydöksistään – täsmälleen saman mallin, jonka toistat omilla alipalvelimillasi.

Hyvän alipalvelimen suunnittelu

Kaikki riippuu järjestelmäkehotteen autonomiasta: sen on sisällettävä kaikki ohjeet, jotka alipalvelin tarvitsee päästäkseen maaliin koskaan kysymättä mitään. Tämä vaatii ennakoimaan tilanteita, joissa asiat menevät pieleen, ja kirjoittamaan tarkasti, mitä agentin on tehtävä näissä tilanteissa, kuten seuraavassa esimerkissä.

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.
"""

Kaksi refleksia täydentävät tätä työtä. Anna alipalvelimelle ehdottomasti vain ne työkalut, joita se tarvitsee – analyysialipalvelin ei tarvitse write_file-työkalua – ja määritä odotettu tulostemuoto järjestelmäkehotteessa. Pääagentin on pystyttävä hyödyntämään tulosta ilman epäselvyyksiä: se, ei sinä, lukee tämän tekstin ensimmäisenä.

Viben asettamat säännöt

Viben dokumentaatio määrittelee useita sääntöjä, jotka on hyvä tuntea ennen alipalvelimien suunnittelua:

  • alipalvelin palauttaa pääagentille vain tekstiä eikä voi esittää kysymyksiä käyttäjälle;
  • se voi käyttää vain niitä sisäänrakennettuja työkaluja, jotka sen tiedosto sallii, ei koskaan MCP-työkaluja, liittimiä tai laajennuksia, eikä koskaan laajemmilla käyttöoikeuksilla kuin emoagentilla: sen [tools.<tool>]-lohkot voivat vain rajoittaa sitä entisestään, eivät laajentaa;
  • sen description on pakollinen: tämä kertoo agentille, milloin sitä tulee käyttää; tiedosto ilman kuvausta merkitään virheelliseksi eikä sitä ladata;
  • se suoritetaan sen active_model-mallilla tai istunnon mallilla, jos mallia ei ole asetettu;
  • pääagentti käynnistää sen delegoinnin kautta käyttämällä task-työkalua; sitä ei valita lipulla --agent;
  • oletusarvoisesti jopa 32 alipalvelinta voi olla olemassa ja suorittaa samanaikaisesti (max_subagents, max_concurrent_subagents), ja enable_subagents = false asetus tiedostossa config.toml kieltää kaiken delegoinnin.

Ilman mukautettua alipalvelinta agentti voi silti käynnistää yleiskäyttöisen alipalvelimen, joka on varustettu omilla ohjeillaan ja työkaluillaan.

Keskeiset asiat

  • Alipalvelin on itsenäinen agentti, joka ei voi olla vuorovaikutuksessa käyttäjän kanssa
  • Konfiguroi se lisäämällä agent_type = "subagent" .toml-tiedostoon
  • Alipalvelimet ovat ihanteellisia rinnakkaiseen työskentelyyn ja erikoistuneisiin tehtäviin
  • Ne tarjoavat luonnollisen turvallisuuden eristämisen
  • instructions-kehotteen on oltava täysin autonominen: kysymykset ovat kiellettyjä
  • Määritä aina selkeä tulostemuoto kehotteessa