Zavarovanje agenta: varnost, dovoljenja in zaupane mape
Na tej strani
Lekcija je bila ponovno napisana 2. novembra 2026. Prejšnja različica je polje
safetyopisovala kot raven dovoljenj. Dokumentacija za Vibe je izrecna: gre za vizualni indikator, ki obarva rob vnosnega polja; ne uveljavlja ničesar. Prava zaščita izvira iz seznamov orodij, dovoljenj za posamezno orodje in zaupanih map. Viri: Safety, approvals, and permissions · Configuration reference.
Kaj safety počne (in česa ne)
Polje safety v datoteki agenta sprejme pet vrednosti: safe, neutral (privzeto), destructive, smart in yolo. Spremeni barvo roba vnosnega območja, da ti ponudi hiter vizualni opomnik, katerega agenta uporabljaš. Ne odstrani orodij in ne sproži pozivov za odobritev. Agent, označen kot safe, vendar opremljen z neomejenim bash, lahko še vedno izvaja destruktivne ukaze.
Obstaja ena izjema: ko skrbnik onemogoči samodejno odobritev (enable_auto_approve = false), Vibe skrije vse agente, označene z yolo. V nasprotnem primeru je safety le oznaka, ne pa zaklep. Vedno ga kombiniraj z spodaj navedenimi dejanskimi nadzornimi mehanizmi.
Prvi vzvod: razpoložljiva orodja
enabled_tools (seznam dovoljenih) in disabled_tools (seznam prepovedanih, ki se uporabi naknadno) določata, kaj agent lahko pokliče. Sprejemata točna imena, vzorce glob in regularne izraze s predpono re:.
# Agent za revizijo samo za branje
display_name = "Varnostna revizija"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Če orodja ni na seznamu, za tega agenta ne obstaja. To je tvoje najmočnejše zagotovilo.
Drugi vzvod: dovoljenja za posamezno orodje
Za razpoložljiva orodja blok [tools.<orodje>] določa pravilo: "always" (brez poziva), "ask" (poziv vsakič) ali "never" (blokada).
display_name = "Refaktoriranje"
safety = "neutral"
enabled_tools = ["read_file", "grep", "edit", "write_file", "bash"]
[tools.edit]
permission = "always"
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pnpm test"]
denylist = ["rm -rf", "git push"]
Za bash allowlist in denylist določata predpone ukazov, ki so vedno dovoljeni ali vedno zavrnjeni. Vibe privzeto dovoli nekaj ukazov samo za branje (ls, pwd, cat, git status itd.), vendar vsak seznam, ki ga napišeš, nadomesti privzeti seznam: vključi vse privzete ukaze, ki jih želiš obdržati. Za read_file, write_file in edit ti seznami sprejemajo vzorce absolutnih poti. Eno previdnostno pravilo: skripta, zagnana prek bash, lahko konstruira poti, ki jih Vibe ne vidi v samem ukazu; kadar so stave visoke, naj bo bash nastavljen na "ask".
Tretji vzvod: obseg delovnega imenika
Privzeto Vibe sproži poziv, preden orodje za datoteke ali lupino dostopa do poti izven delovnega imenika, tudi prek simbolne povezave, in pred branjem ali spreminjanjem datotek .env in .envrc. To vedenje lahko okrepiš:
outside_workdir = "deny" # namesto poziva zavrnitev; agent prejme napako in nadaljuje
Četrti vzvod: zaupane mape
Skladišče lahko svojo konfiguracijo Vibe (agenti, veščine, strežniki MCP, dovoljenja) združi v mapi .vibe/ ali navodila v datoteki AGENTS.md. Ker ta konfiguracija spremeni vedenje Vibea, se naloži le iz mape, ki si jo izrecno odobril. Ob prvem zagonu Vibe izpiše zaznane datoteke in ponudi možnosti Zaupaj mapi, Zaupaj celotnemu skladišču ali Ne zaupaj; tvoje izbire so shranjene v ~/.vibe/trusted_folders.toml. Pogovorno okno teh datotek ne analizira: pregledaj jih kot katero koli drugo kodo v skladišču, zlasti definicije strežnikov MCP in dovoljenja. V programskem načinu Vibe nikoli ne sproži poziva: vibe --trust podeli začasno zaupanje za eno samo izvedbo.
Odzivanje na poziv za odobritev
Ko Vibe sproži poziv, so možni štirje odzivi s tipkovnico: 1 ali y dovoli enkrat, 2 za preostanek seje, 3 vedno, 4, n ali Escape pa zavrne. Barva roba te spominja, kateri agent je aktiven.
Izbira pravega ravnovesja
| Potreba | Nastavitev |
|---|---|
| Analiza brez dotikanja česar koli | enabled_tools = ["read_file", "grep"] |
| Refaktoriranje z zaupanjem | edit nastavljen na "always", bash nastavljen na "ask" s allowlist ukazov za testiranje |
| Čiščenje projekta | bash nastavljen na "ask" in denylist nepovratnih ukazov |
| Naloga brez nadzora v CI | Ephemeralni zabojnik, vibe --prompt … --auto-approve, omejitvi --max-turns in --time-limit |
Zlato pravilo ostaja najmanjši privilegij: vsakemu agentu daj najmanjše potrebno, začni restriktivno in odpri le po potrebi.
Ključne ugotovitve
safety(safe,neutral,destructive,smart,yolo) obarva rob; ne uveljavlja nobenih dovoljenj- Dejanski zaklepi:
enabled_tools/disabled_tools, nato[tools.<orodje>](always,ask,never) - Za
bashallowlistindenylistnadomestita privzeta seznama - Vibe sproži poziv pred zapustitvijo delovnega imenika ali dotikom datotek
.env - Konfiguracija projekta se naloži le v zaupani mapi; pred odobritvijo jo pregledaj