Dépannage et questions fréquentes

Commencez par le message de l’opération échouée, puis vérifiez l’état du projet, de l’Agent et de la tâche. Les sections suivantes indiquent où chercher pour les problèmes courants.

La configuration bloque l’accès à l’espace de travail

La configuration initiale exige au moins un Agent installé, authentifié et vérifié. L’installation seule, ou la fermeture de la fenêtre de connexion, ne suffit pas : la liste doit afficher Prêt.

Ouvrez les détails de cet Agent, résolvez les problèmes d’authentification, de réseau ou de vérification et vérifiez à nouveau. Consultez Installer et préparer Noea.

Un téléchargement échoue ou reste en préparation

Vérifiez d’abord le réseau et le proxy HTTP(S) du système. Les variables d’environnement de proxy sont prioritaires ; ce mécanisme ne prend pas en charge SOCKS. Un statut de préparation peut apparaître lorsque le téléchargement cesse de recevoir des données. Surveillez son évolution et réessayez si un échec est signalé.

En cas d’échecs répétés, copiez les diagnostics de l’Agent et notez si le problème survient pendant le téléchargement de l’environnement d’exécution, l’installation de l’Agent ou la vérification de connexion.

Authentification réussie, mais Agent indisponible

Noea se fonde sur la vérification pour décider si l’Agent est prêt. Contrôlez le compte ou fournisseur, le quota disponible et les modèles configurés. Pour OpenCode, actualisez la liste des fournisseurs, confirmez la connexion et vérifiez à nouveau.

Si la sélection de modèle exige une connexion préalable, connectez une session et revérifiez. Une option prise en charge par un Agent ne l’est pas automatiquement par un autre.

Un projet ne s’ouvre pas

L’intention est lisible, mais les conversations ne démarrent pas

Vérifiez le dossier d’implémentation dans Réglages → Projet actuel → Projet. Liez-en un si aucun n’est lié, ou relocalisez le dossier de code original si son ancien chemin est inaccessible.

Vérifiez également que l’Agent est prêt. Des intentions lisibles ne signifient pas que le dossier d’implémentation et l’Agent sont prêts eux aussi.

Une explication manque ou semble erronée

Enregistrez l’intention, puis analysez le paragraphe concerné ou lancez Expliquer dans la barre latérale. Si l’exigence nécessite des changements de code, implémentez-la dans une conversation avant l’analyse.

Texte précédent désigne l’intention avant modification. Peut-être obsolète indique des fichiers justificatifs modifiés depuis. Revérifiez ces deux cas avec le contenu actuel ; voir Garder les explications à jour.

Aucun changement détecté dans la barre latérale ne signifie pas que tous les tests passent ou qu’aucune lacune ne subsiste.

Expliquer ne démarre pas après l’implémentation

Vérifiez Réglages → Projet actuel → Automatisation → Expliquer automatiquement après l’implémentation. Les changements de code seuls dans une conversation ordinaire, Implémenter directement et les implémentations échouées ou interrompues ne le déclenchent pas.

Lancez Expliquer manuellement au besoin. Si une tâche terminée signale encore des vérifications en échec ou inachevées, développez les résultats, traitez la cause et relancez-la. Consultez toutes les règles de déclenchement automatique.

Une proposition ou un plan ne peut pas être accepté

Si une proposition indique que le document a changé, choisissez Demander à l’agent une nouvelle proposition sur la version actuelle. Pour un plan d’organisation obsolète, choisissez Réorganiser.

Les propositions ordinaires permettent de modifier le texte inséré ou remplaçant, mais pas d’accepter séparément des modifications ou fichiers. Les brouillons organisés sont en lecture seule ; vous pouvez conserver des suppressions proposées avant d’accepter tout le plan.

Faut-il renvoyer un message échoué ?

Si Noea indique que le message n’a pas été remis à l’Agent, vous pouvez réessayer. S’il a peut-être été remis, examinez d’abord la trace et les fichiers modifiés pour éviter une double exécution.

Si l’Agent a reçu le message mais s’est arrêté pendant la tâche, envoyez une nouvelle instruction pour vérifier l’état actuel et poursuivre. Une carte portant Implémentation inachevée propose aussi Poursuivre l’implémentation.

Modifier un message, créer une branche ou arrêter une exécution ne restaure pas les fichiers modifiés.

Un serveur MCP ou Skill ne prend pas effet

Pour MCP, utilisez Tester la connexion et vérifiez commande, URL, autorisation et variables d’environnement selon le résultat. Même après un test réussi, confirmez que le serveur est sélectionné dans la conversation et que l’Agent prend en charge sa méthode de connexion.

Une modification de configuration MCP exige une reconnexion de l’Agent. Ajouter ou retirer un Skill exige une nouvelle conversation. Les tâches Expliquer et d’organisation n’utilisent pas ces extensions. Voir Ajouter des serveurs MCP et des Skills.

L’enregistrement échoue ou une référence ne s’ouvre pas

Un conflit d’enregistrement signifie qu’une autre opération a modifié le fichier sur le disque pendant votre édition. Enregistrez votre contenu séparément ou rechargez la version du disque. Recharger abandonne les modifications non enregistrées.

Pour une référence cassée, vérifiez que le fichier ou la pièce existe encore et que le dossier d’implémentation est accessible. Si une ancienne explication ne correspond plus au document, revenez à son paragraphe pour lire la plus récente et analyser à nouveau au besoin.

Transmettre des informations utiles à l’équipe

Utilisez Commentaires dans la barre latérale pour décrire votre objectif, le résultat réel et les étapes ayant mené au problème. Laissez une adresse e-mail pour le suivi ou contactez [email protected].

Si des diagnostics sont nécessaires, exportez-les depuis Réglages → À propos ou copiez-les depuis les détails de l’Agent. Ils peuvent contenir des états locaux et des journaux : examinez-les avant partage. Les commentaires ne joignent pas automatiquement ces fichiers.