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.
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
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.
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.
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.
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.
Compare pelo Preview
Se houver dúvida entre duas versões, abra o Preview de cada uma no Inspetor antes de restaurar.
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.
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.
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).
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).
- 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.
- 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).