Risoluzione dei problemi e domande comuni

Parti dal messaggio dell’operazione fallita, poi verifica lo stato di progetto, Agent e attività. Le sezioni seguenti ti indirizzano al punto giusto per i problemi comuni.

La configurazione non permette di entrare nell’ambiente di lavoro

La configurazione iniziale richiede almeno un Agent installato, con accesso effettuato e verificato. L’installazione da sola, o chiudere la finestra di accesso, non basta: l’elenco deve mostrare Pronto (Ready).

Apri i dettagli dell’Agent, risolvi eventuali problemi di accesso, rete o verifica e controlla di nuovo. Consulta Installare e preparare l’app.

Un download fallisce o resta in preparazione

Controlla prima la rete e il proxy HTTP(S) del sistema. Le variabili d’ambiente del proxy hanno la precedenza; questo meccanismo non supporta proxy SOCKS. Lo stato di preparazione può comparire quando il download smette di ricevere dati. Osserva gli aggiornamenti e riprova se viene segnalato un errore.

Se gli errori si ripetono, copia la diagnostica dell’Agent e annota se il problema si è verificato durante il download del runtime, l’installazione dell’Agent o la verifica della connessione.

L’accesso è riuscito ma l’Agent resta non disponibile

Noea usa i risultati della verifica per decidere se un Agent è pronto. Controlla account o fornitore, quota disponibile e configurazione del modello. Per OpenCode, aggiorna l’elenco dei fornitori, conferma la connessione e verifica di nuovo.

Se la selezione del modello richiede prima una connessione, collega una sessione e controlla di nuovo. Un’impostazione supportata da un Agent non è automaticamente supportata da un altro.

Un progetto non si apre

L’intento è leggibile ma le chat non partono

Controlla la cartella di implementazione in Impostazioni → Progetto attuale → Progetto (Settings → Current Project → Project). Collegane una se manca oppure indica la nuova posizione della cartella di codice originale se il vecchio percorso è inaccessibile.

Verifica anche che l’Agent sia Pronto. File di intento leggibili non significano che anche cartella di implementazione e Agent siano pronti.

Una spiegazione manca o sembra sbagliata

Salva l’intento, poi indaga il paragrafo pertinente oppure esegui Spiega (Explain) dalla barra laterale. Se il requisito richiede modifiche al codice, implementalo in chat prima di indagare.

Testo precedente (Previous text) riguarda l’intento prima di una modifica. Potrebbe non essere aggiornata (May be outdated) significa che i file di supporto sono cambiati dopo. Ricontrolla entrambi rispetto ai contenuti attuali; consulta Mantenere aggiornate le spiegazioni.

Nessuna modifica trovata (No changes found) nella barra laterale non significa che tutti i test passino o che non restino lacune.

Spiega non si è avviato dopo l’implementazione

Controlla Impostazioni → Progetto attuale → Automazione → Spiega automaticamente dopo l’implementazione (Settings → Current Project → Automation → Explain automatically after implementing). Le modifiche al solo codice in chat normali, Implementa direttamente e le implementazioni fallite o interrotte non lo avviano.

Esegui Spiega manualmente quando serve. Se un’attività è terminata ma riporta verifiche fallite o incomplete, espandi i risultati, risolvi la causa e rieseguila. Consulta tutte le regole di avvio automatico.

Non è possibile accettare una proposta o un piano di organizzazione

Se una proposta indica che il documento è cambiato, scegli Chiedi all’Agent una nuova proposta sulla versione attuale (Ask Agent to Re-propose on Current Version). Per un piano di organizzazione non aggiornato, scegli Riorganizza (Reorganize).

Le proposte normali permettono di modificare il testo aggiunto o sostitutivo, ma non supportano l’accettazione di singole modifiche o file. Le bozze organizzate sono di sola lettura; puoi conservare le eliminazioni proposte prima di accettare l’intero piano.

Conviene inviare di nuovo un messaggio fallito?

Se Noea dice che il messaggio non è stato consegnato all’Agent, puoi riprovare. Se potrebbe essere stato consegnato, esamina prima traccia e modifiche ai file per evitare esecuzioni duplicate.

Se l’Agent ha ricevuto il messaggio ma si è fermato durante l’attività, invia una nuova istruzione per verificare lo stato attuale e continuare. Una scheda proposta contrassegnata come Implementazione non completata (Implementation not finished) offre anche Continua a implementare (Continue Implementing).

Modificare un messaggio, creare un ramo della chat o interrompere un’esecuzione non ripristina i file modificati.

Un server MCP o una Skill non ha effetto

Per MCP, usa Verifica connessione (Test Connection) e controlla comando, URL, autorizzazione e variabili d’ambiente indicate dal risultato. Anche dopo una verifica riuscita, conferma che il server sia selezionato nella chat e che l’Agent supporti il metodo di connessione.

Le modifiche alla configurazione MCP richiedono una riconnessione dell’Agent. Aggiungere o rimuovere una Skill richiede una nuova chat. Le attività di spiegazione e organizzazione non usano queste estensioni. Consulta Aggiungere server MCP e Skills.

Il salvataggio fallisce o un riferimento non si apre

Un conflitto di salvataggio significa che un’altra operazione ha modificato il file su disco mentre lo stavi editando. Salva il contenuto attuale separatamente oppure ricarica la versione su disco. Ricaricare scarta le modifiche non salvate.

Per un riferimento non funzionante, verifica che il file o il materiale esista ancora e che la cartella di implementazione sia accessibile. Se una vecchia spiegazione non corrisponde più al documento, torna al suo paragrafo per leggere la spiegazione più recente e indaga di nuovo se necessario.

Invia informazioni utili al team

Usa Feedback nella barra laterale per descrivere obiettivo, risultato effettivo e passaggi che hanno portato al problema. Lascia un’email per un seguito oppure scrivi a [email protected].

Se serve la diagnostica, esportala da Impostazioni → Informazioni (Settings → About) oppure copiala dal pannello dei dettagli dell’Agent. Può contenere stato locale e log, quindi esaminala prima di condividerla. Il feedback non allega automaticamente questi file.