Solución de problemas y preguntas frecuentes

Empieza por el mensaje de la operación que falló y comprueba después el estado del proyecto, el Agente y la tarea. Las secciones siguientes te orientan ante los problemas habituales.

La configuración inicial no permite entrar al área de trabajo

La configuración inicial requiere al menos un Agente instalado, con sesión iniciada y verificado. No basta con instalarlo o cerrar la ventana de inicio de sesión: la lista debe mostrar Listo.

Abre los detalles de ese Agente, resuelve cualquier problema de inicio de sesión, red o verificación y comprueba de nuevo. Consulta Instalar y preparar Noea.

Una descarga falla o permanece en preparación

Comprueba primero la red y el proxy HTTP(S) del sistema. Las variables de entorno del proxy tienen prioridad; este mecanismo no admite proxies SOCKS. El estado de preparación puede aparecer cuando la descarga deja de recibir datos. Observa si hay novedades y reintenta si se informa de un fallo.

Si los fallos se repiten, copia los diagnósticos del Agente y anota si el problema ocurrió al descargar el entorno de ejecución, instalar el Agente o verificar la conexión.

El inicio de sesión funcionó, pero el Agente sigue sin estar disponible

Noea utiliza los resultados de verificación para decidir si un Agente está listo. Comprueba la cuenta o el proveedor, la cuota disponible y la configuración del modelo. Para OpenCode, actualiza la lista de proveedores, confirma la conexión y vuelve a verificar.

Si elegir un modelo requiere primero una conexión, conecta una sesión y comprueba otra vez. Que un Agente admita un ajuste no significa que otro también lo admita.

Un proyecto no se abre

La intención se puede leer, pero los chats no empiezan

Comprueba la carpeta de implementación en Configuración → Proyecto actual → Proyecto. Vincula una si no la hay, o reubica la carpeta de código original si su ruta anterior no es accesible.

Comprueba también que el Agente esté Listo. Poder leer los archivos de intención no significa que la carpeta de implementación y el Agente también estén preparados.

Falta una explicación o parece incorrecta

Guarda la intención y después investiga el párrafo pertinente o ejecuta Explicar desde la barra lateral. Si el requisito necesita cambios de código, impleméntalo en el chat antes de investigar.

Texto anterior se refiere a la intención antes de una edición. Puede estar desactualizado significa que los archivos de apoyo cambiaron después. Contrasta ambos con el contenido actual; consulta Mantener las explicaciones al día.

No se encontraron cambios en la barra lateral no significa que todas las pruebas pasen ni que no queden carencias.

Explicar no se ejecutó después de implementar

Comprueba Configuración → Proyecto actual → Automatización → Explicar automáticamente después de implementar. Los cambios solo de código en chats normales, Implementar directamente y las implementaciones fallidas o detenidas no lo activan.

Ejecuta Explicar manualmente cuando sea necesario. Si una tarea ha terminado pero sigue mostrando comprobaciones fallidas o incompletas, expande los resultados, resuelve la causa y vuelve a ejecutarla. Consulta las reglas completas de activación automática.

No se puede aceptar una propuesta o un plan de organización

Si una propuesta indica que el documento cambió, elige Pedir al agente una nueva propuesta sobre la versión actual. Para un plan de organización desactualizado, elige Reorganizar.

Las propuestas normales permiten editar el texto insertado o de reemplazo, pero no aceptar cambios o archivos individualmente. Los borradores organizados son de solo lectura; puedes conservar eliminaciones propuestas antes de aceptar todo el plan.

¿Debes reenviar un mensaje fallido?

Si Noea indica que el mensaje no se entregó al Agente, puedes reintentar. Si puede haberse entregado, examina primero la traza y los cambios de archivos para evitar una ejecución duplicada.

Si el Agente recibió el mensaje pero se detuvo a mitad de la tarea, envía una nueva instrucción para comprobar el estado actual y continuar. Una tarjeta de propuesta con Implementación sin terminar también ofrece Continuar implementando.

Editar un mensaje, crear una rama de chat o detener una ejecución no revierte los cambios en archivos.

Un servidor MCP o un Skill no tiene efecto

Para MCP, utiliza Probar conexión y comprueba el comando, la URL, la autorización y las variables de entorno indicadas por el resultado. Incluso si la prueba funciona, confirma que el servidor esté seleccionado en el chat y que el Agente admita su método de conexión.

Los cambios de configuración de MCP requieren reconectar el Agente. Añadir o eliminar un Skill requiere un chat nuevo. Las tareas de Explicar y organización no utilizan estas extensiones. Consulta Añadir servidores MCP y Skills.

El guardado falla o una referencia no se abre

Un conflicto al guardar significa que otra operación modificó el archivo en disco mientras lo editabas. Guarda tu contenido actual por separado o recarga la versión del disco. Recargar descarta las ediciones sin guardar.

Para una referencia rota, comprueba que el archivo o material siga existiendo y que la carpeta de implementación sea accesible. Si una explicación antigua ya no coincide con el documento, vuelve a su párrafo para leer la más reciente e investiga de nuevo si es necesario.

Envía información útil al equipo

Utiliza Comentarios en la barra lateral para describir tu objetivo, el resultado real y los pasos que llevaron al problema. Deja un correo electrónico para el seguimiento o escribe a [email protected].

Si hacen falta diagnósticos, expórtalos desde Configuración → Acerca de o cópialos del panel de detalles del Agente. Los diagnósticos pueden contener estado local y registros, así que revísalos antes de compartirlos. Los comentarios no adjuntan estos archivos automáticamente.