Agents IA. Espaces de travail et accès

Cet article prolonge Agents IA. Démarrage rapide. Il ne revient pas sur l’installation du module, la première connexion et le lancement de l’agent : si vous n’avez pas encore suivi le démarrage rapide, commencez par lui. Vous trouverez ici la gestion des espaces de travail eux-mêmes : création, démarrage et arrêt, renommage, suppression, clés SSH, retour dans la session et limites. Les clés API des fournisseurs font l’objet d’un article distinct, Agents IA. Clés API des fournisseurs.

Pour suivre cet article, il vous faut un serveur avec BeAdmin — chez nos partenaires, un VPS de ce type est prêt dès la commande.

Plus de 15 ans d’expérience dans l’hébergement. Votre VPS avec BeAdmin est prêt à l’emploi.

• Allemagne
• Pays-Bas
• Suède
• Suisse
• Espagne
• États-Unis

Choisir un serveur

La fiabilité européenne en toute simplicité. Lancez BeAdmin avec votre VPS en un clic.

• Allemagne
• Pays-Bas
• Suède
• Estonie
• Roumanie
• Suisse
• Espagne
• Royaume-Uni
• États-Unis

S’inscrire

Comment fonctionne un espace de travail

Chaque espace de travail est un utilisateur distinct sur le serveur, avec son propre répertoire personnel, ses propres clés SSH et sa propre session tmux. Les fichiers d’un espace ne sont pas accessibles aux autres espaces : vous pouvez donc créer un espace par projet ou par collègue, sans que le code et les clés se mélangent.

Les espaces se partagent une limite commune de processeur et de mémoire : par défaut, ensemble, ils ne peuvent pas occuper plus de deux cœurs de processeur et de la moitié de la mémoire vive du serveur. Ainsi, une compilation lourde dans un espace ne met pas tout le serveur à l’arrêt, mais les autres espaces disposent alors de moins de ressources. Cette limite ne peut pas être modifiée dans le panneau.

Créer un espace de travail

L’installation du module crée le premier espace, il figure donc déjà dans la liste. Son nom dépend de la langue du panneau au moment de l’installation : « Principal » avec une interface en français, « Main » en anglais, « Standard » en allemand ou « Основное » en russe. Vous pouvez créer vous-même d’autres espaces tant que la licence compte des emplacements libres (détails dans la section « Limites et achat d’emplacements ») :

1. Cliquez sur « Créer l’espace de travail ».
2. Dans la boîte de dialogue « Créer l’espace de travail », saisissez un « Nom » et cliquez sur « Créer ».

Le nom est une étiquette dans le panneau qui vous permet de distinguer les espaces, par exemple « Projet A » ou « Alex ». Il peut compter de 2 à 64 caractères, quels qu’ils soient, et ne doit pas être identique au nom d’un autre espace ; la comparaison ne tient pas compte de la casse. Sur le serveur, l’espace porte un autre nom : un utilisateur aibox-… au nom attribué automatiquement, que le nom affiché n’influence pas.

Si vous n’avez plus d’emplacements, il est impossible de créer un nouvel espace — voir « Limites et achat d’emplacements ».

Un nouvel espace n’a encore ni clé SSH, ni clé propre pour le fournisseur. Pour vous y connecter, vous devez ajouter une clé SSH (voir « Clés SSH d’un espace de travail »). L’agent utilise la clé commune du fournisseur si elle est définie dans les paramètres du module ; le lien entre la clé commune et la clé d’un espace est expliqué dans l’article Agents IA. Clés API des fournisseurs.

États d’un espace de travail

État	Signification
« Actif »	La session tmux est lancée, vous pouvez vous connecter à l’espace.
« Démarrage », « Arrêt », « Redémarrage »	Une commande est en cours. Attendez qu’elle se termine : l’état change de lui-même.
« Arrêté »	La session est terminée, le processeur et la mémoire ne sont plus utilisés. Les fichiers sont là, mais aucune connexion n’est possible.
« Bloqué »	La limite de la licence est dépassée. Voir la section « Espace de travail bloqué ».

Démarrage, arrêt et redémarrage

Vous démarrez, arrêtez et redémarrez un espace avec les boutons « Démarrer », « Arrêter » et « Redémarrer ». Ce qui arrive à la session et aux tâches dépend de l’action :

