> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/skip/comece-aqui/inspetor-de-build.md). # Inspetor de Build O **Inspetor de Build** mostra em detalhe o que acontece em cada execução (build) do Skip. É a ferramenta ideal quando você quer entender **por que uma execução falhou**, **o que a IA planejou e revisou**, ou quando precisa **comparar versões** antes de restaurar ou reverter. É uma ferramenta de nível profissional — pense nela como o "raio-X" do que a IA fez em cada ação. ### O que é uma execução (build) Uma execução é o **pacote de trabalho completo da IA** para um pedido seu: planejar, alterar código, rodar verificações e associar o resultado a uma versão. Mesmo que uma execução falhe no meio do caminho, ela fica registrada no histórico para consulta. Detalhes gerais sobre versões e checkpoints estão em **Versões, Builds e Checkpoints**. ### Como abrir o Inspetor de Build No editor, localize a barra da **área de pré-visualização**. Há um atalho — geralmente um ícone de lupa com código — que abre: * O inspetor da **execução atual**, ou * A navegação por **execuções anteriores**. {% hint style="info" %} O ícone pode ficar **desabilitado** enquanto não houver URL de preview ou enquanto um build estiver em execução. Espere o preview estar pronto. {% endhint %} ### Abas do Inspetor O Inspetor organiza as informações em abas, cada uma respondendo uma pergunta diferente sobre a execução: #### Visão Geral Resumo da execução: * **Status:** sucesso, falha, em andamento. * **Versão associada** à execução. * **Tempo decorrido** até a conclusão. * **Pedido original** que disparou a execução (o seu prompt). É o primeiro lugar para quando você quer entender o contexto geral de um build. #### PM (Product Manager) Traz a **leitura e o planejamento de produto** da IA: * Como ela **interpretou** o seu pedido. * O que **decidiu fazer**. * Quais **partes do projeto** decidiu tocar. Se o resultado final não foi o que você esperava, comece a investigar **aqui**: muitas vezes o problema não é técnico, é de interpretação do prompt. #### Dev Mostra o que foi efetivamente **alterado no código**: * **Arquivos tocados** na execução. * **Trechos criados ou modificados**. É a visão mais próxima do que um desenvolvedor veria em um *code review* tradicional. #### Q.A. **Resultado das verificações automáticas** da IA. Se uma execução falhou, esta aba geralmente contém a **pista mais útil** sobre onde o erro ocorreu e por que o Skip não conseguiu concluir o pedido. #### Versionamento Como esta execução se relaciona com as versões anteriores e posteriores. É o **ponto de partida** para operações de **Restaurar** e **Reverter** (veja **Versões, Builds e Checkpoints** para entender a diferença crítica entre as duas ações). #### Histórico de Eventos **Linha do tempo completa** dos eventos da execução: * Início da execução. * Cada decisão do agente. * Arquivos criados ou modificados. * Chamadas a ferramentas externas. * Erros encontrados. * Conclusão. É o log mais granular disponível. Útil quando nenhuma outra aba esclarece o que aconteceu. ### Checkpoints e "versão atual" Dentro do Inspetor você também vê **qual versão é a "atual"** (a que o editor está usando e a que aparece no preview) e pode agir sobre os checkpoints relacionados a ela. ### Dicas práticas * **Antes de pedir ajuda** no chat ou abrir um ticket de suporte, abra a aba **Q.A.** ou **Histórico de Eventos** — na maioria das vezes o erro está explicado ali, e você pode resolver sozinho. * **Se uma execução falhou**, compare **PM** e **Dev**: muitas vezes o planejamento estava certo, mas houve erro ao aplicar o código. Isso ajuda a decidir se vale reverter ou apenas refazer o pedido com uma redação diferente. * **Copie mensagens de erro** direto daqui e cole no chat em Modo Chat para pedir correção com o contexto exato. ### Quando usar o Inspetor de Build | Situação | Onde olhar | | -------------------------------------- | --------------------------------------- | | Quero entender por que um build falhou | Aba **Q.A.** → **Histórico de Eventos** | | Quero ver o que a IA mudou no código | Aba **Dev** | | A IA interpretou meu prompt diferente | Aba **PM** | | Quero voltar para uma versão anterior | Aba **Versionamento** | | Preciso de um log completo da execução | Aba **Histórico de Eventos** | ### Links relacionados * **Versões, Builds e Checkpoints** — conceitos gerais. * **Bug Scanner** — erros na pré-visualização (complementar ao Inspetor). * **Diagnóstico e Resolução de Erros** — guia completo de troubleshooting. {% hint style="success" %} **Próximo passo:** Conheça o [**Bug Scanner**](/skip/comece-aqui/ferramentas-de-diagnostico-bug-scanner.md), a ferramenta que acompanha o que está acontecendo *dentro* da sua pré-visualização em tempo real. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.adapta.org/skip/comece-aqui/inspetor-de-build.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.