Risoluzione dei Problemi

Questa guida tratta i problemi comuni che potresti incontrare durante l'utilizzo di Neotask e come risolverli.

Licenza e Attivazione

"Chiave di licenza non valida"

• Verifica il formato della chiave: SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• Controlla la presenza di spazi extra o caratteri mancanti
• Assicurati di avere una connessione internet attiva
• Prova a reinserire la chiave con attenzione

"Licenza revocata"

• La tua licenza è stata revocata dal server
• Controlla lo stato della fatturazione su neotask.ai
• Contatta il supporto se ritieni che si tratti di un errore

"Licenza scaduta"

• Il tuo abbonamento è scaduto
• Rinnova il tuo piano tramite il portale di fatturazione
• L'app entra in modalità di sola lettura quando scade

"Periodo di grazia offline scaduto"

• Sei stato offline per più di 72 ore
• Connettiti a internet per la rivalidazione automatica
• L'app riprenderà il normale funzionamento una volta connessa

"Versione bloccata"

• La versione della tua app è stata bloccata per motivi di sicurezza
• Aggiorna immediatamente all'ultima versione
• L'aggiornamento automatico dovrebbe richiederti l'aggiornamento; in caso contrario, scarica dal sito web

Problemi con il Gateway

"Avvio del gateway fallito"

1. Controlla se la porta 18789 è disponibile (non utilizzata da un'altra app)
2. Prova a riavviare l'app
3. Controlla lo stato del gateway dalla dashboard
4. Su macOS, assicurati che l'app abbia le autorizzazioni necessarie in Preferenze di Sistema → Privacy e Sicurezza

"Blocco a 3 tentativi"

• Dopo 3 consecutive falliture del gateway, le operazioni vengono bloccate
• Riavvia l'app per reimpostare il contatore dei blocchi
• Se persiste, controlla i log per l'errore sottostante

"Gateway disconnesso"

• Il runtime locale ha perso la connessione
• Fai clic su "Riconnetti" nel pannello del gateway
• Se continua a disconnettersi, riavvia l'app
• Controlla che nessun firewall stia bloccando le connessioni localhost

Problemi Vocali

"Nessun input audio rilevato"

• Concedi l'autorizzazione al microfono:
  • macOS: Preferenze di Sistema → Privacy e Sicurezza → Microfono → Abilita per Neotask
  • Windows: Impostazioni → Privacy → Microfono → Consenti alle app di accedere
• Controlla che il tuo microfono non sia disattivato
• Verifica che il dispositivo di input corretto sia selezionato nelle impostazioni di sistema

"La parola di attivazione non si attiva"

1. Assicurati che l'attivazione vocale sia abilitata in Impostazioni
2. Controlla che la modalità di attivazione sia impostata su "Porcupine" (non "Scorciatoia" o "Disattivata")
3. Pronuncia chiaramente la frase di attivazione: "Hey Neotask"
4. Prova invece la scorciatoia da tastiera (Cmd+Shift+Space / Ctrl+Shift+Space)
5. Controlla se un'altra app sta utilizzando il microfono

"Audio TTS a scatti o in ritardo"

• Controlla la tua connessione internet (TTS richiede l'API ElevenLabs)
• ElevenLabs potrebbe stare applicando la limitazione della frequenza
• Prova una voce diversa dalle Impostazioni
• Riduci l'attività di rete in background

"La scorciatoia vocale non funziona"

• Un'altra app potrebbe aver rivendicato la stessa scorciatoia
• Cambia la scorciatoia in Impostazioni → Attivazione → Scorciatoia da Tastiera
• Su macOS, controlla Preferenze di Sistema → Tastiera → Scorciatoie per i conflitti

Connessione e Rete

"Impossibile connettersi al server"

• Verifica la tua connessione internet
• Controlla se neotask.ai è accessibile nel tuo browser
• Se sei dietro un firewall aziendale, assicurati che il traffico HTTPS sia consentito
• Prova a disabilitare temporaneamente la VPN

"Richiesta API fallita"

• Controlla la tua connessione internet
• Verifica che la tua licenza sia attiva
• Se stai usando BYOK, controlla che la tua chiave API sia valida e abbia crediti
• Prova ad aggiornare la dashboard

Agenti e Sessioni

"Impossibile creare l'agente: limite raggiunto"

• Il numero di agenti non è limitato dal piano; la creazione di agenti personalizzati richiede un piano a pagamento
• Se vedi questo messaggio sul piano Free, passa a un piano a pagamento per creare agenti personalizzati
• Elimina gli agenti non utilizzati per mantenere ordinato il tuo spazio di lavoro

"L'agente non risponde"

• Controlla lo stato del gateway (deve essere in esecuzione)
• Verifica che il modello dell'agente sia accessibile (chiave API valida, provider disponibile)
• Controlla il budget giornaliero, se superato, gli agenti vengono messi in pausa fino a mezzanotte UTC
• Prova a reimpostare la sessione

"I messaggi della sessione non si caricano"

• Aggiorna la pagina/app
• Controlla lo stato della connessione del gateway
• Se la sessione è molto lunga, prova a creare una nuova sessione

Fatturazione e Pagamenti

"Pagamento fallito"

• Verifica che i dati della tua carta siano corretti
• Controlla con la tua banca eventuali blocchi sulle transazioni internazionali
• Prova un metodo di pagamento diverso
• Contatta il supporto se il problema persiste

"Quota di utilizzo superata"

• Il consumo di token del tuo agente ha superato la quota inclusa nel tuo abbonamento
• L'utilizzo aggiuntivo viene fatturato alle tariffe di utilizzo. Controlla la pagina Utilizzo nella tua dashboard per i dettagli.
• Passa alla modalità BYOK (usa le tue chiavi API) per indirizzare i costi dei token direttamente al tuo provider
• Imposta limiti di budget giornalieri per prevenire sforamenti imprevisti

"Il piano non è stato aggiornato dopo il pagamento"

• I webhook di Stripe potrebbero avere un leggero ritardo (di solito meno di 1 minuto)
• Aggiorna la dashboard
• Se non è ancora aggiornato dopo 5 minuti, contatta il supporto con la tua conferma di pagamento

Prestazioni

"L'app è lenta all'avvio"

• La validazione della licenza e l'avvio del gateway avvengono all'apertura, questo è normale
• Assicurati che il tuo sistema soddisfi i requisiti minimi
• Chiudi le app in background non necessarie

"Utilizzo elevato della CPU"

• Se si utilizza la parola di attivazione sempre attiva (Porcupine), utilizza una CPU minima ma può essere disabilitata
• Metti in pausa le sessioni vocali quando non sono in uso
• Controlla i processi gateway bloccati in Monitor Attività / Task Manager

"Utilizzo elevato della memoria"

• Le sessioni di chat lunghe accumulano memoria
• Crea nuove sessioni periodicamente
• Riavvia l'app per cancellare lo stato accumulato

Ottenere Assistenza

• Documentazione: Sei qui, sfoglia la base di conoscenza
• Supporto: Visita la pagina Supporto su neotask.ai/support
• Contatto: Usa il modulo di contatto sul sito web
• Stato: Controlla lo stato del servizio su neotask.ai