> For the complete documentation index, see [llms.txt](https://docs.madrix.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.madrix.dev/br/solucao-de-problemas/falhas-na-geracao-por-ia.md).

# 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
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, and the optional `goal` query parameter:

```
GET https://docs.madrix.dev/br/solucao-de-problemas/falhas-na-geracao-por-ia.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.