# Resolver dificuldades no Skip

Encontre a causa quando o app quebra, o agente entrega algo diferente, a execução trava ou os créditos acabam, e saiba o que checar antes de pedir ajuda.

Fonte: https://guides.adapta.org/guias/skip/ajuda-e-novidades/solucao-de-problemas/

**TL;DR** · Antes de pedir uma correção ao agente, descubra onde o problema está: o **Bug Scanner** mostra erros do app em uso, a aba **Q.A.** do **Inspetor de Build** mostra o que a verificação de qualidade encontrou, a aba **PM** mostra o que o agente entendeu e **Skip Cloud > Logs** mostra as chamadas ao banco. Com a evidência em mãos, faça um pedido específico e repita o teste depois da correção. O número de tentativas e o consumo de créditos podem variar.

## Encontre o problema pelo sintoma

|  Sintoma |  Onde olhar |  O que fazer |
| --- | --- | --- |

|  Uma tela quebra ou um botão não responde |  **Bug Scanner** > **Erros Críticos** e **Console** |  Reproduza a ação no preview com o painel aberto e copie a mensagem de erro para o pedido |

|  Os dados não aparecem ou não salvam |  **Skip Cloud > Coleções** (aba **Dados**) e **Logs** |  Confira se o registro entrou na coleção e se a requisição retornou um código de sucesso; revise as **Regras** da coleção |

|  O resultado é diferente do que você pediu |  **Inspetor de Build > PM** |  Compare a especificação com o pedido; cite o item exato no próximo pedido |

|  A execução parou ou falhou |  **Inspetor de Build > Visão geral** e **Q.A.** |  Veja em qual fase a linha do tempo parou e qual grupo de erros acusou problema |

|  O agente está indo por um caminho errado |  Botão **Parar o agente** no chat |  Interrompa, reescreva o pedido com restrição e envie de novo |

