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

Agentes Integrados do Mistral Vibe

Aula 1 de 14 Atualizada a 3 de novembro de 2026 Avancado
Nesta página
  1. O Que É um Agente no Vibe?
  2. Agentes Fornecidos com o Vibe
  3. Escolher e Alternar Agentes
  4. E o Modo “Plan”?
  5. Subagentes
  6. Instruções do Projeto: AGENTS.md
  7. Pontos-chave

Lição reescrita em 2 de novembro de 2026 com base na documentação do Vibe Code. A versão anterior listava quatro agentes, incluindo default e plan: default é agora ask, o agente padrão é accept-edits, e foram adicionados smart-approve e lean. Já não existe um agente integrado plan. Fontes: Agents · Safety, approvals, and permissions. Atualização de 3 de novembro: Verificado no mistral-vibe 3.0.4. O agente lean apenas suporta o modelo labs-leanstral-1-5, que a tabela de modelos da Mistral indica ter sido descontinuado a 30 de setembro de 2026. Já não consegue responder.

O Que É um Agente no Vibe?

No Vibe, um agente é um conjunto de configurações sobrepostas às suas definições globais: um prompt de sistema, um modelo, uma seleção de ferramentas e regras de aprovação. A questão não é apenas “O que estou a pedir ao Vibe para fazer?”, mas também “Que agente estou a usar e, consequentemente, que permissões ele tem?”. Escolher o agente certo significa equilibrar o seu controlo com a velocidade da ferramenta. Manter a aprovação manual o dia todo desperdiça tempo em ações de baixo risco, mas permitir tudo num repositório crítico é uma receita para o desastre.

Agentes Fornecidos com o Vibe

AgenteComportamento de AprovaçãoCaso de Uso
askPergunta antes de cada ferramenta (antigo default)Explorar um repositório desconhecido; verificar tudo
accept-editsAgente padrão. Aprova automaticamente edições de ficheiros no diretório de trabalho; pergunta para todo o resto, incluindo comandos de shellTrabalho diário; refatorizações delimitadas
smart-approveClassifica cada chamada de ferramenta: executa as que considera seguras, pergunta pelas arriscadasTrabalho diário com menos interrupções
auto-approveAprova tudo, incluindo comandos de shellApenas em ambientes isolados e de confiança
leanAgente especializado para o assistente de provas Lean 4, instalado via /leanstall. No Vibe 3.0.4, apenas aceita um modelo, o Leanstral 1.5 (labs-leanstral-1-5), que a tabela de modelos da Mistral lista como descontinuado a 30 de setembro de 2026, sem substitutoProvas formais, caso um modelo Leanstral volte a estar disponível

ask: O Mais Cauto

Cada ferramenta requer a sua validação: leitura e escrita de ficheiros, e comandos. Esta é a escolha segura para pegar num repositório escrito por outra pessoa ou para trabalhar com código sensível. Mantém o controlo total, ao custo de um ritmo mais lento.

accept-edits: A Definição Padrão

Este é o agente ativo quando executa vibe sem opções. Modifica ficheiros no diretório de trabalho sem perguntar, mas consulta-o antes de executar um comando de shell ou realizar uma ação sensível. Independentemente do agente (a menos que use aprovação automática total), o Vibe também pergunta antes de qualquer ferramenta ler, escrever ou executar algo fora do diretório de trabalho, e antes de ler ou modificar ficheiros .env ou .envrc.

smart-approve: Triagem Automática

Muitos pedidos de aprovação envolvem ações que teria aceite de qualquer forma. O smart-approve aplica primeiro as suas regras de permissão e reutiliza aprovações já concedidas na sessão. Depois, utiliza um modelo para classificar cada chamada: o que julga seguro é executado imediatamente; o que julga arriscado é submetido à sua apreciação. A documentação é clara sobre a sua limitação: é um classificador, não uma sandbox. Uma chamada considerada segura executa com os mesmos direitos que a sua conta de utilizador. Para código não confiável ou segredos, mantenha-se no ask ou num ambiente isolado.

auto-approve: Autonomia Total

Tudo é executado sem confirmação, incluindo rm -rf em qualquer caminho que o Vibe consiga alcançar. Reserve isto para ambientes descartáveis: contentores, máquinas virtuais ou ramos efémeros em integração contínua. Um administrador pode desativá-lo para toda a organização (enable_auto_approve = false).

Escolher e Alternar Agentes

vibe --agent ask            # no arranque
vibe --agent smart-approve  # ou vibe --smart-approve

Numa sessão interativa, Shift+Tab alterna entre agentes sem sair do Vibe. Para mudar o agente padrão, adicione uma linha ao config.toml:

default_agent = "ask"

Esta definição também se aplica ao modo programático (vibe --prompt …). Tenha cuidado com este modo: não há ninguém para responder a um pedido de aprovação, por isso o Vibe recusa qualquer chamada de ferramenta que exija uma. Para execução não supervisionada, passe --auto-approve (alias --yolo), e apenas num ambiente isolado.

E o Modo “Plan”?

O Vibe não tem um agente integrado plan. Se a sua configuração contiver default_agent = "plan" sem um agente personalizado com esse nome, o Vibe exibe um aviso e inicia com ask. No entanto, o fluxo de trabalho “explorar e planear, depois executar” continua a ser excelente: a documentação mostra como criar o seu próprio agente plan só de leitura, o que a próxima lição aborda.

Subagentes

Um agente também pode delegar parte do trabalho a subagentes, por exemplo, para explorar um grande repositório sem encher o seu próprio contexto. Sem um subagente personalizado, pode lançar um subagente genérico com as mesmas instruções e ferramentas que ele próprio. Não seleciona subagentes com --agent: é o agente que os lança (Lição 5).

Instruções do Projeto: AGENTS.md

Independentemente do agente, o Vibe carrega ficheiros AGENTS.md: primeiro do seu diretório Vibe (~/.vibe/AGENTS.md), depois do projeto, começando no diretório de trabalho até à raiz da pasta de confiança. Em caso de conflito, o ficheiro mais próximo do diretório de trabalho prevalece. Este é o local para convenções que se aplicam a todos os agentes: comandos de teste, guias de estilo e ficheiros que nunca devem ser tocados.

Pontos-chave

  • Agentes integrados: ask, accept-edits (padrão), smart-approve, auto-approve e lean (instalável, mas sem modelo desde que o Leanstral 1.5 foi descontinuado a 30 de setembro de 2026)
  • smart-approve reduz interrupções, mas permanece um classificador, não uma sandbox
  • Use Shift+Tab para alternar agentes numa sessão; defina default_agent para o padrão
  • No modo programático, qualquer chamada que exija aprovação é recusada, a menos que --auto-approve seja usado
  • Já não existe um agente integrado plan: crie o seu próprio (Lição 2)