Yhdistetyt tilat: työkalujen, oikeuksien ja käyttäytymisen yhdistäminen
Tällä sivulla
Oppitunti päivitetty 2. marraskuuta 2026. Esimerkkiagenttitiedostot käyttävät nyt Viben dokumentoimia avaimia:
instructions(eisystem_prompt),active_model(eimodel),[tools.<tool>]-lohkot hyväksyntöjä varten (avaintaauto_approveei ole olemassa agenttitiedostossa) ja todellisia työkalunimiä (edit, eiedit_file; eilist_dir-työkalua). Muistutus oppitunnilta 3:safetyon 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+Tabmahdollistaa tilojen vaihtamisen reaaliajassa- Nimeä tiedostosi johdonmukaisesti, jotta löydät ne helposti
- Jokaisella tilalla on oltava selkeä tavoite ja asianmukaiset oikeudet