Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Messa in sicurezza di un agente: sicurezza, permessi e cartelle attendibili

Lezione 3 di 14 Aggiornata il 2 novembre 2026 Avanzato
In questa pagina
  1. Cosa fa (e cosa non fa) safety
  2. Prima leva: strumenti disponibili
  3. Seconda leva: permessi per singolo strumento
  4. Terza leva: ambito della directory di lavoro
  5. Quarta leva: cartelle attendibili
  6. Rispondere a un prompt di approvazione
  7. Scegliere il giusto equilibrio
  8. Punti chiave

Lezione riscritta il 2 novembre 2026. La versione precedente descriveva il campo safety come un livello di autorizzazione. La documentazione di Vibe è esplicita: si tratta di un indicatore visivo che colora il bordo dell’input; non impone alcun vincolo. La protezione reale deriva dagli elenchi di strumenti, dai permessi per singolo strumento e dalle cartelle attendibili. Fonti: Safety, approvals, and permissions · Configuration reference.

Cosa fa (e cosa non fa) safety

Il campo safety in un file di agente accetta cinque valori: safe, neutral (il predefinito), destructive, smart e yolo. Modifica il colore del bordo dell’area di input per offrirti un promemoria immediato su quale agente stai utilizzando. Non rimuove strumenti né attiva richieste di approvazione. Un agente contrassegnato come safe ma dotato di bash senza restrizioni può comunque eseguire comandi distruttivi.

C’è un’unica eccezione: quando un amministratore disabilita l’approvazione automatica (enable_auto_approve = false), Vibe nasconde tutti gli agenti contrassegnati come yolo. Altrimenti, safety è un’etichetta, non un lucchetto. Abbinalo sempre ai controlli reali descritti di seguito.

Prima leva: strumenti disponibili

enabled_tools (allowlist) e disabled_tools (denylist, applicata successivamente) decidono cosa l’agente può chiamare. Accettano nomi esatti, pattern glob ed espressioni regolari prefissate con re:.

# Agente di audit in sola lettura
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]

Se uno strumento non è nell’elenco, per quell’agente non esiste. Questa è la tua garanzia più forte.

Seconda leva: permessi per singolo strumento

Per gli strumenti disponibili, un blocco [tools.<tool>] definisce la regola: "always" (nessun prompt), "ask" (prompt ogni volta) o "never" (blocco).

display_name = "Refactoring"
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"]

Per bash, allowlist e denylist specificano prefissi di comando sempre consentiti o sempre negati. Vibe consente alcuni comandi in sola lettura per impostazione predefinita (ls, pwd, cat, git status, ecc.), ma qualsiasi elenco tu scriva sostituisce quello predefinito: includi eventuali comandi predefiniti che desideri mantenere. Per read_file, write_file ed edit, questi elenchi accettano pattern di percorsi assoluti. Una regola prudente: uno script eseguito tramite bash può costruire percorsi che Vibe non vede nel comando stesso; imposta bash su "ask" ogni volta che la posta in gioco lo giustifica.

Terza leva: ambito della directory di lavoro

Per impostazione predefinita, Vibe richiede una conferma prima che uno strumento di file o shell acceda a un percorso esterno alla directory di lavoro, anche tramite un collegamento simbolico, e prima di leggere o modificare i file .env e .envrc. Puoi rafforzare questo comportamento:

outside_workdir = "deny"   # nega invece di chiedere; l'agente riceve un errore e continua

Quarta leva: cartelle attendibili

Un repository può includere la propria configurazione Vibe (agenti, competenze, server MCP, permessi) in una cartella .vibe/, oppure istruzioni in un file AGENTS.md. Poiché questa configurazione modifica il comportamento di Vibe, viene caricata solo da una cartella che hai esplicitamente approvato. Al primo avvio, Vibe elenca i file rilevati e offre le opzioni Trust folder, Trust full repo o Don’t trust; le tue scelte vengono salvate in ~/.vibe/trusted_folders.toml. La finestra di dialogo non analizza questi file: revisionali come qualsiasi altro codice nel repository, in particolare le definizioni dei server MCP e i permessi. In modalità programmatica, Vibe non mostra mai prompt: vibe --trust concede un’attendibilità temporanea per una singola esecuzione.

Rispondere a un prompt di approvazione

Quando Vibe mostra un prompt, sono possibili quattro risposte da tastiera: 1 o y consente una volta, 2 per il resto della sessione, 3 sempre, e 4, n o Escape nega. Il colore del bordo ti ricorda quale agente è attivo.

Scegliere il giusto equilibrio

NecessitàImpostazione
Analizzare senza toccare nullaenabled_tools = ["read_file", "grep"]
Refactoring con sicurezzaedit impostato su "always", bash su "ask" con un allowlist di comandi di test
Pulizia di un progettobash impostato su "ask" e un denylist di comandi irreversibili
Attività non presidiata in CIContainer effimero, vibe --prompt … --auto-approve, limiti --max-turns e --time-limit

La regola d’oro rimane il minimo privilegio: dai a ogni agente il minimo necessario, inizia in modo restrittivo e apri solo se necessario.

Punti chiave

  • safety (safe, neutral, destructive, smart, yolo) colora il bordo; non impone permessi
  • Blocchi reali: enabled_tools/disabled_tools, poi [tools.<tool>] (always, ask, never)
  • Per bash, allowlist e denylist sostituiscono gli elenchi predefiniti
  • Vibe chiede conferma prima di uscire dalla directory di lavoro o toccare file .env
  • La configurazione del progetto viene caricata solo in una cartella attendibile; revisionala prima di approvare