• L’arrêt termine la session tmux avec tout ce qui y tourne et libère le processeur et la mémoire. Les fichiers de l’espace sont conservés. L’emplacement de licence reste occupé : il n’est libéré qu’à la suppression de l’espace.
• Le redémarrage fait la même chose, puis relance aussitôt la session. Il est utile si quelque chose est bloqué dans la session.
• Le démarrage ouvre une session tmux vierge.

⚠️ L’arrêt et le redémarrage interrompent les tâches

La session tmux n’existe que tant que l’espace fonctionne : à l’arrêt ou au redémarrage, l’agent et les tâches qui y tournent sont donc interrompus. Fermer le terminal ou éteindre l’ordinateur n’a aucun effet sur la session. Avant d’arrêter un espace, attendez la fin des tâches qui comptent pour vous.

Renommer

Pour renommer un espace, cliquez sur « Renommer », modifiez le « Nom » et cliquez sur « Mettre à jour ». Les exigences sur le nom sont les mêmes qu’à la création.

Le renommage ne change que l’étiquette dans le panneau : l’identifiant aibox-… et la commande de connexion restent les mêmes, vous n’avez donc rien à reconfigurer sur votre ordinateur.

Supprimer un espace de travail

Pour supprimer un espace, ouvrez sa page, cliquez sur « Supprimer » et confirmez la suppression.

‼️ La suppression d’un espace est irréversible

La suppression d’un espace efface toutes ses données : le répertoire personnel avec le code et les clés SSH, ainsi que la session tmux et les tâches qui y tournent. Il est impossible de les restaurer ; si ces fichiers peuvent vous servir, copiez-les d’abord sur votre ordinateur.

Après la suppression, l’emplacement de licence est libéré : vous pouvez créer un nouvel espace, et un espace bloqué, s’il y en avait un, redevient disponible.

Clés SSH d’un espace de travail

Vous ne pouvez vous connecter à un espace qu’avec une clé SSH. Une clé se compose de deux parties : vous ajoutez la clé publique sur la page de l’espace dans le panneau, tandis que la clé privée reste sur votre ordinateur. Pour que SSH trouve seul la clé privée, elle doit se trouver dans un fichier standard (~/.ssh/id_ed25519 ou ~/.ssh/id_rsa) ou être ajoutée à l’agent SSH de votre ordinateur avec la commande ssh-add chemin/vers/la/cle. Sinon, SSH demande un mot de passe — la marche à suivre est décrite dans le démarrage rapide. Si vous n’avez pas encore de paire de clés, créez-en une en suivant l’article Se connecter à un serveur en SSH.

Chaque espace a sa propre liste de clés : une clé ajoutée à un espace ne donne pas accès aux autres. Vous pouvez ajouter la même clé publique à plusieurs espaces, ce qui est pratique si vous travaillez depuis un seul ordinateur.

Ajouter une clé

Cliquez sur « Ajouter une clé » dans la section « Clés SSH » de la page de l’espace ; un exemple pas à pas figure dans le démarrage rapide. La boîte de dialogue « Ajouter une clé SSH » comporte les champs suivants :

• « Clé publique » — le contenu du fichier portant l’extension .pub, en entier. Ne collez jamais ici une clé privée.
• « Commentaire » — une étiquette facultative, par exemple le nom de l’appareil. Elle indique dans la liste à quel ordinateur appartient la clé. Si vous laissez le champ vide, la liste affiche le commentaire contenu dans la clé elle-même (il se trouve à la fin de la ligne .pub).

Le panneau n’ajoute pas la clé si la valeur saisie est incorrecte (l’indication « Cela ne ressemble pas à une clé publique SSH. » apparaît sous le champ), si la clé n’a pas été copiée en entier ou si cette clé est déjà ajoutée à cet espace.

L’empreinte SHA256 que le panneau affiche à côté de chaque clé peut être comparée à celle du fichier sur votre ordinateur avec la commande ssh-keygen -lf ~/.ssh/id_ed25519.pub : cela permet de vérifier plus facilement quelle clé a été ajoutée.

Supprimer une clé

Pour supprimer une clé, cliquez sur l’icône de corbeille à côté d’elle et confirmez la suppression. Cette clé ne permet alors plus de se connecter à l’espace. Les autres clés de l’espace et les autres espaces ne sont pas touchés, et vous pouvez rajouter la clé supprimée à tout moment.

Connexion et retour dans la session

