> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Modos

O Macaly tem três modos que definem como o agente trata os seus pedidos. Cada modo muda o momento em que o agente cria planos e faz perguntas, dando a você mais velocidade ou mais visibilidade.

Você pode alternar entre os modos a qualquer momento pelo seletor de modo no chat, bem ao lado de onde você digita a mensagem. O modo ideal depende do que você está criando e de quanto controle quer ter sobre o processo.

<img src="https://mintcdn.com/macaly-41b1d3e9/klfbwgQaYrAYi4Bk/images/Execution%20modes.png?fit=max&auto=format&n=klfbwgQaYrAYi4Bk&q=85&s=0a2b6b7f4724bc81da726b595cbafb4d" alt="Modos de execução" width="2880" height="1324" data-path="images/Execution modes.png" />

## Auto (padrão)

No modo Auto, o agente decide quando planejar e quando construir diretamente.

Em pedidos simples, o agente constrói na hora. Em pedidos complexos ou pouco claros, ele cria um plano antes ou faz perguntas para esclarecer.

É o modo padrão porque equilibra velocidade e visibilidade. Você recebe resultados rápidos quando faz sentido, e o agente desacelera para consultar você quando precisa.

**Use o Auto quando:**

* Você trabalha com uma mistura de tarefas simples e complexas
* Você quer que o agente use o próprio critério
* Você não sabe qual modo combina com o seu pedido

## Planejar primeiro

No modo Planejar primeiro, o agente sempre cria um plano antes de construir qualquer coisa.

Ative-o pelo seletor de modo ao lado da caixa de mensagem. O agente divide o seu pedido em etapas, faz as perguntas necessárias, mostra a abordagem e espera a sua aprovação. Nenhum código é escrito até você revisar e confirmar o plano.

Quando o plano estiver pronto, o Macaly pergunta **Começar a criar?** Escolha **Sim** para começar. Se você escolher **Ainda não** ou fechar o plano, o agente pergunta o que você quer mudar.

Assim você enxerga tudo o que vai acontecer antes que aconteça. Dá para ver como o agente interpretou o seu pedido e ajustar a abordagem antes de o trabalho começar.

**Use o Planejar primeiro quando:**

* Você está criando um recurso complexo
* Você quer entender o que será construído
* Você quer revisar a abordagem antes de se comprometer
* Você está aprendendo como o Macaly funciona

<Frame>
  <img src="https://mintcdn.com/macaly-41b1d3e9/vqWQ6McCHb2TN9Wl/images/Questions%201.png?fit=max&auto=format&n=vqWQ6McCHb2TN9Wl&q=85&s=03d712c0bc10e3ca6cc5564d14f6952b" alt="Perguntas 1" width="2168" height="1356" data-path="images/Questions 1.png" />
</Frame>

## Criar direto

No modo Criar direto, o agente trabalha sem interrupções.

Ele não cria planos nem faz perguntas. Constrói diretamente a partir do seu pedido e adota suposições razoáveis quando algum detalhe não está claro.

**Use o Criar direto quando:**

* Você sabe exatamente o que quer
* Você está fazendo alterações simples e diretas
* Você está dando continuidade a um trabalho a partir de um plano aprovado
* Você não quer esperar por perguntas ou planos

## O que cada modo pode fazer

Nem todos os modos permitem que o agente pare para pedir a sua opinião.

| Modo | Pode fazer perguntas | Pode criar planos |
| - | - | - |
| Auto | Sim | Sim |
| Planejar primeiro | Sim | Sim (sempre) |
| Criar direto | Não | Não |

## Por que planejar ajuda

Planejar não é só uma questão de controle. O agente costuma construir melhor quando pensa na abordagem antes.

**Pegue mal-entendidos logo no início**\
Se o plano não corresponde ao que você tinha em mente, dá para corrigir na hora. Ajustar um plano é mais fácil do que desfazer um trabalho pronto.

**Veja o que vai mudar**\
Os planos explicam a abordagem em linguagem simples. Você não precisa de conhecimento técnico para entender o que vai acontecer.

**Mude a direção antes de o trabalho começar**\
Você pode comentar o plano para alterar a abordagem, acrescentar detalhes ou remover partes de que não precisa.

**Recursos complexos são os que mais se beneficiam**\
Ao adicionar recursos com várias páginas, autenticação ou banco de dados, o plano garante que vocês estejam alinhados antes de o trabalho pesado começar.

## Quando planejar não é necessário

Em pedidos simples, planejar só gera trabalho extra sem trazer valor:

* Mudar textos ou conteúdo
* Ajustar cores e estilos
* Corrigir erros óbvios
* Qualquer coisa que leve menos de três etapas

Nesses casos, Auto, Criar direto ou [Edições visuais](/docs/pt-BR/features/visual-edits) dão resultado mais rápido.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O agente travou ou está demorando demais. O que posso fazer?">
    Se o agente não mostrar progresso por mais de 10 a 15 minutos, recarregue a página. Se a visualização estiver congelada, tente **Rebuild Preview** ou **Restart App** em sua barra de ferramentas. Se a última alteração interrompeu seu projeto, use **Histórico de versões** ou **Restaurar esta versão**. Se o problema persistir, [entre em contato com o suporte](mailto:support@macaly.com) com o link do chat e o horário aproximado. Os créditos consumidos durante uma sessão travada confirmada serão revisados.
  </Accordion>

  <Accordion title="O agente continua cometendo o mesmo erro. Como evito gastar créditos à toa?">
    Ao relatar um erro, seja o mais específico possível. Descreva o que você estava fazendo antes do erro, o que vê agora, o que não está funcionando e qual deveria ser o comportamento correto. Quanto mais detalhes você der, maiores as chances de o agente corrigir na primeira tentativa.
  </Accordion>

  <Accordion title="Quantos passos o agente pode dar por pedido?">
    O Macaly tem cerca de 20 passos por pedido do usuário. Se o seu prompt for muito complexo, o agente pode não conseguir concluir tudo. Divida pedidos grandes em etapas menores e sequenciais: envie uma alteração específica por mensagem, confira se funcionou e só então siga para a próxima.
  </Accordion>

  <Accordion title="Como faço um backup do meu projeto?">
    Macaly salva versões do projeto para que você possa restaurar o código anterior. Para suas próprias cópias, use [GitHub](/docs/pt-BR/integrations/github) para código, se seu plano suportar, e **Exportar** na aba **Banco de dados** para dados de tabela. O ZIP não inclui arquivos enviados para seu aplicativo. Uma duplicata copia o projeto atual, não um estado anterior do banco de dados.
  </Accordion>

  <Accordion title="Posso restaurar uma versão anterior do meu projeto?">
    Sim. Clique no ícone de relógio na barra superior para abrir o **Histórico de versões**, escolha uma versão para ver a prévia e clique em **Restaurar**. Você também pode usar o botão **Restaurar esta versão** abaixo de qualquer resposta do agente. Nos dois casos, o código do projeto volta ao estado em que estava naquele momento. Veja [Histórico de versões](/docs/pt-BR/chat/overview#histórico-de-versões). Isso restaura apenas o código, não os dados do banco de dados ou arquivos carregados no seu aplicativo. Publique novamente para atualizar seu site ativo.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.