> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Solução de problemas

> Passos práticos para resolver desafios comuns de desenvolvimento.

## Preso em “Tentar Corrigir”

Construir com a Lumi é projetado para ser rápido e intuitivo, mas como qualquer ferramenta poderosa, às vezes pode encontrar problemas. Você pode descobrir que seu código não funciona como o esperado, ou que a IA interpreta mal suas instruções, levando a um comportamento inesperado.

Aqui está um guia passo a passo para ajudá-lo a resolver esses problemas e voltar a construir:

<Steps>
  <Step title="Use o botão 'Tentar Corrigir' primeiro">
    Quando um erro aparecer, seu primeiro passo deve ser clicar no botão "Tentar Corrigir". A Lumi analisará os logs, identificará o problema e aplicará uma correção rápida. Se isso não resolver o problema, é hora de passar para o próximo passo.
  </Step>

  <Step title="Diagnosticar Comportamento Inesperado">
    Às vezes, seu código é executado sem erros, mas não funciona como o esperado. Isso é conhecido como comportamento inesperado e pode ser difícil de depurar. Veja como abordá-lo:

    * **Revise seu Prompt:** Verifique novamente suas instruções originais para garantir que estavam claras.
    * **Isole o Problema:** Examine componentes e lógicas individuais para identificar onde as coisas deram errado.
    * **Forneça Contexto Visual:** Use capturas de tela ou gravações para mostrar à IA exatamente o que não está funcionando.
  </Step>

  <Step title="Escreva Prompts Mais Eficazes">
    Prompts claros e estruturados produzem melhores resultados. Siga este formato para obter os melhores resultados:

    * **Visão Geral do Projeto:** Descreva brevemente o que você está construindo.
    * **Estrutura da Página:** Liste as principais páginas e componentes.
    * **Lógica de Navegação:** Explique o fluxo de usuário pretendido.
    * **Auxílios Visuais:** Envie wireframes ou mockups.
    * **Passos de Implementação:** Descreva a ordem de construção desejada.
  </Step>

  <Step title="Construa em uma Ordem Lógica">
    Uma abordagem estruturada para o desenvolvimento previne muitos problemas comuns. Siga este fluxo de trabalho recomendado:

    1. Crie o layout principal e as páginas.
    2. Conecte seu backend ou banco de dados.
    3. Configure a autenticação de usuário e as funções.
    4. Planeje a lógica para cada funcionalidade.
    5. Dê um prompt para a Lumi implementar as funcionalidades uma a uma.
  </Step>

  <Step title="Use o Modo de Discussão para Orientação">
    Se você se sentir travado, mude para o Modo de Discussão para obter ajuda:

    * Peça à Lumi para analisar o estado atual do seu projeto.
    * Solicite um resumo das soluções já tentadas.
    * Dê um prompt por novas estratégias para lidar com problemas persistentes.
  </Step>

  <Step title="Aplique Táticas Avançadas para Bugs Difíceis">
    Se o problema persistir, tente estas técnicas mais avançadas:

    * **Seja Específico:** Descreva claramente o bug e o que você espera que aconteça.
    * **Use Recursos Visuais:** Capturas de tela ou gravações de tela são incrivelmente úteis para ilustrar problemas complexos.
    * **Peça por Alternativas:** Pergunte diretamente, "O que mais podemos tentar?" para gerar novas ideias.
    * **Reverta:** Restaure seu projeto para uma versão anterior que estava funcionando e reconstrua a funcionalidade problemática passo a passo.
  </Step>
</Steps>

## **Áreas Comuns de Solução de Problemas**

A maioria dos problemas que você encontrará se enquadrará em uma das seguintes categorias:

* Falhas de UI e Layout
* Erros de API ou Backend
* Interpretações Incorretas do Prompt
* Falta de Resposta ou Mau Funcionamento da IA
* Falhas de Plataforma ou Integração

Expanda as seções abaixo para identificar sintomas específicos e encontrar soluções práticas para cada um.

### Problema geral

<Accordion title="Como posso obter um diagnóstico rápido para um problema?">
  Mude para o Modo de Chat e pergunte: “Algo não está funcionando corretamente. Você pode explicar o problema e me dizer o que você já tentou?”
</Accordion>

<Accordion title="O que devo fazer em caso de problemas de UI ou layout?">
  * Inspecione a hierarquia de componentes e revise os estilos aplicados.
  * Use capturas de tela para ilustrar claramente quaisquer falhas visuais.
  * Dê um prompt diretamente para a Lumi: “Este elemento está desalinhado. Por favor, corrija.”
</Accordion>

<Accordion title="E se eu estiver completamente preso em um erro?">
  * Tente este prompt: “Vamos dar um passo para trás. Analise o erro e proponha uma solução alternativa.”
  * Divida a tarefa em passos menores e mais gerenciáveis.
  * Se os erros persistirem, use o botão de reverter para voltar a uma versão funcional.
</Accordion>

<Accordion title="O que significa um 'erro de sandbox de código'?">
  Isso indica um problema na plataforma e não deveria acontecer. Por favor, reporte imediatamente à nossa equipe de suporte.
</Accordion>

<Accordion title="O que devo fazer se vir uma mensagem de 'preview não encontrado' ou 'iniciando sandbox'?">
  Primeiro, tente uma atualização forçada do navegador. Se o problema não for resolvido, entre em contato com o suporte para obter ajuda.
</Accordion>

### Confiabilidade da IA

<Accordion title="Como posso evitar erros da IA ao fazer engenharia de prompt?">
  * Escreva prompts claros e bem estruturados.
  * Empregue técnicas de meta prompting reverso.
  * Teste os prompts no Modo de Discussão antes de implementar grandes mudanças.
</Accordion>

<Accordion title="O que devo fazer se a IA não estiver respondendo?">
  Este é um problema inesperado. Por favor, reporte à nossa equipe de suporte para assistência imediata.
</Accordion>

<Accordion title="Como posso quebrar um loop de erro de correção persistente?">
  Refine seu prompt para esclarecer seu objetivo ou solicite um guia de depuração passo a passo da IA.
</Accordion>

<Accordion title="O que devo fazer se uma refatoração causar grandes problemas?">
  Implemente as mudanças de forma incremental. Se os problemas continuarem, reverta para uma versão estável ou use o Modo de Discussão para depuração.
</Accordion>

<Accordion title="E se a IA entrar em um loop de erro, alucinar ou usar lógica quebrada?">
  Se você encontrar loops de erro ou lógica falha, reverta para uma versão estável. Em seguida, forneça um contexto mais específico em seu próximo prompt, usando o editor visual ou anexando um arquivo de conhecimento.
</Accordion>

<Accordion title="O que posso fazer se a IA não conseguir implementar as mudanças que solicitei?">
  A IA pode estar interpretando mal sua solicitação ou visando os arquivos errados. Forneça instruções altamente específicas ou faça as edições manualmente.
</Accordion>

<Accordion title="E se o Modo de Discussão ou o Modo de Agente não estiver respondendo ou der uma resposta incompleta?">
  Este é um problema inesperado. Por favor, reporte à nossa equipe de suporte para assistência imediata.
</Accordion>

<Accordion title="O que devo fazer em caso de travamentos, erros ou loops inesperados?">
  * Evite tentar novamente o mesmo prompt exato; em vez disso, simplifique-o ou reformule-o.
  * Pergunte à IA: “Quais soluções já tentamos?”
  * Restaure uma versão anterior do seu projeto que estava funcionando.
</Accordion>