Proteger um agente: segurança, permissões e pastas fidedignas
Nesta página
Lição reescrita em 2 de novembro de 2026. A versão anterior descrevia o campo
safetycomo um nível de permissão. A documentação do Vibe é explícita: trata-se de um indicador visual que colore a borda da entrada; não impõe qualquer restrição. A proteção real advém das listas de ferramentas, das permissões por ferramenta e das pastas fidedignas. Fontes: Safety, approvals, and permissions · Configuration reference.
O que o safety faz (e não faz)
O campo safety num ficheiro de agente aceita cinco valores: safe, neutral (o padrão), destructive, smart e yolo. Altera a cor da borda da área de entrada para lhe dar um lembrete imediato sobre qual agente está a utilizar. Não remove ferramentas nem aciona pedidos de aprovação. Um agente marcado como safe, mas equipado com bash sem restrições, pode ainda assim executar comandos destrutivos.
Existe uma exceção: quando um administrador desativa a aprovação automática (enable_auto_approve = false), o Vibe oculta todos os agentes marcados como yolo. Caso contrário, safety é apenas um rótulo, não um cadeado. Associe-o sempre aos controlos reais descritos abaixo.
Primeira alavanca: ferramentas disponíveis
enabled_tools (lista de permissões) e disabled_tools (lista de negação, aplicada posteriormente) decidem o que o agente pode invocar. Aceitam nomes exatos, padrões glob e expressões regulares prefixadas com re:.
# Agente de auditoria apenas de leitura
display_name = "Security Audit"
safety = "safe"
enabled_tools = ["read_file", "grep"]
Se uma ferramenta não estiver na lista, ela não existe para esse agente. Esta é a sua garantia mais forte.
Segunda alavanca: permissões por ferramenta
Para as ferramentas disponíveis, um bloco [tools.<tool>] define a regra: "always" (sem pedido), "ask" (pedir sempre) ou "never" (bloquear).
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"]
Para bash, allowlist e denylist especificam prefixos de comando que são sempre permitidos ou sempre negados. O Vibe permite alguns comandos de apenas leitura por padrão (ls, pwd, cat, git status, etc.), mas qualquer lista que escreva substitui a lista padrão: inclua quaisquer comandos padrão que deseje manter. Para read_file, write_file e edit, estas listas aceitam padrões de caminho absoluto. Uma regra prudente: um script executado via bash pode construir caminhos que o Vibe não vê no próprio comando; mantenha bash definido como "ask" sempre que os riscos o justifiquem.
Terceira alavanca: âmbito do diretório de trabalho
Por padrão, o Vibe solicita confirmação antes de uma ferramenta de ficheiro ou de shell aceder a um caminho fora do diretório de trabalho, mesmo através de uma ligação simbólica, e antes de ler ou modificar ficheiros .env e .envrc. Pode reforçar este comportamento:
outside_workdir = "deny" # negar em vez de solicitar; o agente recebe um erro e continua
Quarta alavanca: pastas fidedignas
Um repositório pode incluir a sua própria configuração do Vibe (agentes, competências, servidores MCP, permissões) numa pasta .vibe/, ou instruções num ficheiro AGENTS.md. Como esta configuração altera o comportamento do Vibe, ela só é carregada a partir de uma pasta que tenha aprovado explicitamente. No primeiro arranque, o Vibe lista os ficheiros detetados e oferece as opções Trust folder, Trust full repo ou Don’t trust; as suas escolhas são guardadas em ~/.vibe/trusted_folders.toml. A caixa de diálogo não analisa estes ficheiros: reveja-os como qualquer outro código no repositório, especialmente as definições de servidores MCP e permissões. No modo programático, o Vibe nunca solicita: vibe --trust concede confiança temporária para uma única execução.
Responder a um pedido de aprovação
Quando o Vibe solicita confirmação, são possíveis quatro respostas de teclado: 1 ou y permite uma vez, 2 para o resto da sessão, 3 sempre, e 4, n ou Escape nega. A cor da borda lembra-lhe qual agente está ativo.
Escolher o equilíbrio certo
| Necessidade | Configuração |
|---|---|
| Analisar sem tocar em nada | enabled_tools = ["read_file", "grep"] |
| Refatorar com confiança | edit definido como "always", bash definido como "ask" com uma allowlist de comandos de teste |
| Limpar um projeto | bash definido como "ask" e uma denylist de comandos irreversíveis |
| Tarefa não supervisionada em CI | Contentor efémero, vibe --prompt … --auto-approve, limita --max-turns e --time-limit |
A regra de ouro permanece o privilégio mínimo: dê a cada agente o mínimo necessário, comece de forma restritiva e abra apenas conforme necessário.
Pontos-chave
safety(safe,neutral,destructive,smart,yolo) colore a borda; não impõe permissões- Bloqueios reais:
enabled_tools/disabled_tools, depois[tools.<tool>](always,ask,never) - Para
bash,allowlistedenylistsubstituem as listas padrão - O Vibe solicita confirmação antes de sair do diretório de trabalho ou tocar em ficheiros
.env - A configuração do projeto carrega apenas numa pasta fidedigna; reveja-a antes de aprovar