ALBERT | AI Sandbox

Sie können isolierte Arbeitsumgebungen zur Ausführung von KI-Aufgaben einrichten.

Jede Sandbox wird bei Bedarf über einen REST-Service erstellt, als Docker-Container gestartet und enthält alles, was ein autonomer Agent benötigt:

• einen vollständigen Desktop, der über noVNC bereitgestellt wird,
• eine MC Hub-Instanz mit Playwright für automatisierte Browser-Steuerung
• sowie einen Shell-Ausführungs-Service für Skripte oder Python-Code.

Wenn menschliche Intervention erforderlich ist, kann derselbe Desktop in jedem modernen Browser geöffnet werden, sodass Anmeldedaten oder Multi-Faktor-Abfragen interaktiv bearbeitet werden können.

Hauptfunktionen

• Dedizierte Desktop-Sandboxes pro API-Anfrage: Jede Anfrage erstellt eine vollständige, isolierte Umgebung mit vorinstallierten Browser-Automatisierungs- und Shell-Tools.
• Sicherer Desktop-Zugriff über noVNC: Desktops können sicher über noVNC geteilt werden, sodass Benutzer ohne lokale Software überwachen oder eingreifen können.
• MCHub mit Playwright: In jedem Container läuft MCHub mit Playwright zur Orchestrierung von Browser-Sitzungen für den KI-Agenten.
• Shell-Ausführung: Führen Sie Shell-Befehle, Skripte oder Notebooks innerhalb des Containers über den eingebetteten Shell-Service aus.
• Automatisches Stoppen bei Inaktivität: Container werden nach 10 Minuten Inaktivität automatisch gestoppt, um Kapazitäten zu schonen.
• Isolierte Daten und Lifecycle-Operationen: Jeder API-Schlüssel hat Zugriff nur auf seine eigenen Sandboxes, sodass Tenants voneinander isoliert sind.

Systemanforderungen

Komponente	Anforderung
Betriebssystem	Debian 12 (bookworm) verifiziert; vergleichbare Debian-basierte Systeme sollten mit äquivalenten Paketen funktionieren
Berechtigungen	Root-Zugriff zum Ausführen des Installers, Verwalten von Services und Konfigurieren von nginx
Docker	Docker Engine und systemd müssen auf dem Host verfügbar sein
Netzwerk	Internetverbindung während der Installation zum Abrufen von Docker-Komponenten und Python-Paketen

Installation

Gehen Sie wie folgt vor, um ALBERT | AI Sandbox zu installieren:

1. Melden Sie sich auf einem Debian 12 Host mit Root-Rechten an.
2. Klonen Sie das Repository und führen Sie den Installer aus:

   git clone https://github.com/agorum/albert-ai-sandbox.git albert-ai-sandbox
   cd albert-ai-sandbox
   sudo bash install.sh
   

3. Der Installer stellt alle erforderlichen Pakete bereit, erstellt das Desktop-Container-Image, registriert den Manager-Service und platziert Hilfsskripte unter /opt/albert-ai-sandbox-manager mit praktischen Symlinks in /usr/local/bin.
4. Nach der Installation läuft der albert-container-manager systemd-Service auf Port 5001 und ist bereit, API-Aufrufe zu empfangen.

Verwendung mit ALBERT | AI Agents

Sie können Sandboxen in ALBERT | AI verwenden, indem Sie KI-Voreinstellungen (presets) einrichten, die die ausgelieferten Tools für die Sandbox-Verwaltung benutzen. Nach dem Einrichten entsprechender KI-Voreinstellungen können die Sandboxen über den Chat oder in Automatisierungen verwendet werden.

 

Technischer Name	Kurzbeschreibung	Dokumentation
agorum_ai_agents_library_basic_sandbox_download	Sicheres Herunterladen von Dateien aus ALBERT | AI Sandbox-Umgebungen und deren Speicherung als temporäre Dateien in agorum core	Dokumentation
agorum_ai_agents_library_basic_sandbox_upload	Sicherer Upload von Dateien auf einen ALBERT | AI Sandbox Server zur isolierten Verarbeitung und Analyse durch KI-Systeme	Dokumentation
agorum_ai_agents_library_basic_sandbox_manage	Verwaltung von ALBERT | AI Sandbox Server Containern	Dokumentation

 

Zusätzlich zu den KI-Voreinstellungen können Sie Chat-Vorlagen erstellen, die Ihren Nutzern den Umgang mit den Sandboxen erleichtern.

Automatischer Desktop-Zugriff

Jede Sandbox startet in eine vollständige Desktop-Sitzung mit bereits konfigurierter ALBERT | AI Toolchain. Der Installer richtet nginx und noVNC ein, um den Desktop über http://<host>/<sandbox>/ weiterzuleiten.

Wenn die Aktivität für 10 Minuten stoppt, wird der Container automatisch heruntergefahren; der nächste start-Aufruf setzt die Umgebung fort.