|  Uma versão recente piorou o app |  Link **restaurar checkpoint** e **Inspetor > Versionamento** |  Volte ao ponto anterior com a versão ativa anotada ([Checkpoints, versões e restauração](https://guides.adapta.org/guias/skip/recursos-do-skip/checkpoints/)) |

|  O app publicado não reflete a mudança |  Seta de **Publicar** > **Visualizar Produção** |  Publique de novo depois de conferir a versão ativa ([Publicação, domínio e selo](https://guides.adapta.org/guias/skip/recursos-do-skip/publicacao/)) |

|  Não consigo convidar alguém |  Aviso de limite em **Membros** e **Convites** |  O plano atingiu o número de membros; fale com o consultor ([Organização, membros e convites](https://guides.adapta.org/guias/skip/conta-e-organizacao/organizacao/)) |

|  Integração conectada mas falhando |  **Gerenciar organização > Integrações** |  Confira a validade do token no painel da integração e reconecte se necessário |

## Peça a correção do jeito certo

1. **Recarregue antes de concluir que é erro**

    Depois de salvar o trabalho, um recarregamento forçado do navegador (Cmd+Shift+R no Mac, Ctrl+Shift+R no Windows) pode atualizar uma tela que ficou com uma versão antiga em cache. Faça isso no preview e no link publicado antes de gastar créditos com uma correção.

![Builder do Skip com o cursor sobre o botão de recarregar o preview, ao lado da barra de rota, e o app aberto na tela de login; o recarregamento forçado do navegador (Cmd+Shift+R) vale para o link publicado.](https://guides.adapta.org/media/screenshots/skip/passos-2026-09-22/sp-recarregue-2026-09-22.png)

    *Antes de chamar de erro: **1** o botão de recarregar o preview, ao lado da rota, e **2** o app recarregado. Muita tela em branco some aqui.*

2. **Junte a evidência**

    Copie a mensagem exata do **Bug Scanner** ou do **Console**, anote a rota do app (o seletor de rota mostra o caminho, como `/lancar`) e o que você fez para chegar ao erro.

![Painel Bug Scanner do Skip aberto no builder, com a varredura de erros do app e a lista de ocorrências para copiar.](https://guides.adapta.org/media/screenshots/skip/passos-2026-09-22/sp-evidencia-2026-09-22.png)

    *A evidência pronta: **1** o Bug Scanner, aberto pelo botão da barra superior, e **2** a mensagem do erro, que vai copiada no pedido em vez de descrita de memória.*

3. **Descreva sintoma, lugar e resultado esperado**

    O relato tem três partes: onde, o que você fez, o que deveria ter acontecido.

````
Na página Lançar Horas, ao clicar em Salvar Lançamento com o campo
Horas em 0,5, aparece o erro X no console; o lançamento deveria ser
salvo e aparecer em Lançamentos Recentes.

````

    Troque o nome da página, a ação e a mensagem pelos seus. Se preferir entender antes de mexer, envie em **Modo de execução > Chat** e peça a análise ([Chat com o agente e modos de execução](https://guides.adapta.org/guias/skip/recursos-do-skip/chat-do-agente/)).

![Caixa Mensagem para o agente do Skip com o relato digitado: na página Lançar Horas, salvar com Horas vazio mostra NaN na lista; esperado exigir horas maior que zero e avisar.](https://guides.adapta.org/media/screenshots/skip/passos-2026-09-22/sp-descreva-2026-09-22.png)

    *O relato em três partes: **1** lugar e sintoma, com o valor errado que apareceu, e **2** o resultado esperado. Sem isso o agente adivinha.*

4. **Feche com a restrição e confira**

    Termine sempre com a restrição, na mesma mensagem:

````
Corrija apenas isso, sem alterar outras páginas nem o design.

````

    Depois da execução, repita a ação no preview com o **Bug Scanner** aberto e veja a aba **Q.A.** do Inspetor.

![Caixa Mensagem para o agente do Skip com a restrição digitada: corrigir só a validação de Horas, não alterar outras páginas nem o design, e o plano de teste no preview.](https://guides.adapta.org/media/screenshots/skip/passos-2026-09-22/sp-restricao-2026-09-22.png)

    *O fechamento: **1** a restrição, que delimita o pedido; confira também se outras partes foram alteradas, e **2** o teste que você vai fazer no preview: 0, vazio e 2,5.*

## Quando o problema é de conta ou de créditos

- **Créditos acabando:** o saldo e as saídas do período estão em **Gerenciar organização > Plano e Uso**; o custo de cada resposta aparece no rodapé dela. Use **Comprar créditos** ou fale com o consultor da conta ([Créditos e plano](https://guides.adapta.org/guias/skip/conta-e-organizacao/creditos/)).

- **Skip Cloud em beta:** o próprio Skip avisa, ao criar um projeto, que o Skip Cloud está em desenvolvimento ativo e pode apresentar instabilidades. Se uma falha parecer do backend e não do seu pedido, registre horário, projeto e mensagem antes de acionar o suporte.

- **Senha ou e-mail da conta:** troque em **Minha conta > Segurança** ([Minha conta](https://guides.adapta.org/guias/skip/conta-e-organizacao/conta/)).

## Fale com o suporte

No builder, o botão **Ajuda** abre "Precisa de ajuda?" com os três canais oficiais: a **Central de Ajuda**, o **E-mail** e o **WhatsApp** do time do Skip. Os mesmos canais ficam em **Minha conta > Ajuda**. Se você usa o Adapta One, há ainda o Expert **Skip Help (Oficial)** (botão **+** > **Experts** > aba **Adapta**), descrito como apoio para suporte e correção de erros dentro do Skip: cole a mensagem de erro e o pedido que a causou para preparar a correção antes de gastar créditos no builder. Ao escrever, informe o nome do projeto, o que você pediu ao agente, a mensagem de erro copiada e o horário, e nunca envie senhas, tokens ou dados pessoais.

A aba **PM** do Inspetor e as respostas do agente podem conter as credenciais iniciais do app. Ao mandar um print para o suporte ou para um colega, recorte essa parte ([Cuidados com dados e chaves](https://guides.adapta.org/guias/skip/conta-e-organizacao/dados/)).

**Dica do curso:** em *Os 10 Mandamentos do Skip*, Romário Melo trata erros nesta ordem: primeiro limpar o cache com recarregamento forçado (também no link publicado), depois usar o Bug Scanner e, se persistir, o modo chat com a fórmula "quando faço X aparece o erro Y; analise profundamente no código e me dê uma solução". Em *Skip na Prática*, a Adapta reforça o bug-fix específico: descrever a página, o sintoma exato e fechar com "corrija apenas isso e não altere mais nada".

## O que conferir

- **Um problema por pedido:** misturar duas correções em uma mensagem dificulta saber o que resolveu o quê.

- **Evidência antes da correção:** mensagem de erro copiada vale mais do que a descrição do sintoma.

- **Versão ativa anotada:** antes de qualquer correção grande, registre a versão em **Inspetor > Versionamento** para poder voltar.