---
title: Agent Mode
description: "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

- 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

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

<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

| 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

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

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

<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>