Inspetor de Build e Bug Scanner
Veja o que o agente entendeu, quais arquivos criou, o que os testes encontraram e quais erros o app gerou, sem gastar créditos com perguntas.
As duas ferramentas lado a lado: o Inspetor conta o que o agente fez, o Bug Scanner conta o que o app está fazendo agora.
Inspetor de Build
Na barra superior do builder, clique em Inspetor de Build. O painel abre com a coluna Execuções à esquerda, um cartão por execução do agente com a versão gerada, o estado (Concluída), o resultado (Sucesso), a data e a hora e um botão Preview. O botão Esconder painel recolhe essa coluna. À direita ficam as seis abas da execução selecionada.
Visão geral
Quatro números resumem a execução: Status, Origem (Skip), Linhas e Arquivos. Abaixo, a linha do tempo com horário de cada fase: Planejamento inicial de tarefas, Especificando solução, Preparando projeto, Implementando solução, Testando solução, Versionando projeto, Deployando solução e Gerando relatório. É aqui que você vê quanto tempo cada fase levou e em qual delas uma execução parou.
PM
Especificação (PM) é o seu pedido reescrito como documento de requisitos, em inglês: uma descrição geral, a pilha usada e os Functional Requirements numerados, tela por tela, com campos, textos, validações, rotas, esquema do banco e dados de exemplo. Leia esta aba quando o resultado não bater com o que você pediu: procure a diferença primeiro na especificação, e cite o item exato no próximo pedido.
A especificação inclui as credenciais do usuário inicial quando o agente cria login. Não compartilhe prints desta aba.
Dev
A árvore de arquivos do projeto, com a etiqueta ADD nos arquivos criados naquela execução, organizada em pastas (migrações do banco, componentes, contextos, hooks, páginas, serviços, tipos). Clique em um arquivo para ver o conteúdo; até lá, a área da direita pede para selecionar um arquivo na árvore.
Q.A.
Último resultado separa o que a verificação de qualidade encontrou em quatro grupos: Erros de Setup, Erros de Análise Estática, Erros de Servidor e Erros de Cliente. Cada grupo mostra "Sem erros." quando passou. Resultados anteriores guarda as rodadas anteriores, numeradas (Teste #1 em diante), útil para ver se uma correção resolveu um erro que existia antes.
Versionamento
Gerenciar versões lista as versões do projeto com o número (0.0.1, 0.0.2...), um código curto de identificação, o botão Preview e o selo Ativa na versão que está valendo.
Histórico de Eventos
A lista técnica dos eventos internos da execução, em ordem: especificação, definição de arquitetura, escrita de código, verificação de qualidade, versionamento e geração do relatório. Serve para quem quer conferir a sequência exata; para o dia a dia, a linha do tempo da Visão geral basta.
Bug Scanner
O botão Abrir Bug Scanner, o ícone de lupa na barra superior, abre um painel sobre o preview com quatro abas que observam o app em execução:
| Aba | O que mostra | Quando está vazia |
|---|---|---|
| Erros Críticos | Falhas que quebram uma tela ou uma ação | "Nenhum erro crítico detectado" |
| Requisições | Chamadas que o app fez ao backend | "Nenhuma requisição detectada" |
| Console | Mensagens de log e erro do navegador | "Nenhum log detectado" |
| Navegação | Trocas de rota dentro do app | "Nenhuma navegação detectada" |
Use o preview com o Bug Scanner aberto: entre no app, repita a ação que falhou e volte às abas. O mesmo botão vira Fechar Bug Scanner enquanto o painel está aberto.
Como usar as duas juntas
Algo saiu diferente do pedido
Abra o Inspetor de Build, aba PM, e procure o item da especificação que descreve aquela tela. Se a especificação já estava diferente do que você queria, o próximo pedido deve corrigir o entendimento ("na página X, o campo Y deve...").
Na aba PM: 1 a aba selecionada, 2 o rótulo Especificação (PM) e 3 o texto que o agente escreveu antes de programar. É aqui que se descobre se o erro começou no entendimento.
Algo dá erro ao usar
Abra o Bug Scanner, reproduza o erro no preview e leia Erros Críticos e Console. Copie a mensagem de erro para o pedido de correção; ela vale mais do que descrever o sintoma.
No Bug Scanner: 1 as quatro abas, sendo Erros Críticos e Console as que interessam primeiro, e 2 o estado vazio. Sem erro registrado não quer dizer app correto: quer dizer que nada quebrou enquanto ele estava aberto.
Uma execução travou ou falhou
Na Visão geral, veja em qual fase a linha do tempo parou e confira a aba Q.A.: um grupo com erro aponta o tipo de problema (configuração, código, servidor ou cliente).
Na Visão geral: 1 o resumo da execução, com estado e quantos arquivos saíram, e 2 a linha do tempo. A fase em que ela para é o que diz onde procurar.
Antes de publicar
Confira em Versionamento qual versão está Ativa e em Q.A. se o último resultado passou sem erros.
Na aba Q.A.: 1 a aba, 2 o último resultado, 3 os quatro grupos que separam o tipo de problema e 4 os resultados anteriores, que permitem comparar execuções em vez de olhar só a última.
O que conferir
- Prints do Inspetor: a aba PM expõe credenciais iniciais; recorte antes de compartilhar (veja Cuidados com dados e chaves).
- Erros persistentes: se o Bug Scanner segue mostrando o mesmo erro depois de uma correção, cite a mensagem exata no pedido seguinte e uma mudança por vez (Como pedir à IA).
- Versão publicada: o que está no ar depende de Publicar; a versão Ativa do Inspetor é a do builder.