Doku · 01

Erste Schritte.

Öffnen Sie die Werkbank, öffnen Sie ein Projekt und starten Sie Ihre erste Simulation. Zehn Minuten, nichts zu installieren.

Was CommandAGI ist

CommandAGI ist eine Werkbank, in der Menschen und Agenten echte Maschinen planen, simulieren und betreiben. Alles darin beruht auf vier Ideen:

  • Geräte. Eine Gerätedefinition beschreibt eine Art Maschine als Satz von Kanälen — eine G-Code-Zeile, ein Servo-Bus, ein Videostrom, eine Shell. Eine CNC-Fräse, ein Laser, ein Drucker, ein Roboterarm, eine Drohne, ein Telefon, eine Kamera und ein Computer sind alle Geräte.
  • Welten. Eine Welt platziert Geräte als Einheiten mit Positionen in einem Raum. Eine Welt ist entweder physical (sie greift auf Hardware zu) oder simulation (jeder Kanal läuft in einem Simulator).
  • Läufe. Was Geräte tun, wird als Datenströme in einem Lauf aufgezeichnet: ein Ordner pro Lauf, ein Datenstrom pro Kanal einer Einheit, alles auf einer Uhr.
  • Berechtigungen. Ein Agent oder eine Person handelt nur dann an echter Hardware, wenn eine Dauerberechtigung innerhalb eines Kontos sie erteilt hat.

Alles davon sind einfache Dateien in einem Ordner Ihrer Wahl.

Die Werkbank öffnen

Gehen Sie zu commandagi.com. Die Werkbank öffnet sich sofort — Sie brauchen kein Konto.

  • Als Gast liegt Ihr Projekt im eigenen Speicher dieses Browsers. Sie können jederzeit einen Ordner hineinimportieren und es als ZIP-Datei exportieren.
  • Angemeldet können Ihre Projekte in der Cloud liegen und Ihnen zwischen Geräten folgen. Registrieren oder anmelden Sie sich am unteren Ende des linken Docks.
  • In der Desktop-App läuft dieselbe Werkbank mit dem eingebauten Host dieses Computers. So kann sie jeden Ordner auf der Festplatte öffnen und Maschinen über USB und das lokale Netzwerk erreichen. Siehe Herunterladen.

Ein Projekt öffnen

Der Ordner, den Sie öffnen, ist das Projekt. Verwenden Sie das Projektmenü oben im linken Dock:

  • Ordner öffnen… — ein Ordner auf Ihrem Computer (in Browsern mit der File System Access API oder in der Desktop-App);
  • Projekt in diesem Browser — das Gastprojekt;
  • Ordner in diesen Browser importieren… und Browser-Projekt exportieren (.zip).

Ein neuer Tab (+ oder Mod+T) bietet vorgeschlagene Dateien, zuletzt verwendete Dateien und die Laufwerke, von denen Sie öffnen können: die Cloud, einen lokalen Ordner, lokale Dateien, diesen Browser und jeden Host, den Sie gekoppelt haben.

Die Werkbank enthält schreibgeschützte Beispielprojekte zum Erkunden: LED-Anzeigeplatinen (eda), ein mechanisches Projekt, eine Biologie-Arbeitszelle, eine Bibliothek mit Simulationen und eine Vorlagenbibliothek mit Dashboards.

Sich zurechtfinden

Das Fenster hat eine Mitte mit Tabs, die in Bereiche geteilt sind, und drei Regionen darum herum: links (Navigation und Explorer), rechts (Details der Auswahl) und unten (Läufe, Ereignisse, Terminal und Protokolle). Der zuletzt benutzte Bereich hat den Fokus und bestimmt, was die Regionen zeigen.

  • Mod+Umschalt+P öffnet die Befehlspalette. Jede Aktion ist dort zu finden.
  • Mod+P öffnet eine Datei nach Namen.
  • Mod+Eingabe maximiert den Bereich mit Fokus.

Eine Welt erstellen

Führen Sie in der Palette neue Welt (Simulation)… aus. Eine Simulationswelt bindet jeden Kanal an einen Simulator, sodass nichts darin Hardware erreichen kann.

Die Einheiten stehen in der world.tsx der Welt. Wählen Sie eine Einheit in der 3D-Ansicht oder der Liste aus und bearbeiten Sie ihre Position, Drehung und ihr Gerät im Tab Details rechts. Um Einheiten hinzuzufügen, ergänzen Sie sie in der world.tsx — siehe Dateiformate.

Eine Simulation starten

  1. Öffnen Sie die Welt und wählen Sie simulieren beim Kanal einer Einheit in der Geräteansicht.
  2. Das Verbinden startet einen Sitzungslauf in dieser Welt (oder tritt dem bereits offenen bei). Jeder Befehl und jeder Zustand wird während des Geschehens in den Lauf geschrieben.
  3. Welten, die eine Simulationsdatei nennen, bieten außerdem Kraft ziehen: Greifen Sie einen Körper und schieben Sie ihn. Die Kraft wird mit Ihrem Namen aufgezeichnet.
  4. Verwenden Sie Lauf schließen, wenn Sie fertig sind.

Eine Simulationswelt sagt es auf dem Bildschirm: Kanäle laufen nur im Simulator; hier erreicht nichts die Hardware, und simulierte Ergebnisse zählen nie als physischer Nachweis. In einem schreibgeschützten Beispiel werden keine Läufe aufgezeichnet — öffnen Sie einen eigenen Ordner, um sie zu behalten.

Wiedergabe und Abzweigen

Jeder Lauf kann auf der Zeitleiste am unteren Ende des Fensters abgespielt werden, mit 0,25× bis 8× Geschwindigkeit, oder live verfolgt werden.

  • Mod+Alt+P Wiedergabe oder Pause · Mod+Alt+L springt zu live · Mod+Alt+, und Mod+Alt+. springen um fünf Sekunden.
  • Der Tab Läufe im unteren Bereich listet die Läufe einer Welt auf.
  • abzweigen startet einen neuen Simulationslauf an der Abspielposition — derselbe Moment, eine andere Zukunft.

Weiter

Wenn Sie bereit für echte Hardware sind, lesen Sie Eine Maschine verbinden. Um einen Agenten damit arbeiten zu lassen, lesen Sie Agenten und Dauerberechtigungen.