Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Proteger um agente: segurança, permissões e pastas fidedignas

Aula 3 de 14 Atualizada a 2 de novembro de 2026 Avancado
Nesta página
  1. O que o safety faz (e não faz)
  2. Primeira alavanca: ferramentas disponíveis
  3. Segunda alavanca: permissões por ferramenta
  4. Terceira alavanca: âmbito do diretório de trabalho
  5. Quarta alavanca: pastas fidedignas
  6. Responder a um pedido de aprovação
  7. Escolher o equilíbrio certo
  8. Pontos-chave

Lição reescrita em 2 de novembro de 2026. A versão anterior descrevia o campo safety como 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

NecessidadeConfiguração
Analisar sem tocar em nadaenabled_tools = ["read_file", "grep"]
Refatorar com confiançaedit definido como "always", bash definido como "ask" com uma allowlist de comandos de teste
Limpar um projetobash definido como "ask" e uma denylist de comandos irreversíveis
Tarefa não supervisionada em CIContentor 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, allowlist e denylist substituem 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