Depannage

Ce guide couvre les problemes courants que vous pouvez rencontrer lors de l'utilisation de Neotask et comment les resoudre.

Licence et activation

"Cle de licence invalide"

• Verifiez le format de la cle : SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• Verifiez qu'il n'y a pas d'espaces supplementaires ou de caracteres manquants
• Assurez-vous d'avoir une connexion internet active
• Essayez de re-saisir la cle soigneusement

"Licence revoquee"

• Votre licence a ete revoquee par le serveur
• Verifiez votre statut de facturation sur neotask.ai
• Contactez le support si vous pensez qu'il s'agit d'une erreur

"Licence expiree"

• Votre abonnement a expire
• Renouvelez votre forfait via le portail de facturation
• L'application passe en mode lecture seule lorsqu'elle est expiree

"Periode de grace hors ligne expiree"

• Vous etes hors ligne depuis plus de 72 heures
• Connectez-vous a internet pour une revalidation automatique
• L'application reprendra son fonctionnement normal une fois connectee

"Version bloquee"

• Votre version d'application a ete bloquee pour des raisons de securite
• Mettez a jour vers la derniere version immediatement
• La mise a jour automatique devrait vous inviter ; sinon, telechargez depuis le site web

Problemes de passerelle

"La passerelle n'a pas pu demarrer"

1. Verifiez si le port 18789 est disponible (non utilise par une autre application)
2. Essayez de redemarrer l'application
3. Verifiez la sante de la passerelle depuis le tableau de bord
4. Sur macOS, assurez-vous que l'application a les permissions necessaires dans Preferences Systeme > Confidentialite et securite

"Verrouillage en 3 tentatives"

• Apres 3 echecs consecutifs de passerelle, les operations sont bloquees
• Redemarrez l'application pour reinitialiser le compteur de verrouillage
• Si le probleme persiste, verifiez les journaux pour l'erreur sous-jacente

"Passerelle deconnectee"

• Le runtime local a perdu la connexion
• Cliquez sur "Reconnecter" dans le panneau de la passerelle
• Si les deconnexions persistent, redemarrez l'application
• Verifiez qu'aucun pare-feu ne bloque les connexions localhost

Problemes vocaux

"Aucune entree audio detectee"

• Accordez la permission du microphone :
  • macOS : Preferences Systeme > Confidentialite et securite > Microphone > Activer pour Neotask
  • Windows : Parametres > Confidentialite > Microphone > Autoriser les applications a acceder
• Verifiez que votre microphone n'est pas coupe
• Verifiez que le bon appareil d'entree est selectionne dans les parametres systeme

"Le mot d'eveil ne se declenche pas"

1. Assurez-vous que l'activation vocale est activee dans les parametres
2. Verifiez que le mode d'eveil est regle sur "Porcupine" (pas "Raccourci" ou "Desactive")
3. Dites clairement la phrase d'eveil : "Hey Neotask"
4. Essayez le raccourci clavier a la place (Cmd+Shift+Space / Ctrl+Shift+Space)
5. Verifiez si une autre application utilise le microphone

"Audio TTS saccade ou retarde"

• Verifiez votre connexion internet (TTS necessite l'API ElevenLabs)
• ElevenLabs peut subir une limitation de debit
• Essayez une voix differente depuis les parametres
• Reduisez l'activite reseau en arriere-plan

"Le raccourci vocal ne fonctionne pas"

• Une autre application peut avoir revendique le meme raccourci
• Changez le raccourci dans Parametres > Activation > Raccourci clavier
• Sur macOS, verifiez Preferences Systeme > Clavier > Raccourcis pour les conflits

Connexion et reseau

"Impossible de se connecter au serveur"

• Verifiez votre connexion internet
• Verifiez si neotask.ai est accessible dans votre navigateur
• Si derriere un pare-feu d'entreprise, assurez-vous que le trafic HTTPS est autorise
• Essayez de desactiver le VPN temporairement

"Echec de la requete API"

• Verifiez votre connexion internet
• Verifiez que votre licence est active
• Si vous utilisez BYOK, verifiez que votre cle API est valide et a des credits
• Essayez de rafraichir le tableau de bord

Agents et sessions

"Impossible de creer un agent : limite atteinte"

• Le nombre d'agents n'est pas limite par forfait ; la creation d'agents personnalises necessite un forfait payant
• Si vous voyez ce message sur le forfait Free, passez a un forfait payant pour creer des agents personnalises
• Supprimez les agents inutilises pour garder votre espace de travail ordonne

"L'agent ne repond pas"

• Verifiez la sante de la passerelle (doit etre en cours d'execution)
• Verifiez que le modele de l'agent est accessible (cle API valide, fournisseur disponible)
• Verifiez le budget quotidien -- s'il est depasse, les agents sont mis en pause jusqu'a minuit UTC
• Essayez de reinitialiser la session

"Les messages de session ne se chargent pas"

• Rafraichissez la page/application
• Verifiez le statut de connexion de la passerelle
• Si la session est tres longue, essayez de creer une nouvelle session

Facturation et paiements

"Echec du paiement"

• Verifiez que les details de votre carte sont corrects
• Verifiez aupres de votre banque s'il y a des blocages sur les transactions internationales
• Essayez un autre mode de paiement
• Contactez le support si le probleme persiste

"Allocation d'utilisation depassee"

• La consommation de tokens de votre agent a depasse l'allocation incluse dans votre abonnement
• L'utilisation supplementaire est facturee aux taux d'utilisation. Verifiez la page Utilisation de votre tableau de bord pour les details.
• Passez en mode BYOK (utilisez vos propres cles API) pour acheminer les couts de tokens directement a votre fournisseur
• Definissez des limites de budget quotidien pour prevenir les depassements inattendus

"Le forfait n'est pas mis a jour apres le paiement"

• Les webhooks Stripe peuvent avoir un leger delai (generalement moins d'1 minute)
• Rafraichissez le tableau de bord
• Si toujours pas mis a jour apres 5 minutes, contactez le support avec votre confirmation de paiement

Performance

"Application lente au demarrage"

• La validation de licence et le demarrage de la passerelle se produisent au lancement -- c'est normal
• Assurez-vous que votre systeme repond aux exigences minimales
• Fermez les applications en arriere-plan inutiles

"Utilisation elevee du CPU"

• Si vous utilisez le mot d'eveil permanent (Porcupine), il utilise un CPU minimal mais peut etre desactive
• Mettez en pause les sessions vocales lorsqu'elles ne sont pas utilisees
• Verifiez les processus de passerelle bloques dans le Moniteur d'activite / Gestionnaire de taches

"Utilisation elevee de la memoire"

• Les longues sessions de chat accumulent de la memoire
• Creez de nouvelles sessions periodiquement
• Redemarrez l'application pour liberer l'etat accumule

Obtenir de l'aide

• Documentation : Vous etes ici -- parcourez la base de connaissances
• Support : Visitez la page Support sur neotask.ai/support
• Contact : Utilisez le formulaire de contact sur le site web
• Statut : Verifiez le statut du service sur neotask.ai