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

# Solución de problemas

> Pasos prácticos para resolver desafíos comunes de desarrollo.

## Atascado en “Intentar arreglar”

Construir con Lumi está diseñado para ser rápido e intuitivo, pero como cualquier herramienta poderosa, a veces puede encontrar problemas. Es posible que tu código no se ejecute como esperabas, o que la IA malinterprete tus instrucciones, lo que lleva a un comportamiento inesperado.

Aquí tienes una guía paso a paso para ayudarte a resolver estos problemas y volver a construir:

<Steps>
  <Step title="Usa primero el botón 'Intentar arreglar'">
    Cuando aparezca un error, tu primer paso debe ser hacer clic en el botón "Intentar arreglar". Lumi analizará los registros, identificará el problema y aplicará una solución rápida. Si esto no resuelve el problema, es hora de pasar al siguiente paso.
  </Step>

  <Step title="Diagnostica el comportamiento inesperado">
    A veces, tu código se ejecuta sin errores pero no funciona como se esperaba. Esto se conoce como comportamiento inesperado y puede ser difícil de depurar. A continuación, te explicamos cómo abordarlo:

    * **Revisa tu instrucción:** Vuelve a verificar tus instrucciones originales para asegurarte de que fueran claras.
    * **Aísla el problema:** Examina los componentes y la lógica individuales para identificar dónde salieron mal las cosas.
    * **Proporciona contexto visual:** Usa capturas de pantalla o grabaciones para mostrarle a la IA exactamente lo que no está funcionando.
  </Step>

  <Step title="Escribe instrucciones más efectivas">
    Las instrucciones claras y estructuradas producen mejores resultados. Sigue este formato para obtener los mejores resultados:

    * **Resumen del proyecto:** Describe brevemente lo que estás construyendo.
    * **Estructura de la página:** Enumera las páginas y componentes clave.
    * **Lógica de navegación:** Explica el flujo de usuario previsto.
    * **Ayudas visuales:** Sube wireframes o maquetas.
    * **Pasos de implementación:** Describe el orden de construcción deseado.
  </Step>

  <Step title="Construye en un orden lógico">
    Un enfoque estructurado para el desarrollo previene muchos problemas comunes. Sigue este flujo de trabajo recomendado:

    1. Crea el diseño principal y las páginas.
    2. Conecta tu backend o base de datos.
    3. Configura la autenticación de usuarios y los roles.
    4. Planifica la lógica para cada funcionalidad.
    5. Pídele a Lumi que implemente las funcionalidades una por una.
  </Step>

  <Step title="Usa el modo de discusión para obtener orientación">
    Si te sientes atascado, cambia al modo de discusión para obtener ayuda:

    * Pídele a Lumi que analice el estado actual de tu proyecto.
    * Solicita un resumen de las soluciones ya intentadas.
    * Pide nuevas estrategias para abordar problemas persistentes.
  </Step>

  <Step title="Aplica tácticas avanzadas para errores difíciles">
    Si el problema persiste, prueba estas técnicas más avanzadas:

    * **Sé específico:** Describe claramente el error y lo que esperas que suceda.
    * **Usa elementos visuales:** Las capturas de pantalla o grabaciones de pantalla son increíblemente útiles para ilustrar problemas complejos.
    * **Pide alternativas:** Pregunta directamente: "¿Qué más podemos intentar?" para generar nuevas ideas.
    * **Revierte:** Restaura tu proyecto a una versión anterior que funcionaba y reconstruye la funcionalidad problemática paso a paso.
  </Step>
</Steps>

## **Áreas comunes de solución de problemas**

La mayoría de los problemas que encontrarás se clasificarán en una de las siguientes categorías:

* Fallos de interfaz de usuario y diseño
* Errores de API o backend
* Malas interpretaciones de las instrucciones
* Falta de respuesta o mal funcionamiento de la IA
* Fallos de la plataforma o de integración

