Ce qu'est CommandAGI
CommandAGI est un atelier où des personnes et des agents planifient, simulent et pilotent de vraies machines. Tout repose sur quatre idées :
- Appareils. Une définition d'appareil décrit un type de machine comme un ensemble de canaux — une ligne G-code, un bus de servomoteurs, un flux vidéo, un shell. Une fraiseuse CNC, un laser, une imprimante, un bras, un drone, un téléphone, une caméra et un ordinateur sont tous des appareils.
- Mondes. Un monde place des appareils comme unités, avec leurs positions, dans un espace. Un monde est soit
physical(il atteint le matériel), soitsimulation(chaque canal tourne dans un simulateur). - Exécutions. Ce que font les appareils est enregistré sous forme de flux dans une exécution : un dossier par exécution, un flux par canal d'unité, le tout sur une seule horloge.
- Autorisations. Un agent ou une personne n'agit sur du matériel physique que dans le cadre d'une autorisation permanente accordée par un compte.
Tout cela est fait de fichiers simples, dans un dossier de votre choix.
Ouvrir l'atelier
Allez sur commandagi.com. L'atelier s'ouvre tout de suite — vous n'avez pas besoin de compte.
- En invité, votre projet vit dans le stockage de ce navigateur. Vous pouvez importer un dossier et l'exporter en zip à tout moment.
- Connecté, vos projets peuvent vivre dans le cloud et vous suivre d'un appareil à l'autre. Créer un compte ou se connecter depuis le pied du dock de gauche.
- Sur l'application de bureau, le même atelier fonctionne avec l'hôte de cet ordinateur intégré : il peut donc ouvrir tout dossier du disque et atteindre les machines en USB et sur le réseau local. Voir Télécharger.
Ouvrir un projet
Le dossier que vous ouvrez est le projet. Utilisez le menu projet en haut du dock de gauche :
- ouvrir un dossier… — un dossier de votre ordinateur (dans les navigateurs compatibles avec l'API File System Access, ou dans l'application de bureau) ;
- projet dans ce navigateur — le projet invité ;
- importer un dossier dans ce navigateur… et exporter le projet de ce navigateur (.zip).
Un nouvel onglet (+, ou Mod+T) propose des fichiers suggérés, des fichiers récents et les Drive auxquels vous pouvez accéder : le cloud, un dossier local, des fichiers locaux, ce navigateur et tout hôte que vous avez appairé.
L'atelier livre des projets d'exemple en lecture seule à explorer : des cartes à LED (eda), un projet mécanique, une cellule de travail biologique, une bibliothèque de simulations et une bibliothèque de modèles de tableaux de bord.
Vous repérer
La fenêtre a un centre d'onglets répartis en volets, et trois zones autour : gauche (navigation et explorateur), droite (détails de ce qui est sélectionné) et bas (exécutions, événements, terminal et journaux). Le volet utilisé en dernier a le focus et décide de ce que montrent les zones.
- Mod+Shift+P ouvre la palette de commandes. Chaque action s'y trouve.
- Mod+P ouvre un fichier par son nom.
- Mod+Enter agrandit le volet actif.
Créer un monde
Dans la palette, lancez nouveau monde (simulation)…. Un monde de simulation lie chaque canal à un simulateur, donc rien en lui ne peut atteindre le matériel.
Les unités sont listées dans le world.tsx du monde. Sélectionnez une unité dans la vue 3D ou dans la liste, puis modifiez sa position, sa rotation et son appareil dans l'onglet Détails à droite. Pour ajouter des unités, ajoutez-les à world.tsx — voir Formats de fichiers.
Lancer une simulation
- Ouvrez le monde et choisissez simuler sur le canal d'une unité dans la vue des appareils.
- La connexion démarre une exécution de session dans ce monde (ou rejoint celle déjà ouverte). Chaque commande et chaque état est écrit dans l'exécution au fur et à mesure.
- Les mondes qui nomment un fichier de simulation proposent aussi pousser en force : saisissez un corps et poussez-le. La force est enregistrée avec votre nom.
- Utilisez fermer l'exécution quand vous avez terminé.
Un monde de simulation le dit à l'écran : les canaux ne tournent que dans le simulateur ; rien ici n'atteint le matériel, et les résultats simulés ne comptent jamais comme preuves physiques. Dans un exemple en lecture seule, les exécutions ne sont pas enregistrées — ouvrez un dossier à vous pour les conserver.
Rejouer et bifurquer
Chaque exécution peut être rejouée sur la barre de temps au pied de la fenêtre, à une vitesse de 0,25× à 8×, ou suivie en direct.
- Mod+Alt+P lecture ou pause · Mod+Alt+L aller en direct · Mod+Alt+, et Mod+Alt+. avancent de cinq secondes.
- L'onglet exécutions de la zone du bas liste les exécutions d'un monde.
- bifurquer démarre une nouvelle exécution de simulation à partir de la tête de lecture — le même instant, un autre futur.
Suite
Quand vous êtes prêt pour du vrai matériel, lisez Connecter une machine. Pour laisser un agent la piloter, lisez Agents et autorisations permanentes.