Vous trouvez la commande de connexion sur la page de l’espace, dans la carte « Commande de connexion ». La façon de l’exécuter la première fois est décrite dans le démarrage rapide. Une fois connecté, vous lancez l’agent avec la commande du fournisseur choisi : claude pour Claude Code, codex pour Codex.

La commande se termine par beadmin-aibox-attach et se connecte non pas à un shell ordinaire, mais à la session tmux dev de cet espace, qu’elle crée si elle n’existe pas encore. Vous utilisez donc la même commande pour la première connexion et pour y revenir.

Un terminal fermé, une coupure réseau ou un ordinateur éteint n’interrompent pas la session : elle reste sur le serveur avec l’agent et les tâches en cours. Pour y revenir, exécutez la même commande. Pour vous détacher sans fermer le terminal, appuyez sur Ctrl+B, puis sur D. La commande exit dans le shell de la session, au contraire, la termine avec tout ce qui y tourne — voir le démarrage rapide.

Si les deux fournisseurs sont installés, vous pouvez lancer en même temps les agents Claude Code et Codex dans le même espace. Ouvrez une nouvelle fenêtre tmux dans la session (Ctrl+B, puis C) ou divisez l’écran (Ctrl+B, puis %), puis lancez claude dans l’une et codex dans l’autre. Chaque agent reçoit du panneau la clé de son propre fournisseur, et ils ne se gênent pas. Sans licence, un seul fournisseur est disponible : le second nécessite donc un emplacement de fournisseur dans la licence — voir « Installer un fournisseur ». Si les deux agents travaillent sur le même code, ils peuvent écraser mutuellement leurs modifications ; il est donc plus sûr de donner à chacun son propre répertoire, par exemple une copie distincte du dépôt.

Il est impossible de démarrer un espace arrêté en SSH : cela se fait uniquement dans le panneau, afin que les espaces arrêtés ne consomment à coup sûr aucune ressource du serveur. Une tentative de connexion se termine par le message This workspace's session is stopped. Start it in the BeAdmin panel. — cliquez sur « Démarrer » sur la page de l’espace et relancez la commande.

Limites et achat d’emplacements

Sans licence, un seul espace de travail est disponible : il est occupé par l’espace créé à l’installation du module. Chaque espace supplémentaire occupe un emplacement de licence, et un même serveur peut compter jusqu’à 100 espaces.

Quand tous les emplacements sont pris, il est impossible de créer un nouvel espace : vous devez acheter des emplacements ou supprimer un espace dont vous n’avez plus besoin.

Pour acheter des emplacements, cliquez sur « Acheter des emplacements » : le lien ouvre la page de la licence directement dans le panneau. Si vous n’avez pas encore de licence, la page d’achat d’une nouvelle licence s’ouvre avec la ligne « Espaces de travail d’IA » déjà ajoutée ; si une licence est active, les emplacements s’y ajoutent. L’achat, l’extension et le renouvellement d’une licence sont décrits en détail dans l’article Obtenir une licence, en premier lieu dans les sections « Acheter une nouvelle licence » et « Mettre à niveau la licence ».

Espace de travail bloqué

Si la limite de la licence devient inférieure au nombre d’espaces (la licence a expiré ou des emplacements ont été retirés, par exemple), les espaces en trop passent à l’état « Bloqué ». Ce sont les espaces les plus récents qui sont bloqués ; les plus anciens continuent de fonctionner.

Un espace bloqué n’est pas supprimé : ses fichiers et ses clés SSH sont conservés. En revanche, sa session se termine et la connexion SSH est fermée. Vous pouvez renommer et supprimer un espace bloqué comme d’habitude.

Pour lever le blocage, vous devez soit acheter des emplacements, soit supprimer les espaces en trop pour que leur nombre rentre dans la limite. L’espace se débloque ensuite de lui-même. Le panneau vérifie la limite lors d’une modification de la licence et après la suppression d’un espace, et sinon une fois par jour : le blocage après l’expiration de la licence et sa levée ne sont donc pas toujours instantanés.

Étapes suivantes

• Agents IA. Clés API des fournisseurs — clé commune et clé d’un espace de travail, ce qui se passe à leur suppression, où obtenir une clé.
• Agents IA. Gérer le module — paramètres du module, installation et désinstallation d’un fournisseur, mise à jour, réinstallation et désinstallation du module.