Expande las secciones a continuación para identificar síntomas específicos y encontrar soluciones prácticas para cada uno.

### Problema general

<Accordion title="¿Cómo puedo obtener un diagnóstico rápido para un problema?">
  Cambia al modo de chat y pregunta: “Algo no está funcionando correctamente. ¿Puedes explicar el problema y decirme qué has intentado ya?”
</Accordion>

<Accordion title="¿Qué debo hacer si tengo problemas de interfaz de usuario o de diseño?">
  * Inspecciona la jerarquía de componentes y revisa los estilos aplicados.
  * Usa capturas de pantalla para ilustrar claramente cualquier fallo visual.
  * Pídele a Lumi directamente: “Este elemento está desalineado. Por favor, arréglalo.”
</Accordion>

<Accordion title="¿Qué pasa si estoy completamente atascado en un error?">
  * Prueba esta instrucción: “Demos un paso atrás. Analiza el error y propón una solución alternativa.”
  * Divide la tarea en pasos más pequeños y manejables.
  * Si los errores persisten, usa el botón de revertir para volver a una versión que funcionaba.
</Accordion>

<Accordion title="¿Qué significa un 'error de sandbox de código'?">
  Esto indica un problema de la plataforma y no debería ocurrir. Por favor, repórtalo inmediatamente a nuestro equipo de soporte.
</Accordion>

<Accordion title="¿Qué debo hacer si veo un mensaje de 'vista previa no encontrada' o 'iniciando sandbox'?">
  Primero, intenta una recarga forzada del navegador. Si el problema no se resuelve, por favor, contacta a soporte para obtener ayuda.
</Accordion>

### Fiabilidad de la IA

<Accordion title="¿Cómo puedo evitar errores de la IA al diseñar instrucciones?">
  * Escribe instrucciones claras y bien estructuradas.
  * Emplea técnicas de meta-prompting inverso.
  * Prueba las instrucciones en el modo de discusión antes de implementar cambios importantes.
</Accordion>

<Accordion title="¿Qué debo hacer si la IA no responde?">
  Este es un problema inesperado. Por favor, repórtalo a nuestro equipo de soporte para obtener asistencia inmediata.
</Accordion>

<Accordion title="¿Cómo puedo romper un bucle de error de corrección persistente?">
  Refina tu instrucción para aclarar tu objetivo, o solicita una guía de depuración paso a paso a la IA.
</Accordion>

<Accordion title="¿Qué debo hacer si una refactorización causa problemas importantes?">
  Implementa los cambios de forma incremental. Si los problemas continúan, revierte a una versión estable o usa el modo de discusión para depurar.
</Accordion>

<Accordion title="¿Qué pasa si la IA entra en un bucle de error, alucina o usa una lógica rota?">
  Si encuentras bucles de error o lógica defectuosa, revierte a una versión estable. Luego, proporciona un contexto más específico en tu siguiente instrucción, usando el editor visual o adjuntando un archivo de conocimiento.
</Accordion>

<Accordion title="¿Qué puedo hacer si la IA no implementa los cambios que solicité?">
  La IA puede estar malinterpretando tu solicitud o apuntando a los archivos incorrectos. Proporciona instrucciones muy específicas o realiza las ediciones manualmente.
</Accordion>

<Accordion title="¿Qué pasa si el modo de discusión o el modo de agente no responden o dan una respuesta incompleta?">
  Este es un problema inesperado. Por favor, repórtalo a nuestro equipo de soporte para obtener asistencia inmediata.
</Accordion>

<Accordion title="¿Qué debo hacer ante bloqueos, errores o bucles inesperados?">
  * Evita reintentar la misma instrucción exacta; en su lugar, simplifícala o reformúlala.
  * Pregúntale a la IA: “¿Qué soluciones hemos intentado ya?”
  * Restaura una versión anterior de tu proyecto que funcionaba.
</Accordion>