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

# Resolução de Problemas

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

## Preso em “Tentar Corrigir”

Construir com a Lumi foi concebido para ser rápido e intuitivo, mas como qualquer ferramenta poderosa, por vezes pode encontrar problemas. Pode acontecer que o seu código não corra como pretendido, ou que a IA interprete mal as suas instruções, levando a um comportamento inesperado.

Aqui está um guia passo a passo para o ajudar a resolver estes problemas e a voltar a construir:

<Steps>
  <Step title="Use Primeiro o Botão 'Tentar Corrigir'">
    Quando surge um erro, o seu primeiro passo deve ser clicar no botão "Tentar Corrigir". A Lumi analisará os registos, identificará o problema e aplicará uma correção rápida. Se isto não resolver o problema, está na hora de passar para o passo seguinte.
  </Step>

  <Step title="Diagnosticar Comportamento Inesperado">
    Por vezes, o seu código corre sem erros, mas não funciona como pretendido. Isto é conhecido como comportamento inesperado e pode ser difícil de depurar. Eis como o abordar:

    * **Reveja o Seu Pedido:** Verifique novamente as suas instruções originais para garantir que foram claras.
    * **Isole o Problema:** Examine os componentes e a lógica individualmente para identificar onde as coisas correram mal.
    * **Forneça Contexto Visual:** Use capturas de ecrã ou gravações para mostrar à IA exatamente o que não está a funcionar.
  </Step>

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

    * **Visão Geral do Projeto:** Descreva brevemente o que está a construir.
    * **Estrutura da Página:** Liste as páginas e componentes principais.
    * **Lógica de Navegação:** Explique o fluxo de utilizador pretendido.
    * **Ajudas Visuais:** Carregue wireframes ou mockups.
    * **Passos de Implementação:** Delineie a ordem de construção desejada.
  </Step>

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

    1. Crie o layout principal e as páginas.
    2. Conecte o seu backend ou base de dados.
    3. Configure a autenticação e os papéis de utilizador.
    4. Planeie a lógica para cada funcionalidade.
    5. Peça à Lumi para implementar as funcionalidades uma a uma.
  </Step>

  <Step title="Use o Modo de Discussão para Orientação">
    Se se sentir bloqueado, mude para o Modo de Discussão para obter assistência:

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

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

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

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

A maioria dos problemas que encontrará enquadra-se numa das seguintes categorias:

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

Expanda as secçõ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á a funcionar corretamente. Pode explicar o problema e dizer-me o que já tentou?”
</Accordion>

<Accordion title="O que devo fazer em caso de problemas de UI ou layout?">
  * Inspecione a hierarquia de componentes e reveja os estilos aplicados.
  * Use capturas de ecrã para ilustrar claramente quaisquer falhas visuais.
  * Peça diretamente à Lumi: “Este elemento está desalinhado. Por favor, corrija-o.”
</Accordion>

<Accordion title="E se eu estiver completamente bloqueado num erro?">
  * Experimente este pedido: “Vamos dar um passo atrás. Analise o erro e proponha uma solução alternativa.”
  * Divida a tarefa em passos mais pequenos e mais fáceis de gerir.
  * 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'?">
  Isto indica um problema na plataforma e não deveria acontecer. Por favor, reporte-o imediatamente à nossa equipa de suporte.
</Accordion>

<Accordion title="O que devo fazer se vir uma mensagem de 'pré-visualização não encontrada' ou 'a iniciar sandbox'?">
  Primeiro, tente uma atualização forçada do navegador. Se o problema não for resolvido, por favor, contacte o suporte para obter assistência.
</Accordion>

### Fiabilidade da IA

<Accordion title="Como posso evitar erros da IA ao criar pedidos?">
  * Escreva pedidos claros e bem estruturados.
  * Empregue técnicas de meta-prompting reverso.
  * Teste os pedidos no Modo de Discussão antes de implementar grandes alterações.
</Accordion>

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

<Accordion title="Como posso quebrar um ciclo de erro de correção persistente?">
  Refine o seu pedido para clarificar o seu objetivo, ou solicite um guia de depuração passo a passo à IA.
</Accordion>

<Accordion title="O que devo fazer se uma refatoração causar problemas graves?">
  Implemente as alterações 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 num ciclo de erro, alucinar ou usar lógica defeituosa?">
  Se encontrar ciclos de erro ou lógica defeituosa, reverta para uma versão estável. Depois, forneça um contexto mais específico no seu próximo pedido, usando o editor visual ou anexando um ficheiro de conhecimento.
</Accordion>

<Accordion title="O que posso fazer se a IA não conseguir implementar as alterações que pedi?">
  A IA pode estar a interpretar mal o seu pedido ou a visar os ficheiros errados. Forneça instruções muito 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 a responder ou der uma resposta incompleta?">
  Este é um problema inesperado. Por favor, reporte-o à nossa equipa de suporte para assistência imediata.
</Accordion>

<Accordion title="O que devo fazer em caso de falhas, erros ou ciclos inesperados?">
  * Evite tentar novamente o mesmo pedido exato; em vez disso, simplifique-o ou reformule-o.
  * Pergunte à IA: “Que soluções já tentámos?”
  * Restaure uma versão anterior do seu projeto que estivesse a funcionar.
</Accordion>