> 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/ferramentas-de-diagnostico-bug-scanner.md).

# Ferramentas de Diagnóstico (Bug Scanner)

O Bug Scanner é o seu assistente gratuito para encontrar erros na pré-visualização antes de publicar o app.

O **Bug Scanner** é a ferramenta do editor que mostra o que acontece **dentro da janela de pré-visualização** do seu app: mensagens do console, erros de página, requisições de rede e navegação. Ele ajuda você a entender **por que algo quebrou** antes de pedir correção no chat — economizando créditos e tempo.

### Onde fica e quando está disponível

O botão do Bug Scanner fica na **barra da área de pré-visualização**, ao lado dos controles de desktop / mobile. O ícone lembra uma **lupa com código** 🔍.

{% hint style="info" %}
O botão pode ficar **desabilitado** enquanto não há URL de preview ou enquanto um build está em execução. Espere a pré-visualização ficar pronta para usar a ferramenta.
{% endhint %}

Se houver **erros críticos detectados**, um **contador** pode aparecer no botão para chamar sua atenção.

Ao abrir, o painel organiza a informação em abas (Console, Erros da pré-visualização, Rede, Navegação).

### O que o Bug Scanner **é**

* Um **diagnóstico** da pré-visualização: o que o seu app está fazendo enquanto você desenvolve.
* Uma forma de **copiar detalhes** de erros rapidamente.
* Uma interface para usar ações como **"tentar corrigir"** ou **"inspecionar"** em um erro específico, quando a interface oferecer esses botões.

### O que o Bug Scanner **não é**

* **Não é um substituto** para testes de QA manuais no app publicado.
* **Não detecta todos os problemas** — regras de negócio erradas, por exemplo, não aparecem ali (o app pode estar "funcionando" tecnicamente, mas fazendo a conta errada).
* **Não é monitoramento de produção** — serve apenas para o que está rodando no preview do editor.

### Tipos de informação

#### 📋 Console

**Mensagens técnicas do navegador.** Útil para identificar:

* Erros de lógica visual.
* Travamentos na interface.
* Avisos (*warnings*) que indicam problemas sutis.

#### ⚠️ Erros da Pré-visualização

**Problemas detectados pela própria pré-visualização**:

* Páginas que não carregam.
* Erros de renderização.
* Componentes que quebraram.

#### 🌐 Rede (Requisições)

**Lista de chamadas a APIs** feitas pelo app. Procure **linhas vermelhas** com status:

* **400** → pedido malformado.
* **401** → autenticação inválida (API Key errada ou expirada).
* **500** → erro no servidor remoto.

**Sub-aba Preview / Response:** Ao clicar em uma requisição com erro, aparece a **mensagem real retornada pelo servidor** (ex.: `"model not found"`, `"invalid API key"`). Essa mensagem é ouro puro na hora de pedir correção.

#### 🗺️ Navegação

**Histórico das páginas** que o app carregou durante a sessão de preview. Útil para entender **redirecionamentos inesperados** e fluxos que não se comportaram como você esperava.

### Como usar no dia a dia

Um fluxo simples e eficaz:

1. Seu app "quebra" ou se comporta de forma estranha na pré-visualização.
2. **Abra o Bug Scanner.**
3. Veja qual aba mostra algo relevante (**Console** costuma ser o primeiro lugar a olhar).
4. **Copie a mensagem de erro** específica.
5. Volte ao chat (ideal em Modo Chat, que custa menos) e peça a correção **já com a mensagem em mãos**.

### Boa prática antes de pedir ajuda ao chat**Sempre que possível**, abra o Bug Scanner e **copie a mensagem de erro específica** antes de acionar o chat. Isso economiza créditos — a IA não precisa descobrir o que está acontecendo, **apenas resolver**.Um prompt como *"meu app está com bug"* vai gastar créditos em diagnóstico. Um prompt como *"está retornando este erro no console: \[cole aqui]"* vai direto para a solução.

### Glossário rápido

* **Backend:** A parte que roda nos "bastidores" do app (banco de dados, regras, autenticação).
* **Deploy:** O ato de colocar ou atualizar a versão do app que as pessoas veem na internet.
* **Frontend:** A parte visual do app — o que o usuário vê e clica.
* **Console:** A "caixa de ferramentas" do navegador onde aparecem mensagens técnicas.
* **API:** A ponte que permite que sistemas conversem entre si.

### Links relacionados

* **Inspetor de Build** — para entender o que aconteceu em cada execução da IA.
* **Diagnóstico e Resolução de Erros** — guia completo para quando o Bug Scanner não resolve.

{% hint style="success" %}
**Próximo passo:** Se o Bug Scanner mostrou um erro e você quer saber como resolver, continue em [**Diagnóstico e Resolução de Erros**](/skip/comece-aqui/diagnostico-e-resolucao-de-erros.md).
{% 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/ferramentas-de-diagnostico-bug-scanner.md?ask=<question>
```

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.