# Agent Mode (/pt/docs/verdent-manager/advanced-features/agent-mode)

> Execução de tarefas com agentes e total transparência em cada ação



Agent Mode é o modo de execução padrão do Verdent, no qual o agente age diretamente com base nas suas instruções. Em vez de sessões de planejamento estruturado, o Agent Mode prioriza a execução rápida mantendo total transparência.

## O que você vai aprender [#o-que-você-vai-aprender]

* Quando Agent Mode é a escolha certa
* Como funciona o fluxo de trabalho de execução
* Como gerenciar permissões e visibilidade

***

## Quando Agent Mode é útil [#quando-agent-mode-é-útil]

Agent Mode funciona melhor quando você tem clareza sobre o que precisa ser feito:

| Cenário               | Situação                                                                                           | Como o Verdent ajuda                                                                           |
| --------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Requisitos claros** | Você sabe exatamente o que quer implementar. A tarefa é bem definida, com um resultado específico. | O agente segue direto para a implementação. Sem sobrecarga de planejamento, apenas resultados. |
| **Iterações rápidas** | Você está em um ciclo rápido de feedback, fazendo mudanças incrementais com base nos resultados.   | Ciclos de execução ágeis permitem ver as mudanças imediatamente e ajustar o rumo.              |
| **Tarefas diretas**   | Correções de bugs, pequenos recursos, limpeza de código ou refatoração com escopo óbvio.           | O agente conclui o trabalho de forma eficiente, sem idas e vindas desnecessárias.              |

***

## Fluxo de trabalho do Agent Mode [#fluxo-de-trabalho-do-agent-mode]

<Steps>
  <Step title="Envie sua solicitação">
    Descreva o que você quer que seja feito. Instruções claras e específicas funcionam melhor no Agent Mode.
  </Step>

  <Step title="O agente age">
    Verdent começa a implementação imediatamente. Edições de arquivos, uso de ferramentas e progresso aparecem em tempo real.
  </Step>

  <Step title="Solicitações de permissão">
    Certas ações exigem aprovação. Revise e aprove para prosseguir.
  </Step>

  <Step title="Veja os resultados">
    O trabalho é concluído com total visibilidade sobre o que mudou e por quê.
  </Step>
</Steps>

***

## Principais características [#principais-características]

| Característica            | Descrição                                                                       |
| ------------------------- | ------------------------------------------------------------------------------- |
| **Modo padrão**           | Novas tarefas começam no Agent Mode, a menos que você mude para o Plan Mode     |
| **Ação direta**           | O agente segue para a implementação em vez de um planejamento extenso           |
| **Total visibilidade**    | Edições de arquivos, uso de ferramentas e progresso são exibidos em tempo real  |
| **Esclarecimento inline** | As perguntas aparecem naturalmente no chat, não como questionários estruturados |

***

## Agent Mode vs Plan Mode [#agent-mode-vs-plan-mode]

Escolha com base na clareza e complexidade da tarefa:

<Tabs>
  <Tab title="Use Agent Mode quando">
    Agent Mode é ideal para:

    * Requisitos claros e bem definidos
    * Tarefas de implementação diretas
    * Iterações rápidas e ciclos de feedback
    * Tarefas em que você tem confiança na abordagem
    * Correções de bugs e pequenos recursos
  </Tab>

  <Tab title="Use Plan Mode quando">
    Mude para o Plan Mode para:

    * Recursos complexos de várias etapas
    * Ideias incompletas ou em evolução
    * Decisões de arquitetura
    * Tarefas que exigem exploração antes da implementação
    * Quando você quer esclarecer requisitos de forma estruturada
  </Tab>
</Tabs>

***

## Permissões no Agent Mode [#permissões-no-agent-mode]

Agent Mode executa tarefas diretamente, mas certas ações ainda exigem aprovação explícita:

* Modificações de arquivos fora do escopo esperado
* Operações destrutivas
* Certas execuções de ferramentas
* Ações com efeitos colaterais significativos

<Note>
  As solicitações de permissão protegem contra mudanças não intencionais, mantendo a velocidade de execução nas operações de rotina.
</Note>

***

## Perguntas frequentes [#perguntas-frequentes]

<AccordionGroup>
  <Accordion title="O Agent Mode é o padrão?">
    Sim. Novas tarefas começam no Agent Mode. Mude para o Plan Mode quando precisar de planejamento estruturado.
  </Accordion>

  <Accordion title="O agente fará perguntas no Agent Mode?">
    Sim, quando necessário. As perguntas aparecem inline no chat, em vez de como questionários estruturados. O agente pode prosseguir sem perguntar se a tarefa estiver suficientemente clara.
  </Accordion>

  <Accordion title="Como faço para mudar para o Plan Mode?">
    Pressione `Shift+Tab` (macOS: `Cmd+.`; Windows: `Ctrl+.`) para alternar entre os modos. A troca de modo está disponível em certos pontos, não durante a execução ativa.
  </Accordion>

  <Accordion title="O Agent Mode pula todas as confirmações?">
    Não. Certas ações ainda exigem aprovação. Agent Mode reduz o atrito nas operações de rotina, mantendo a segurança para mudanças significativas.
  </Accordion>

  <Accordion title="Quando devo usar o Plan Mode em vez disso?">
    Use o Plan Mode para recursos complexos, decisões de arquitetura ou quando quiser explorar e refinar requisitos antes de iniciar a implementação.
  </Accordion>
</AccordionGroup>