Erreurs courantes

Erreurs de bureau#

"Ce bureau n'a pas pu démarrer"#

Votre bureau s'est arrêté pendant son démarrage, sans raison que la page puisse nommer, et la page de votre bureau affiche "Ce bureau n'a pas pu démarrer. Essayez de le redémarrer." C'est en général un problème d'infrastructure temporaire ou un manque de ressources sur l'hôte. Un bureau sans compte ni clé API ne finit pas ici : il affiche "L'agent n'a pas démarré" à la place.

Relancez votre bureau. Si ça échoue deux fois de suite, écrivez à contact@spinestudio.dev.

Limite de bureaux atteinte#

Votre espace de travail a déjà autant de bureaux que son plan le permet. Le formulaire de création affiche "Vous avez 1/1 bureaux. Supprimez-en un ou passez au niveau supérieur." sous les plans, avec vos propres chiffres, et son bouton "Créer un bureau cloud" reste désactivé.

Supprimez un bureau dont vous n'avez plus besoin, ou passez à un plan supérieur. Arrêter un bureau ne libère pas sa place : un bureau arrêté garde sa machine et ses fichiers, il compte donc toujours.

"Ce bureau a besoin de votre propre identifiant IA."#

Le formulaire de création affiche ce message quand l'agent choisi n'a encore ni compte ni clé API pour fonctionner, et son bouton "Créer un bureau cloud" reste désactivé tant qu'il n'en a pas. Sous le message, le formulaire propose ce que cet agent peut utiliser : un lien "Connecter un compte Claude" ou "Connecter un compte ChatGPT", "Collez une clé API ci-dessous.", ou les deux.

Connectez le compte ou collez la clé, puis créez votre bureau. Un bureau qui existe déjà et a perdu son identifiant ne démarre pas : voir "L'agent n'a pas démarré" plus bas.

Erreurs de l'agent#

"Démarrage de l'agent..."#

L'agent n'a pas fini de démarrer, et l'en-tête du chat l'indique. C'est le dernier service à se lancer, environ 2 minutes après la création du bureau.

Attendez la fin du démarrage. Le chat s'active automatiquement quand l'agent est prêt. Vers 3 minutes, la barre d'outils peut afficher "Le démarrage prend plus de temps que prévu." Ce message seul ne justifie pas de relancer votre bureau. Si l'agent n'est toujours pas prêt 4 minutes après la création, arrêtez et relancez votre bureau.

Un bureau Grok fait exception : il attend que vous vous connectiez avec votre compte xAI, et son chat affiche une carte "Connectez-vous à Grok" au lieu de ce message. Connectez-vous depuis cette carte, sans relancer votre bureau : un redémarrage ramène la même carte.

"L'agent n'a pas démarré"#

Votre bureau tourne, mais son agent n'a pas fini de démarrer. Une carte au-dessus de la zone de saisie du chat en donne la cause : "Aucun compte connecté" ou "Aucune clé API", "Compte refusé" ou "Clé API refusée", "Quota du compte atteint", "Quota de la clé API atteint" ou "Quota xAI atteint", ou "L'agent n'a pas pu démarrer".

Utilisez le bouton de la carte quand elle en affiche un. L'agent ne répond pas explique chaque carte, quoi faire quand elle n'affiche aucun bouton, et les erreurs qui peuvent remplacer une réponse.

Limite de requêtes atteinte#

Vous avez envoyé trop de requêtes au fournisseur IA en peu de temps, et il en refuse d'autres pour l'instant. Chaque fournisseur fixe ses limites selon votre plan chez lui. Après plusieurs nouvelles tentatives, le chat affiche à la place de la réponse, en anglais : "The AI model is currently rate-limited. Please try again in a minute, or switch to a different model." Si l'agent a peut-être déjà reçu votre message ou commencé à le traiter, une partie du travail est peut-être faite, et le chat affiche plutôt, en anglais aussi : "The AI model has reached its request limit for now, so the agent stopped before finishing this reply. The agent may already have received your message and done part of the work — check the desktop before sending it again. If you do, wait a minute first or switch to a different model."

Attendez une minute avant de renvoyer des messages, ou choisissez un autre modèle dans le menu de modèles du chat. Les clés gratuites ont des limites strictes. Si ça arrive souvent, pensez à passer à un plan supérieur chez le fournisseur.

Erreurs de connexion#

Connexion perdue avec votre bureau#

Chaque panneau de la page de votre bureau a sa propre connexion en direct, et signale quand elle se coupe :

• Chat : "Connexion perdue. Les nouveaux messages n'apparaîtront pas ici tant que la connexion n'est pas rétablie.", avec un bouton "Réessayer".
• Viewer VNC : il garde la dernière image affichée, et la ligne au-dessus affiche "Déconnecté" ou "Erreur de connexion", puis "Connexion au bureau..." pendant qu'il se reconnecte tout seul. Sans image à garder, il affiche "Échec de la connexion au bureau" ou "Ce bureau est déconnecté", avec un bouton "Reconnecter".
• Terminal : "Connexion fermée", avec un bouton "Se reconnecter".

Si la connexion ne revient pas :

1. Vérifiez que le statut de votre bureau est running dans le tableau de bord
2. Rechargez la page pour ouvrir une nouvelle connexion
3. Essayez un autre navigateur ou désactivez les extensions
4. Sur un réseau d'entreprise, testez sur un autre réseau. Un pare-feu peut bloquer la connexion.

Problèmes d'affichage du bureau détaille le cas du viewer VNC.

Checklist de dépannage rapide#

1. Votre bureau est en running ? Beaucoup d'erreurs disparaissent une fois le démarrage terminé.
2. La clé API est valide et créditée ? Vérifiez sur le site du provider.
3. Ça fait au moins 4 minutes ? L'agent arrive en dernier, en général environ 2 minutes après la création.
4. Vous avez essayé de redémarrer ? Arrêtez votre bureau, attendez stopped, puis relancez. Un bureau Grok qui affiche une carte "Connectez-vous à Grok" attend votre connexion, pas un redémarrage.
5. Même erreur sur plusieurs bureaux ? C'est probablement un problème de plateforme. Vérifiez les réseaux sociaux de SpineOS ou écrivez à contact@spinestudio.dev.