Checkpoints: desfaça qualquer mudança feita pelo agente

Sempre que o agente da Mythex termina um turno com sucesso, ele salva um checkpoint dos arquivos do seu projeto. Se uma mudança posterior der errado, você pode voltar o projeto a qualquer um desses pontos a partir do chat, sem precisar descrever o estrago e torcer para o agente consertar. Você também pode editar uma mensagem anterior e reenviá-la, o que volta o projeto no tempo e tenta um prompt diferente a partir dali.

O que é um checkpoint

Um checkpoint é um snapshot salvo dos arquivos do projeto no fim de um turno. Por baixo dos panos, é um checkpoint do git — git sendo o sistema de controle de versão que desenvolvedores usam para rastrear cada mudança em um código. Você não precisa saber git para usar; o chat cuida disso para você.

Os checkpoints são salvos após um turno do agente bem-sucedido. Cada um fica no fim da resposta do agente que o produziu, então o histórico do chat funciona como uma linha do tempo do seu projeto: cada resposta marca um ponto para o qual você pode voltar.

Por que ajuda

Construir com um agente é iterativo. A maioria dos turnos faz o projeto avançar, mas alguns não — uma mudança de layout que quebra a visualização no celular, uma refatoração que foi mais longe do que você queria, uma funcionalidade que se revela a ideia errada.

Quando isso acontece, a tentação é pedir ao agente que conserte. Às vezes funciona. Muitas vezes ele empilha uma nova mudança sobre uma ruim, e depois outra, e cada correção torna a próxima mais difícil. Voltar ao último ponto bom costuma ser mais rápido e barato do que lutar contra erros que se acumulam. Você recomeça a partir de algo que funcionava.

Também torna mais seguro testar coisas. Se você consegue desfazer um turno em dois cliques, perguntar “e se a seção principal fosse um vídeo?” custa muito pouco.

Como voltar a um checkpoint

1. Encontre a resposta que deixou o projeto no estado para o qual você quer voltar.
2. Clique em Reverter para este ponto — o ícone de desfazer no fim da resposta, ao lado de Copiar. Em um notebook, o ícone aparece quando você passa o ponteiro sobre a resposta.
3. Confirme com Restaurar no diálogo que aparece.

Os arquivos do seu projeto voltam ao estado que tinham no fim daquele turno. Confira a prévia para ter certeza e continue a partir daí.

Editar e reenviar

Às vezes o problema não foi o resultado, e sim o prompt. Para isso existe Editar e reenviar:

1. Passe o ponteiro sobre uma das suas mensagens anteriores e clique para editá-la.
2. Reescreva o prompt do jeito como deveria ter sido escrito.
3. Confirme Descartar e reenviar.

A Mythex volta o projeto para antes daquele turno — quando existe um checkpoint — e envia seu novo prompt. É a forma mais rápida de tentar de novo um turno que foi pelo caminho errado, sem deixar no lugar as mudanças da tentativa ruim.

Checkpoints funcionam melhor com passos pequenos

Um checkpoint só consegue levar você de volta ao fim de um turno. Se um turno fez cinco coisas, você pode desfazer as cinco ou nenhuma. Esse é mais um motivo para manter cada pedido pequeno:

• Mude uma seção.
• Corrija um bug.
• Adicione uma página.

Pedidos menores significam menos surpresas e menos créditos gastos, e cada um deixa um checkpoint ao qual você pode voltar por conta própria.

Também ajuda descrever o que você vê na prévia, em vez do que acha que o código deveria fazer — por exemplo, “Na página de preços, o botão do cartão Pro está cortado no celular. Corrija o estouro e mantenha o layout do desktop.”

Para funcionalidades grandes, comece no modo Plano: o agente apresenta uma abordagem, você aprova, e então Construir executa o plano. Mais sobre isso em planeje antes de construir.

Quando voltar, e quando reconstruir

Voltar é a jogada certa quando o projeto estava em bom estado alguns turnos atrás. Uma reconstrução completa só vale a pena quando:

• Você mudou a ideia do produto por completo.
• A arquitetura está errada para os novos requisitos.
• O projeto ainda está vazio ou quase vazio.

Mesmo assim, diga o que manter — o nome, as cores da marca, o conteúdo — para não perder o que já estava certo.

Limites

• Os checkpoints são salvos após turnos bem-sucedidos, e Descartar e reenviar só consegue voltar quando existe um checkpoint.
• Reverter desfaz os arquivos do seu projeto para o estado que tinham naquele ponto.
• Um checkpoint cobre um turno inteiro. Você não pode desfazer só uma parte; turnos menores dão um controle mais fino.
• Em um notebook, o ícone de Reverter só aparece ao passar o ponteiro, então mova o cursor sobre a resposta se não estiver vendo o ícone.

Se você está trabalhando em um bug, e não desfazendo um, nosso guia sobre como depurar um app criado com IA cobre a outra metade do processo.

A documentação trata dos checkpoints em Chat e em Iterar sem reconstruir.