# Falhas na geração por IA

### Quando usar

* A geração não começa após enviar o prompt.
* A geração fica “rodando” por muito tempo.
* O resultado vem incompleto ou incoerente com o prompt.

### Checklist rápido (2 min)

1. Simplifique o prompt. Faça uma versão mínima.
2. Gere de novo. Evite múltiplos envios em paralelo.
3. Recarregue a página. Tente aba anônima.
4. Desative adblock/extensões de privacidade para o domínio.

### Diagnóstico

#### 1) O que você pediu está “executável”?

* O prompt tem **objetivo**, **módulos/entidades**, e **telas mínimas**.
* Evite ambiguidade: “um sistema completo” sem escopo explode custo e tempo.

#### 2) O erro é de rede/UI?

* Abra o Console do navegador.
* Verifique se existe request falhando (401/403/429/5xx).

#### 3) O erro é de capacidade/limite?

* Se houver “rate limit”, aguarde alguns minutos e tente novamente.
* Evite prompts gigantes. Quebre por etapas.

### Como resolver (padrões)

* **Trava no meio**: reduza o escopo e gere em incrementos.
* **Especificação ruim**: force estrutura com seções e bullets.
* **Resultado faltando partes**: peça só 1 coisa por vez (“adicione X”, depois “ajuste Y”).

### Quando escalar

* O mesmo prompt mínimo falha 3 vezes.
* Erro 5xx repetível.
* A geração conclui, mas o app não roda nem em Preview.

Antes de escalar, junte estas evidências. Isso reduz muito o ping-pong.

* Projeto e ambiente (Dev/Staging/Prod).
* Horário do erro (com timezone).
* Passos para reproduzir (curto e determinístico).
* Mensagem de erro completa (sem prints cortados).
* Screenshot da tela (se aplicável).
* Console do browser (erros e warnings relevantes).
* Aba **Network** (request que falhou + status + payload, se não houver dados sensíveis).

{% hint style="info" %}
Se existir um `requestId`, `traceId` ou link de execução, inclua também.
{% endhint %}


---

# Agent Instructions: 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.madrix.dev/br/solucao-de-problemas/falhas-na-geracao-por-ia.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.