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

Modos Unificados: Combine Ferramentas, Permissões e Comportamentos

Aula 4 de 14 Atualizada a 2 de novembro de 2026 Avancado
Nesta página
  1. O conceito de modos unificados
  2. Estrutura de um modo unificado
  3. Conceção de modos complementares
  4. Alternar entre modos e organizá-los
  5. Pontos-chave

Lição atualizada em 2 de novembro de 2026. Os ficheiros de agente de exemplo utilizam agora as chaves documentadas pela Vibe: instructions (e não system_prompt), active_model (e não model), blocos [tools.<tool>] para aprovações (a chave auto_approve não existe num ficheiro de agente) e nomes reais de ferramentas (edit, e não edit_file; não existe a ferramenta list_dir). Lembrete da Lição 3: safety é um indicador visual, não uma permissão. Fonte: Referência de configuração.

O conceito de modos unificados

Os agentes personalizados que abordámos nas lições anteriores definem um perfil estático: um modelo, um conjunto de ferramentas e um nível de segurança. Os modos unificados vão mais além, combinando múltiplas dimensões numa única configuração coerente que pode ativar com um único gesto. Um modo unificado agrupa ferramentas autorizadas, permissões específicas, comportamento orientado por instruções de sistema, regras de aprovação automática e restrições contextuais.

O valor torna-se óbvio quando o seu trabalho muda várias vezes num dia. Sem modos unificados, gere múltiplas definições sempre que o seu contexto muda: passa da revisão de código para a implementação e tem de trocar de agentes, ajustar permissões e afinar o prompt. Um modo unificado encapsula tudo isso num único perfil, que ativa no arranque ou a meio da sessão.

# Ativar o modo "deploy"
vibe --agent deploy-mode

# Mudar para o modo "review"
# Shift+Tab → selecionar review-mode

Estrutura de um modo unificado

Tecnicamente, um modo unificado é um agente personalizado; a diferença face a um agente clássico é conceptual. Já não concebe o ficheiro .toml como “um assistente que pode fazer X”, mas como um contexto de trabalho completo: o que lhe é permitido fazer durante esta fase do projeto, com que nível de cautela e de que forma os resultados lhe são devolvidos.

O modo de revisão abaixo ilustra isto de forma mais clara. É apenas de leitura, pelo que é aprovado automaticamente sem risco, e o seu prompt impõe um formato de relatório que pode integrar diretamente num pull request.

# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Modo de revisão de código: apenas leitura, análise profunda, sugestões."

safety = "safe"
active_model = "mistral-medium-3.5"  # modelo integrado na Vibe

instructions = """
Está no modo de revisão de código.
Objetivo: analisar a qualidade, segurança e manutenibilidade do código.
Regras:
- Nunca modificar ficheiros
- Produzir um relatório estruturado (problemas críticos, avisos, sugestões)
- Citar as linhas de código afetadas com os respetivos números de linha
- Propor correções como diffs
Formato de saída: Markdown com secções Crítico / Aviso / Sugestão
"""

enabled_tools = [
  "read_file",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

O modo de implementação é exatamente o oposto, e esse contraste é intencional. Possui bash, pelo que pode causar danos, mas as suas permissões ask para write_file e bash mantêm-no envolvido no processo, e o seu prompt descreve uma sequência estrita que o agente deve seguir do início ao fim.

# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Modo de implementação: compilar, testar, implementar com validação em cada etapa."

safety = "destructive"
active_model = "codestral"  # alias declarado em config.toml (Lição 2)

instructions = """
Está no modo de implementação.
Sequência obrigatória:
1. Verificar se todos os testes passam
2. Compilar o projeto
3. Validar a compilação (sem erros, sem avisos)
4. Solicitar confirmação antes da implementação real
5. Implementar
6. Verificar se o serviço responde
Nunca implementar se os testes falharem.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Conceção de modos complementares

A ideia é criar um conjunto de modos que cubram o seu ciclo de desenvolvimento, desde a descoberta até à correção. O modo de exploração abre o caminho: apenas de leitura e aprovado automaticamente, ajuda-o a compreender um repositório antes de o tocar.

display_name = "Explore Mode"
safety = "safe"
instructions = """Explorar a base de código, identificar a arquitetura, padrões e dependências."""
enabled_tools = ["read_file", "grep",]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

Segue-se o modo Dev, onde passará a maior parte do seu tempo. Escreve e executa comandos — para executar testes, por exemplo — mas pede a sua aprovação, e o seu prompt associa cada alteração à escrita de testes.

display_name = "Dev Mode"
safety = "neutral"
instructions = """Implementar as funcionalidades solicitadas. Escrever testes para cada alteração."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

[tools.bash]
permission = "ask"

Finalmente, o modo Fix é deliberadamente restrito. Sem write_file, apenas edit: o agente modifica código existente sem criar novos ficheiros, o que impede que “refatore no processo” um erro que simplesmente lhe pediu para corrigir. Por ser tão limitado, podemos aprová-lo automaticamente com segurança.

display_name = "Fix Mode"
safety = "neutral"
instructions = """Corrigir erros reportados. Minimizar alterações. Tocar apenas no código afetado."""
enabled_tools = ["read_file", "edit", "grep"]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.grep]
permission = "always"

Alternar entre modos e organizá-los

Numa sessão interativa, Shift+Tab percorre os modos: a Vibe apresenta a lista de todos os seus agentes, integrados e personalizados, com as suas descrições — é aqui que as descrições cuidadosas da lição anterior compensam. A partir da linha de comandos, inicia diretamente num modo ou inspeciona o conteúdo do diretório de agentes.

# Iniciar diretamente num modo
vibe --agent review-mode

# Listar agentes disponíveis
ls ~/.vibe/agents/

Por fim, adote uma convenção de nomes clara. O sufixo -mode distingue imediatamente os seus contextos de trabalho de agentes utilitários mais ad hoc, e a ordem alfabética do diretório mantém-se legível mesmo após uma dúzia de ficheiros.

~/.vibe/agents/
├── review-mode.toml      # Revisão de código
├── deploy-mode.toml      # Implementação
├── dev-mode.toml         # Desenvolvimento
├── fix-mode.toml         # Correções
├── explore-mode.toml     # Exploração
└── doc-mode.toml         # Documentação

Pontos-chave

  • Um modo unificado é um agente personalizado concebido como um contexto de trabalho completo
  • Combina ferramentas, permissões, prompt de sistema e modelo numa única configuração
  • Crie modos complementares para cobrir o seu ciclo de desenvolvimento
  • Shift+Tab permite alternar entre modos em tempo real
  • Nomeie os seus ficheiros de forma consistente para os encontrar facilmente
  • Cada modo deve ter um objetivo claro e permissões adequadas