Checkpoints: Desfaz Qualquer Alteração Feita pelo Agente

Sempre que o agente da Mythex termina um turno com sucesso, guarda um checkpoint dos ficheiros do teu projeto. Se uma alteração posterior correr mal, podes repor o projeto em qualquer um desses pontos a partir do chat, sem teres de descrever o estrago e esperar que o agente o repare. Também podes editar uma mensagem anterior e reenviá-la, o que rebobina o projeto e tenta um prompt diferente a partir daí.

O que é um checkpoint

Um checkpoint é um instantâneo guardado dos ficheiros do projeto no fim de um turno. Por baixo, é um checkpoint git, sendo o git o sistema de controlo de versões que os programadores usam para registar cada alteração a uma base de código. Não precisas de saber git para o usar; o chat trata disso por ti.

Os checkpoints são guardados depois de um turno do agente bem-sucedido. Cada um fica no fim da resposta do agente que o produziu, por isso o histórico do chat funciona como uma linha do tempo do projeto: cada resposta marca um ponto para o qual podes voltar.

Porque ajuda

Construir com um agente é iterativo. A maioria dos turnos faz o projeto avançar, mas alguns não: uma alteração de layout que estraga a vista de telemóvel, uma refatorização que vai mais longe do que querias, uma funcionalidade que se revela a ideia errada.

Quando isso acontece, a tentação é pedir ao agente para corrigir. Às vezes resulta. Muitas vezes acrescenta uma alteração nova em cima de uma má, e depois outra, e cada correção torna a seguinte mais difícil. Voltar ao último ponto bom costuma ser mais rápido e mais barato do que lutar contra erros que se acumulam. Recomeças a partir de algo que funcionava.

Também torna mais seguro experimentar. Se consegues desfazer um turno em dois cliques, perguntar "e se a secção principal fosse um vídeo?" custa-te muito pouco.

Como voltar a um checkpoint

1. Encontra a resposta que deixou o projeto no estado para onde queres voltar.
2. Clica em Reverter para este ponto, o ícone de desfazer no fim da resposta, ao lado de Copiar. Num portátil, o ícone aparece quando passas o cursor sobre a resposta.
3. Confirma com Restaurar no diálogo que aparece.

Os ficheiros do teu projeto voltam ao estado em que estavam no fim desse turno. Verifica a pré-visualização para confirmar e continua a partir daí.

Editar e reenviar

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

1. Passa o cursor sobre uma das tuas mensagens anteriores e clica para a editar.
2. Reescreve o prompt da forma como devias ter formulado.
3. Confirma Descartar e reenviar.

A Mythex rebobina o projeto para antes desse turno, quando existe um checkpoint, e envia o teu novo prompt. É a forma mais rápida de repetir um turno que foi na direção errada, sem deixar as alterações da tentativa má no lugar.

Os checkpoints funcionam melhor com passos pequenos

Um checkpoint só te pode levar de volta ao fim de um turno. Se um turno fez cinco coisas, podes desfazer as cinco ou nenhuma. É mais uma razão para manteres cada pedido pequeno:

• Altera uma secção.
• Corrige um erro.
• Acrescenta uma página.

Pedidos mais pequenos trazem menos surpresas e gastam menos créditos, e cada um deixa um checkpoint para o qual podes voltar sozinho.

Ajuda também descrever o que vês na pré-visualização, em vez do que achas que o código devia fazer. Por exemplo: "Na página de preços, o botão do cartão Pro fica cortado no telemóvel. Corrige o transbordo e mantém o layout de computador."

Para funcionalidades grandes, começa no modo Plano: o agente define uma abordagem, aprovas e depois o modo Construir executa-a por etapas. Mais sobre isso em planear antes de construir.

Quando reverter e quando reconstruir

Reverter é a escolha certa quando o projeto estava num bom estado há alguns turnos. Uma reconstrução completa só compensa quando:

• Mudaste completamente a ideia do produto.
• A arquitetura está errada para os novos requisitos.
• O projeto ainda está vazio ou quase vazio.

Mesmo nesses casos, diz o que deve manter-se, como o nome, as cores da marca e o conteúdo, para não perderes o que já estava certo.

Limites

• Os checkpoints são guardados depois de turnos bem-sucedidos, e Descartar e reenviar só consegue rebobinar quando existe um checkpoint.
• Reverter repõe os ficheiros do projeto tal como estavam nesse ponto.
• Um checkpoint cobre um turno inteiro. Não podes desfazer apenas parte de um; turnos mais pequenos dão-te um controlo mais fino.
• Num portátil, o ícone de Reverter só aparece ao passar o cursor, por isso move o ponteiro sobre a resposta se não o vires.

Se estás a trabalhar num erro em vez de o desfazer, o nosso guia sobre como depurar uma app criada com IA cobre a outra metade do processo.

A documentação explica os checkpoints em Chat e em Iterar sem reconstruir.