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

Yhdistetyt tilat: työkalujen, oikeuksien ja käyttäytymisen yhdistäminen

Oppitunti 4 / 14 Päivitetty 2. marraskuuta 2026 Edistynyt
Tällä sivulla
  1. Yhdistettyjen tilojen käsite
  2. Yhdistetyn tilan rakenne
  3. Toisiaan täydentävien tilojen suunnittelu
  4. Tilien välillä vaihtaminen ja niiden järjestäminen
  5. 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 (avainta auto_approve ei ole olemassa agenttitiedostossa) ja todellisia työkalunimiä (edit, ei edit_file; ei list_dir-työkalua). Muistutus oppitunnilta 3: safety on visuaalinen indikaattori, ei käyttöoikeus. Lähde: Configuration reference.

Yhdistettyjen tilojen käsite

Edellisillä oppitunneilla käsitellyt mukautetut agentit määrittelevät staattisen profiilin: mallin, työkalusarjan ja turvallisuustason. Yhdistetyt tilat vievät tämän pidemmälle yhdistämällä useita ulottuvuuksia yhdeksi johdonmukaiseksi kokonaisuudeksi, jonka voit ottaa käyttöön yhdellä liikkeellä. Yhdistetty tila niputtaa yhteen sallitut työkalut, tietyt käyttöoikeudet, kehoteohjatun käyttäytymisen, automaattiset hyväksymissäännöt ja kontekstisidonnaiset rajoitukset.

Arvo käy ilmeiseksi, kun työsi siirtyy useita kertoja päivän aikana. Ilman yhdistettyjä tiloja joudut säätämään asetuksia jatkuvasti kontekstin muuttuessa: siirryt koodin tarkistuksesta käyttöönottoon, ja sinun on vaihdettava agenttia, mukautettava oikeuksia ja hienosäädettävä kehotetta. Yhdistetty tila kapseloi kaiken tämän yhteen profiiliin, jonka voit aktivoida käynnistyksen yhteydessä tai istunnon aikana.

# Ota käyttöön "deploy"-tila
vibe --agent deploy-mode

# Vaihda "review"-tilaan
# Shift+Tab → valitse review-mode

Yhdistetyn tilan rakenne

Teknisesti yhdistetty tila on mukautettu agentti; ero klassiseen agenttiin on käsitteellinen. Et enää suunnittele .toml-tiedostoa “avustajana, joka voi tehdä X:n”, vaan täydellisenä työkontekstina: mitä sinun on sallittua tehdä projektin tässä vaiheessa, millä varovaisuustasolla ja missä muodossa tulokset palautetaan sinulle.

Alla oleva tarkistustila havainnollistaa tätä selkeimmin. Se on vain luku -tilassa, joten se hyväksytään automaattisesti ilman riskiä, ja sen kehote pakottaa raporttimuotoon, jonka voit liittää suoraan vetopyyntöön.

# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Code review mode: read-only, deep analysis, suggestions."

safety = "safe"
active_model = "mistral-medium-3.5"  # model built into Vibe

instructions = """
You are in code review mode.
Goal: analyze code quality, security, and maintainability.
Rules:
- Never modify files
- Produce a structured report (critical issues, warnings, suggestions)
- Cite affected code lines with their line numbers
- Propose fixes as diffs
Output format: Markdown with Critical / Warning / Suggestion sections
"""

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

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Käyttöönottotila on sen täydellinen vastakohta, ja tämä kontrasti on tarkoituksellinen. Siinä on bash, joten se voi rikkoa asioita, mutta sen ask-oikeudet kohteille write_file ja bash pitävät sinut silmukassa, ja sen kehote kuvailee tiukan sekvenssin, jota agentin on noudatettava alusta loppuun.

# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Deploy mode: build, test, deploy with validation at each step."

safety = "destructive"
active_model = "codestral"  # alias declared in config.toml (Lesson 2)

instructions = """
You are in deploy mode.
Mandatory sequence:
1. Verify that all tests pass
2. Build the project
3. Validate the build (no errors, no warnings)
4. Request confirmation before actual deployment
5. Deploy
6. Verify that the service responds
Never deploy if tests fail.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Toisiaan täydentävien tilojen suunnittelu

Ajatuksena on luoda joukko tiloja, jotka kattavat kehityssyklin tutkimuksesta korjaamiseen. Tutkimustila vie eteenpäin: se on vain luku -tilassa ja hyväksytään automaattisesti, mikä auttaa ymmärtämään repositoriota ennen kuin kosket siihen.

display_name = "Explore Mode"
safety = "safe"
instructions = """Explore the codebase, identify the architecture, patterns, and dependencies."""
enabled_tools = ["read_file", "grep",]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Seuraavaksi tulee Dev-tila, jossa vietät suurimman osan ajastasi. Se kirjoittaa ja suorittaa komentoja – esimerkiksi testien ajamiseen – mutta se pyytää hyväksyntääsi, ja sen kehote sitoo jokaisen muutoksen testien kirjoittamiseen.

display_name = "Dev Mode"
safety = "neutral"
instructions = """Implement the requested features. Write tests for every change."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

[tools.bash]
permission = "ask"

Lopuksi Fix-tila on tarkoituksellisen kapea. Ei write_file:ää, vain edit: agentti muokkaa olemassa olevaa koodia luomatta uusia tiedostoja, mikä estää sitä “refaktoroimasta matkan varrella” bugia, jonka pyysit sitä vain korjaamaan. Koska se on näin rajoitettu, voimme hyväksyä sen turvallisesti automaattisesti.

display_name = "Fix Mode"
safety = "neutral"
instructions = """Fix reported bugs. Minimize changes. Touch only the affected code."""
enabled_tools = ["read_file", "edit", "grep"]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.grep]
permission = "always"

Tilien välillä vaihtaminen ja niiden järjestäminen

Vuorovaikutteisessa istunnossa Shift+Tab kierrättää tiloja: Vibe näyttää listan kaikista agenteistasi, sekä sisäänrakennetuista että mukautetuista, kuvauksineen – tässä aiemman oppitunnin huolelliset kuvaukset tuottavat hedelmää. Komentoriviltä käynnistät suoraan tietyssä tilassa tai tarkastelet agenttihakemiston sisältöä.

# Käynnistä suoraan tilassa
vibe --agent review-mode

# Listaa saatavilla olevat agentit
ls ~/.vibe/agents/

Lopuksi omaksu selkeä nimeämiskäytäntö. -mode-pääte erottaa työkontekstisi välittömästi ad hoc -apuagenteista, ja hakemiston aakkosjärjestys pysyy luettavana jopa tusinan tiedoston jälkeen.

~/.vibe/agents/
├── review-mode.toml      # Code review
├── deploy-mode.toml      # Deployment
├── dev-mode.toml         # Development
├── fix-mode.toml         # Fixes
├── explore-mode.toml     # Exploration
└── doc-mode.toml         # Documentation

Keskeiset asiat

  • Yhdistetty tila on mukautettu agentti, joka on suunniteltu täydelliseksi työkontekstiksi
  • Se yhdistää työkalut, oikeudet, järjestelmäkehotteen ja mallin yhteen määritykseen
  • Luo toisiaan täydentäviä tiloja kattamaan kehityssyklisi
  • Shift+Tab mahdollistaa tilojen vaihtamisen reaaliajassa
  • Nimeä tiedostosi johdonmukaisesti, jotta löydät ne helposti
  • Jokaisella tilalla on oltava selkeä tavoite ja asianmukaiset oikeudet