# Checkpoints, versões e restauração

Entenda como cada execução do agente vira uma versão do projeto, onde ver as versões e o que significa restaurar um checkpoint antes de precisar dele.

Fonte: https://guides.adapta.org/guias/skip/recursos-do-skip/checkpoints/

**TL;DR** · Cada execução do agente no modo Agent gera uma **versão** numerada do projeto (0.0.1, 0.0.2...), e cada mensagem sua no chat carrega um **checkpoint**, o estado do projeto antes daquele pedido. As versões ficam visíveis no rodapé das respostas, em **Inspetor de Build > Versionamento** e em **Configurações e Estatísticas > Visão Geral**. O link **restaurar checkpoint** de uma mensagem é o caminho para voltar; use-o com a versão ativa anotada.

![Gravação do Skip: no builder, o Inspetor de Build abre na Visão geral, passa pelas abas PM, Dev e Q.A. e chega em Versionamento, onde a versão 0.0.1 aparece com o botão Preview e o selo Ativa.](https://guides.adapta.org/media/screenshots/skip/checkpoints-2026-09-21/skip-checkpoints-v2.gif)

*Tudo o que diz respeito a versões mora no Inspetor de Build; o checkpoint, esse fica na sua mensagem, no chat.*

## Versão e checkpoint não são a mesma coisa

- **Versão** é o resultado de uma execução concluída: o rodapé da resposta mostra "Concluído - Versão 0.0.1", e o **Inspetor de Build** lista cada execução como um cartão em **Execuções**, com o número da versão, o estado (**Concluída**), o resultado (**Sucesso**), data e hora e um botão **Preview**.

- **Checkpoint** é o marco associado a cada mensagem sua: logo abaixo do texto do pedido aparece o link **restaurar checkpoint**, junto do horário. Ele representa o projeto como estava antes de aquele pedido ser executado.

Na prática, cada pedido cria um checkpoint (antes) e, se for executado, uma versão (depois).

## Onde ver as versões

|  Lugar |  O que mostra |
| --- | --- |

|  Rodapé de cada resposta do agente |  O estado da execução e a versão gerada ("Concluído - Versão 0.0.1") |

|  **Inspetor de Build > Execuções** |  Um cartão por execução com versão, estado, resultado, data e hora e **Preview** |

|  **Inspetor de Build > Versionamento** |  **Gerenciar versões**: número, código curto de identificação, **Preview** e o selo **Ativa** na versão vigente |

|  **Configurações e Estatísticas > Visão Geral** |  **Versão** atual e **Edições Realizadas** (quantas execuções o projeto já teve) |

|  **Gerenciar organização > Plano e Uso** |  Se o seu plano inclui **Checkpoints** entre os recursos |

Cada versão tem o botão **Preview**, o caminho para olhar aquela versão antes de decidir voltar.

## Antes de restaurar

1. **Anote a versão ativa**

    Abra **Inspetor de Build > Versionamento** e registre qual versão tem o selo **Ativa** e o código dela. É o seu ponto de retorno se a restauração não for o que você esperava.

![Aba Versionamento do Inspetor de Build do Skip, com a lista Gerenciar versões mostrando a versão 0.0.1, o código curto cd64dbd, o botão Preview e o selo Ativa.](https://guides.adapta.org/media/screenshots/skip/checkpoints-2026-09-21/versionamento-2026-09-21.png)

    *Em Gerenciar versões: **1** o número e o código curto, que é o que você anota, **2** Preview, para olhar sem trocar nada, e **3** o selo Ativa, que marca a versão vigente no builder.*

2. **Encontre a mensagem certa**

    No chat, role até o pedido a partir do qual as coisas saíram do rumo. O checkpoint dessa mensagem representa o projeto antes dela; para desfazer o efeito de um pedido, o checkpoint é o dele mesmo, não o do pedido seguinte.

![Mensagem do usuário no chat do builder do Skip, com o link restaurar checkpoint e o horário logo abaixo do texto do pedido.](https://guides.adapta.org/media/screenshots/skip/checkpoints-2026-09-21/chat-checkpoint-2026-09-21.png)

    *O link fica colado na sua mensagem, com o horário ao lado: **1** é o checkpoint daquele pedido, o projeto como estava antes de ele rodar.*

3. **Compare pelo Preview**

    Se houver dúvida entre duas versões, abra o **Preview** de cada uma no Inspetor antes de restaurar.

![Painel Execuções do Inspetor de Build do Skip com o cartão da execução v0.0.1, os selos Concluída e Sucesso, a data e hora e o botão Preview, ao lado das abas do Inspetor.](https://guides.adapta.org/media/screenshots/skip/checkpoints-2026-09-21/execucoes-2026-09-21.png)

    *No cartão da execução: **1** a versão com o estado e o resultado, **2** a data, a hora e o Preview daquela execução, e **3** as abas do Inspetor, onde Versionamento fica ao lado de Q.A. e Dev.*

4. **Restaure e confira**

    Clique em **restaurar checkpoint** na mensagem escolhida e confira no **Inspetor de Build** qual versão ficou **Ativa** e o que o preview mostra.

![Menu ao lado do botão Publicar no builder do Skip, com Visualizar Produção apagado e Visualizar Preview disponível.](https://guides.adapta.org/media/screenshots/skip/checkpoints-2026-09-21/visualizar-producao-2026-09-21.png)

    *No menu ao lado de Publicar: **1** Visualizar Produção aparece apagado enquanto o projeto não foi publicado e **2** Visualizar Preview continua disponível. Restaurar mexe no preview; o que está no ar só muda quando você publica.*

    Dados gravados no Skip Cloud (cadastros feitos pelo app) são registros do banco, não do código: confira as coleções depois de restaurar ([Skip Cloud, banco de dados e login](https://guides.adapta.org/guias/skip/recursos-do-skip/skip-cloud/)).

Restaurar e publicar são ações separadas. A versão **Ativa** do Inspetor é a do builder; o que está no ar você confere em **Visualizar Produção**, no menu ao lado de **Publicar**. Depois de restaurar, decida se a versão restaurada deve ir para o ar ([Configurações do projeto](https://guides.adapta.org/guias/skip/recursos-do-skip/configuracoes-do-projeto/) cobre domínio e estatísticas do app publicado).

**Dica do curso:** em *Os 10 Mandamentos do Skip*, Romário Melo ensina a ler cada versão pelo que o PM interpretou, pelos arquivos alterados e pelos testes de QA, e diferencia dois gestos: **Restaurar**, que ele descreve como uma prévia da versão antiga, e **Reverter**, definitivo, que apaga a versão atual e as posteriores. Confira os rótulos na sua tela antes de agir; se a opção for definitiva, anote a versão ativa e faça o download do código antes ([GitHub e exportação de código](https://guides.adapta.org/guias/skip/recursos-do-skip/exportar-codigo/)).

## O que conferir

- **Pedidos pequenos, retornos fáceis:** uma mudança por pedido deixa cada checkpoint com um significado claro ([Chat com o agente e modos de execução](https://guides.adapta.org/guias/skip/recursos-do-skip/chat-do-agente/)).

- **Custo:** leia o contador de créditos da primeira resposta depois da restauração; o saldo da organização está em [Créditos e plano](https://guides.adapta.org/guias/skip/conta-e-organizacao/creditos/).

- **Erros após restaurar:** abra o **Bug Scanner** e a aba **Q.A.** do Inspetor antes de pedir nova correção ([Inspetor de Build e Bug Scanner](https://guides.adapta.org/guias/skip/recursos-do-skip/diagnostico/)).