Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen


agorum_ai_agents_library_basic_sandbox_tools_group

Anzeigename: All Sandbox-Tools

Was macht die Toolgruppe?

Diese Toolgruppe stellt alle notwendigen Tools zur Verfügung, um mit ALBERT | AI Sandbox Servern zu arbeiten.
Eine Sandbox ist eine isolierte Rechenumgebung, die MCP-Services (Model Context Protocol) mit verschiedenen Tools bereitstellt, die von der KI genutzt werden können. Die Toolgruppe ermöglicht das vollständige Management von Sandboxes sowie den bidirektionalen Dateitransfer zwischen agorum core und den Sandbox-Umgebungen. Zusätzlich werden Tools zur Verfügung gestellt, um Links zu agorum core Objekten zu generieren und Bilder für die KI-Verarbeitung bereitzustellen.

Empfohlener Einsatzzweck

Diese Toolgruppe ist ideal für folgende Anwendungsfälle:

Tools in der Toolgruppe

Tool Kurzbeschreibung Dokumentationslink
sandbox_manage Verwaltet Sandboxes auf einem ALBERT | AI Sandbox Server. Unterstützt Operationen wie list, status, create, remove, start, stop und restart. Eine Sandbox ist eine Rechenumgebung, die MCP-Services mit Tools bereitstellt, die von der KI genutzt werden können. Dokumentation
sandbox_download Lädt eine Datei von einem ALBERT | AI Sandbox Server herunter und speichert sie in agorum core. Es muss der absolute Pfad zur Datei angegeben werden. Gibt Informationen über die heruntergeladene temporäre Datei zurück. Dokumentation
sandbox_upload Lädt eine Datei aus agorum core auf einen ALBERT | AI Sandbox Server hoch. Gibt den Pfad zurück, unter dem die Datei auf dem Sandbox-Server gespeichert wurde. Dokumentation
get_agorum_core_link Erstellt einen Markdown-Link zu einem agorum core Objekt. Falls verfügbar, wird auch ein imageLink bereitgestellt, der dem Benutzer die Interaktion mit dem Objekt ermöglicht. Dokumentation
get_object_as_image Erstellt einen Markdown-Link zu einem agorum core Bildobjekt und macht das Bild für die KI nutzbar. Das Bild wird in die KI-Historie eingefügt, sodass die KI/LLM das Bild verwenden kann. Dokumentation
albert_ai_sandbox_mcp Stellt MCP-Tools (Model Context Protocol) für die Sandbox-Umgebung bereit. Beinhaltet umfangreiche Bash-Befehle (run, run_background, kill_background, list_background) und Playwright-Browser-Tools für Web-Automatisierung (navigate, click, type, screenshot, snapshot, form filling, file upload, dialog handling und vieles mehr). Dokumentation

Tipps und Tricks

Standardvorgehensweise für die Nutzung einer Sandbox

  1. Listen Sie zunächst alle verfügbaren Sandboxes mit dem list-Befehl auf
  2. Wenn genau eine Sandbox gefunden wird, verwenden Sie diese
    • Prüfen Sie den Status und starten Sie die Sandbox bei Bedarf
  3. Wenn mehrere Sandboxes gefunden werden, geben Sie an, welche verwendet werden soll
    • Prüfen Sie den Status und starten Sie die ausgewählte Sandbox bei Bedarf
  4. Wenn keine Sandbox gefunden wird, erstellen Sie eine neue und verwenden Sie diese

Typischer Workflow für Dateiverarbeitung

  1. Erstellen oder identifizieren Sie eine laufende Sandbox
  2. Laden Sie die zu verarbeitende Datei aus agorum core mit sandbox_upload in die Sandbox hoch
  3. Führen Sie die gewünschte Verarbeitung mit den MCP-Tools (z.B. Bash-Befehle) aus
  4. Laden Sie das Ergebnis mit sandbox_download zurück nach agorum core
  5. Erstellen Sie einen Link zum heruntergeladenen Objekt mit get_agorum_core_link für den Benutzer

Hinweis: Beim Download von Dateien aus der Sandbox muss immer der absolute Pfad angegeben werden (z.B. /tmp/name.png).

Achtung: Die MCP-Tools (agorum_ai_agents_library_basic_albert_ai_sandbox_mcp) bieten sehr umfangreiche Funktionen für Shell-Befehle und Browser-Automatisierung. Stellen Sie sicher, dass Sie die Sicherheitsrichtlinien Ihrer Organisation beachten, wenn Sie Shell-Befehle in der Sandbox ausführen.