Agent prêt

Pourquoi l'agent n'est pas prêt tout de suite#

Quand vous démarrez un bureau SpineOS, l'agent IA n'est pas disponible dès que la VM s'allume. Plusieurs phases de démarrage doivent d'abord se terminer. Connaître cette séquence permet de comprendre pourquoi le chat ne fonctionne pas immédiatement.

Phases de démarrage#

Un nouveau bureau tourne en général, agent compris, environ 2 minutes après sa création. Les phases ci-dessous se succèdent dans cet ordre, et le démarrage de l'agent lui-même est la plus longue.

Phase 1 : démarrage VM#

La machine virtuelle démarre, charge l'OS et lance les services de base. À la fin de cette phase, la VM a une adresse IP et une connectivité réseau.

Ce qui fonctionne : le viewer VNC affiche l'écran de démarrage.

Ce qui ne fonctionne pas encore : terminal, chat, transferts de fichiers.

Phase 2 : Initialisation du système#

Le processus d'initialisation exécute les scripts de configuration du bureau :

• Configure l'utilisateur agent
• Écrit la configuration de l'agent
• Installe les plugins activés
• Configure le workspace (soul file, fichier agents, répertoire mémoire)
• Démarre les services en arrière-plan (serveur terminal, agent IA)

Ce qui fonctionne : le viewer VNC montre votre bureau en chargement. Le terminal devient disponible vers la fin.

Ce qui ne fonctionne pas encore : le chat, car l'agent IA est encore en train de démarrer.

Phase 3 : démarrage de l'agent#

L'agent IA démarre, charge sa configuration et commence à accepter les connexions. SpineOS vérifie que l'agent est prêt.

Ce qui fonctionne : tout. VNC, terminal, transferts de fichiers et chat.

agentReady = true#

Un bureau est marqué agentReady uniquement après que SpineOS confirme que l'agent IA est opérationnel et accepte les connexions. Cela signifie que l'agent est initialisé et prêt à recevoir des messages.

Dans le dashboard, le panneau de chat devient actif quand agentReady est vrai.

Pourquoi le chat échoue avant agentReady#

Tant que l'agent n'est pas prêt, l'en-tête du chat et sa zone de saisie affichent "Démarrage de l'agent...", et la zone de saisie n'accepte pas de message. Par l'API, un message envoyé avant est refusé avec une erreur 503. C'est voulu : un message envoyé à un agent qui n'a pas démarré provoquerait des échecs silencieux ou des erreurs incompréhensibles.

Chronologie typique du démarrage#

La durée totale varie selon l'agent, le nombre de plugins activés et la charge de l'infrastructure.

Vérifier le statut de l'agent#

Chaque carte de bureau du tableau de bord affiche "Démarrage" pendant que l'agent démarre, puis "En cours". Elle affiche "Action requise" à la place quand votre bureau a besoin de vous, par exemple pour vous connecter à Grok. Sur la page de votre bureau, la barre d'outils montre la progression du démarrage jusque-là, et la zone de saisie du chat s'ouvre dès que l'agent est prêt.

Et si l'agent ne devient jamais prêt ?#

L'agent d'un nouveau bureau est en général prêt environ 2 minutes après sa création. 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, suivez ces étapes avant de relancer votre bureau :

1. Si une carte du chat indique que l'agent n'a pas démarré, faites ce que L'agent ne répond pas indique pour cette carte.
2. Sinon, vérifiez auprès de votre fournisseur le compte ou la clé API utilisés par votre bureau.
3. Arrêtez votre bureau, attendez qu'il affiche "Arrêté", puis redémarrez-le.

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

Si le problème continue, consultez le guide de dépannage ou contactez le support à contact@spinestudio.dev.