Falhas na geração por IA

Quando a geração não inicia, trava, ou entrega resultado inconsistente.

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).

Se existir um requestId, traceId ou link de execução, inclua também.