Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents
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:
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.
Hinweis: Für die Einrichtung von ALBERT | AI Sandbox verwenden Sie folgendes GIT-Projekt:
| 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 |
Gehen Sie wie folgt vor, um ALBERT | AI Sandbox zu installieren:
git clone https://github.com/agorum/albert-ai-sandbox.git albert-ai-sandbox cd albert-ai-sandbox sudo bash install.sh
/opt/albert-ai-sandbox-manager mit praktischen Symlinks in /usr/local/bin.albert-container-manager systemd-Service auf Port 5001 und ist bereit, API-Aufrufe zu empfangen.Achtung: Für den Betrieb sind Docker und systemd zwingend erforderlich. Die Installation muss mit Root-Rechten erfolgen.
Damit agorum core mit dem ALBERT | AI Sandbox Server kommunizieren kann, muss ein API-Schlüssel erstellt werden. Jeder API-Schlüssel ist einem Benutzer oder einer Anwendung zugeordnet und ermöglicht die Verwaltung eigener Sandboxes.
Führen Sie auf dem Sandbox-Server folgenden Befehl aus:
sudo /opt/albert-ai-sandbox-manager/scripts/api-key-manager.sh create --label "agorum core Integration"
Der Befehl gibt einen API-Schlüssel zurück, der wie folgt aussieht:
OPpDNFekdM5hUuQsboNhgTfUB0nuKYXyE_lHJQ4rNeE
Hinweis: Bewahren Sie den API-Schlüssel sicher auf. Er wird benötigt, um die Tools in agorum core zu konfigurieren.
Um alle vorhandenen API-Schlüssel aufzulisten:
sudo /opt/albert-ai-sandbox-manager/scripts/api-key-manager.sh list
Um einen API-Schlüssel zu löschen:
sudo /opt/albert-ai-sandbox-manager/scripts/api-key-manager.sh delete <api-key>
Um die ALBERT | AI Sandbox in agorum core zu nutzen, müssen Sie eine KI-Voreinstellung konfigurieren. Das Projekt agorum.ai.agents.library.basic enthält bereits eine vorkonfigurierte Voreinstellung.
agorum.ai.agents.library.basic) ist in agorum core installiertGehen Sie wie folgt vor, um die vorkonfigurierte Sandbox-Voreinstellung einzurichten:
agorum_ai_agents_library_basic_preset_albert_ai_sandbox mit dem Anzeigenamen ALBERT | AI Sandbox.agorum_ai_agents_library_basic_sandbox_tools_group).agorum_ai_agents_library_basic_sandbox_manage):http://10.0.1.61 oder https://sandbox.example.com)Hinweis: Die anderen Tools in der Tool-Group (upload, download, MCP) erben automatisch die Basis-URL und den API-Key vom Manage-Tool durch dynamische Parameter.
| Technischer Name | Kurzbeschreibung | Dokumentation |
|---|---|---|
| sandbox_download | Sicheres Herunterladen von Dateien aus ALBERT | AI Sandbox-Umgebungen und deren Speicherung als temporäre Dateien in agorum core | Dokumentation |
| sandbox_upload | Sicherer Upload von Dateien auf einen ALBERT | AI Sandbox Server zur isolierten Verarbeitung und Analyse durch KI-Systeme | Dokumentation |
| sandbox_manage | Verwaltung von ALBERT | AI Sandbox Server Containern | Dokumentation |
| albert_ai_sandbox_mcp | MCP-Tools für Shell-Befehle und Browser-Automatisierung (bash-mcp, playwright-browser) | Dokumentation |
Die vorkonfigurierte Voreinstellung enthält bereits einen optimierten Kontext mit:
agorum.ai.sandbox/basic mit Best Practices zur Sandbox-NutzungUm zu testen, ob die Integration funktioniert:
Liste mir meine Container aufZusätzlich zu den KI-Voreinstellungen können Sie Chat-Vorlagen erstellen, die Ihren Nutzern den Umgang mit den Sandboxen erleichtern, siehe Die Chat-Vorlagen verwenden.
Dieser Abschnitt beschreibt den typischen Workflow bei der Arbeit mit Sandboxen und gibt Best Practices für die effiziente Nutzung.
Eine Sandbox durchläuft verschiedene Zustände während ihrer Lebensdauer:
create-Befehl. Die KI erstellt einen neuen Docker-Container mit vollständigem Desktop und allen Tools.start wieder aktiviert werden. Alle Daten bleiben erhalten.remove wird der Container permanent gelöscht. Alle Daten gehen verloren.Die KI führt automatisch folgenden Workflow aus, wenn Sie eine Aufgabe übergeben:
list).Jeder Benutzer kann mehrere Container parallel betreiben. Die Container werden automatisch in der Benutzerkonfiguration unter home:MyAdmin/agorum.ai/settings/sandbox.json gespeichert.
Wichtige Hinweise:
Um Ressourcen zu schonen, werden Container automatisch nach 10 Minuten Inaktivität gestoppt. Dies betrifft:
Tipp: Gestoppte Container verbrauchen keine CPU oder RAM, belegen aber weiterhin Festplattenspeicher. Löschen Sie nicht mehr benötigte Container mit dem remove-Befehl.
Container-Namen vergeben
Verwenden Sie sprechende Namen für Ihre Container, um sie leichter identifizieren zu können:
"Erstelle einen Container mit dem Namen 'webautomation'"
Dateien strukturiert ablegen
Hochgeladene Dateien werden standardmäßig unter /tmp gespeichert. Organisieren Sie Ihre Dateien in Unterverzeichnissen:
mkdir -p /tmp/projekt1/eingaben mkdir -p /tmp/projekt1/ausgaben
Ressourcen freigeben
Löschen Sie Container, die Sie nicht mehr benötigen:
"Lösche meinen Container 'webautomation'"
Desktop für komplexe Interaktionen
Für Aufgaben, die manuelle Interaktion erfordern (etwa Multi-Faktor-Authentifizierung), können Sie den Desktop-Link verwenden:
"Gib mir den anklickbaren Link zu meinem Container-Desktop"
Jede Sandbox enthält einen MCP Hub (Model Context Protocol), der umfangreiche Tools für Shell-Befehle und Browser-Automatisierung bereitstellt. Diese Tools werden automatisch durch das Tool albert_ai_sandbox_mcp verfügbar gemacht.
Die bash-mcp Tools ermöglichen die Ausführung von Shell-Befehlen direkt im Container:
| Tool | Beschreibung |
|---|---|
| bash-mcp-run | Führt einen Shell-Befehl aus und gibt die Ausgabe zurück. Parameter:
|
| bash-mcp-run_background | Startet einen Befehl im Hintergrund. Parameter:
|
| bash-mcp-kill_background | Beendet einen Hintergrundprozess. Parameter:
|
| bash-mcp-list_background | Listet alle laufenden Hintergrundprozesse auf. |
Die playwright-browser Tools ermöglichen vollständige Browser-Automatisierung mit Chromium:
Navigation und Seitensteuerung
| Tool | Beschreibung |
|---|---|
| playwright-browser_navigate | Navigiert zu einer URL. Parameter: url (URL der aufzurufenden Webseite) |
| playwright-browser_navigate_back | Geht zurück zur vorherigen Seite. |
| playwright-browser_tabs | Verwaltet Browser-Tabs (list, new, close, select). Parameter:
|
| playwright-browser_close | Schließt die aktuelle Seite. |
| playwright-browser_resize | Passt die Browsergröße an. Parameter: width, height (in Pixel) |
Interaktion mit Elementen
| Tool | Beschreibung |
|---|---|
| playwright-browser_click | Klickt auf ein Element. Parameter:
|
| playwright-browser_type | Gibt Text in ein Element ein. Parameter:
|
| playwright-browser_fill_form | Füllt mehrere Formularfelder aus. Parameter: Array von Feldern mit name, type, ref und value |
| playwright-browser_select_option | Wählt Optionen in Dropdown-Menüs aus. Parameter: element, ref, values (Array) |
| playwright-browser_hover | Bewegt die Maus über ein Element. |
| playwright-browser_drag | Drag & Drop zwischen zwei Elementen. Parameter: startElement, startRef, endElement, endRef |
| playwright-browser_press_key | Drückt eine Taste. Parameter: key (z.B. "Enter", "ArrowLeft", "a") |
Seitenanalyse und Informationsgewinnung
| Tool | Beschreibung |
|---|---|
| playwright-browser_snapshot | Erstellt einen barrierefreien Snapshot der Seite mit strukturierten Element-Referenzen. Wichtig: Dies ist die bevorzugte Methode zur Seitenanalyse - besser als Screenshots! |
| playwright-browser_take_screenshot | Erstellt einen Screenshot der Seite oder eines Elements. Parameter:
Hinweis: Für Aktionen verwenden Sie browser_snapshot! |
| playwright-browser_console_messages | Gibt alle Konsolen-Nachrichten seit Laden der Seite zurück. |
| playwright-browser_network_requests | Gibt alle Netzwerk-Anfragen seit Laden der Seite zurück. |
| playwright-browser_evaluate | Führt JavaScript-Code auf der Seite oder in einem Element aus. Parameter:
|
Datei-Upload und Dialoge
| Tool | Beschreibung |
|---|---|
| playwright-browser_file_upload | Lädt eine oder mehrere Dateien hoch. Parameter: paths (Array von absoluten Pfaden)
Hinweis: Dateien müssen zuerst mit sandbox_upload in den Container geladen werden! |
| playwright-browser_handle_dialog | Behandelt Browser-Dialoge (alerts, confirms, prompts). Parameter:
|
Hilfsfunktionen
| Tool | Beschreibung |
|---|---|
| playwright-browser_wait_for | Wartet auf bestimmte Bedingungen. Parameter:
|
| playwright-browser_install | Installiert den Browser (falls noch nicht vorhanden). Hinweis: Normalerweise nicht nötig, Browser ist vorinstalliert. |
Webseite aufrufen und Daten extrahieren
Formular ausfüllen und absenden
Datei verarbeiten und hochladen
Jede Sandbox enthält einen vollständigen Linux-Desktop, der über noVNC im Browser zugänglich ist. Dies ermöglicht visuelle Interaktion mit dem Container, wenn automatisierte Prozesse nicht ausreichen.
Der Desktop in jeder Sandbox bietet:
Der Desktop ist über eine eindeutige URL erreichbar. Nach dem Erstellen eines Containers erhalten Sie die Desktop-URL:
http://<sandbox-server>/<container-name>/
Beispiel:
http://10.0.1.61/sbx-abc123/
Sie können die URL auch jederzeit von der KI erfragen:
"Gib mir den Link zum Desktop meines Containers"
Der Desktop wird über noVNC bereitgestellt, einen browserbasierten VNC-Client:
| Anwendungsfall | Beschreibung |
|---|---|
| Multi-Faktor-Authentifizierung | Wenn eine Webseite 2FA verlangt, können Sie im Desktop-Browser den Code eingeben oder eine Authentifizierungs-App verwenden. |
| Visuelle Prüfung | Überprüfen Sie, wie eine Webseite dargestellt wird, oder kontrollieren Sie das Ergebnis einer Browser-Automation visuell. |
| Debugging | Untersuchen Sie Fehler bei der Automatisierung durch direktes Nachvollziehen der Schritte im Browser. |
| Manuelle Downloads | Laden Sie Dateien manuell herunter, wenn Automatisierung nicht möglich ist (z.B. CAPTCHA). |
| Datei-Überprüfung | Öffnen Sie erzeugte Dateien im Container, um das Ergebnis vor dem Download zu prüfen. |
Wenn für 10 Minuten keine Aktivität stattfindet (weder API-Aufrufe noch Desktop-Nutzung), wird der Container automatisch gestoppt. Der Desktop bleibt dabei erhalten:
start wird der Desktop in demselben Zustand wiederhergestelltTipp: Sie können den Desktop parallel zur KI-Automatisierung nutzen. Öffnen Sie einfach die Desktop-URL in einem neuen Tab, während die KI im Hintergrund arbeitet.
Dieser Abschnitt zeigt typische Anwendungsfälle für ALBERT | AI Sandbox und wie Sie diese in der Praxis umsetzen.
Aufgabe an die KI:
"Öffne https://www.agorum.com im Browser und klicke auf dem Cookie-Banner auf 'Einstellung speichern'"
Was passiert:
Aufgabe an die KI:
"Fülle das Kontaktformular auf example.com aus mit: Name: Max Mustermann E-Mail: max@example.com Nachricht: Dies ist ein Test"
Ergebnis: Die KI navigiert zur Seite, identifiziert alle Formularfelder und füllt sie automatisch aus.
Aufgabe an die KI (mit angehängter SVG-Datei):
"Konvertiere diese SVG-Datei in ein PNG mit 1024 Pixeln für die längste Seite"
Was passiert:
convert input.svg -resize 1024x1024 output.pngAufgabe an die KI:
"Erstelle ein Bash-Skript, das alle PNG-Dateien in JPG konvertiert, und führe es aus"
Ergebnis: Die KI erstellt ein Skript, macht es ausführbar und führt es im Container aus.
Aufgabe an die KI:
"Erstelle ein Python-Skript, das die API https://api.example.com/data abfragt, die JSON-Antwort verarbeitet und als CSV-Datei speichert"
Was passiert:
Aufgabe an die KI:
"Rufe https://example.com/produkte auf, extrahiere alle Produktnamen und Preise, und erstelle eine Excel-Datei mit den Daten"
Workflow:
Aufgabe an die KI (mit angehängtem PDF):
"Lade dieses PDF auf upload.example.com hoch und lade das verarbeitete Ergebnis herunter"
Workflow:
Best Practices: