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_albert_ai_sandbox_mcp

Anzeigename: ALBERT | AI Sandbox MCP

Was macht das Tool?

Dieses Tool stellt eine umfassende Sandbox-Umgebung für KI-gestützte Tests und Automatisierungen bereit. Es bietet Zugriff auf mehrere MCP-Server (Model Context Protocol), die verschiedene Funktionalitäten zur Verfügung stellen:

Das Tool fungiert als zentrale Schnittstelle zu einem HTTP-basierten MCP-Server mit Token-basierter Authentifizierung (Token: 'albert').

Empfohlener Einsatzzweck

Das Tool eignet sich ideal für:

Funktionsbeschreibung

Bash-MCP Tools

bash-mcp-run

Parameter Beschreibung
command
(Pflicht)
Der auszuführende Shell-Befehl.
cwd
(Optional)
Das Arbeitsverzeichnis, in dem der Befehl ausgeführt werden soll.
timeout
(Optional)
Timeout in Millisekunden für die Befehlsausführung.

Standard: 30000

 

bash-mcp-run_background

Parameter Beschreibung
command
(Pflicht)
Der Befehl, der im Hintergrund ausgeführt werden soll.
name
(Pflicht)
Ein eindeutiger Name für diesen Hintergrundprozess zur späteren Identifikation.
cwd
(Optional)
Das Arbeitsverzeichnis für den Hintergrundprozess.

 

bash-mcp-kill_background

Parameter Beschreibung
name
(Pflicht)
Der Name des Hintergrundprozesses, der beendet werden soll.

 

bash-mcp-list_background

Keine Parameter erforderlich. Listet alle laufenden Hintergrundprozesse auf.

Playwright Browser-MCP Tools

playwright-browser_navigate

Parameter Beschreibung
url
(Pflicht)
Die URL, zu der navigiert werden soll.

 

playwright-browser_click

Parameter Beschreibung
element
(Pflicht)
Menschenlesbare Beschreibung des Elements, mit dem interagiert werden soll.
ref
(Pflicht)
Exakte Element-Referenz aus dem Seiten-Snapshot.
doubleClick
(Optional)
Gibt an, ob ein Doppelklick statt eines einfachen Klicks ausgeführt werden soll.
  • true: Doppelklick ausführen
  • false: Einfacher Klick
button
(Optional)
Die zu klickende Maustaste. Mögliche Werte:
  • left
  • right
  • middle
Standard: left
modifiers
(Optional)
Modifikatortasten, die während des Klicks gedrückt werden sollen. Array mit Werten:
  • Alt
  • Control
  • ControlOrMeta
  • Meta
  • Shift

 

playwright-browser_type

Parameter Beschreibung
element
(Pflicht)
Menschenlesbare Beschreibung des editierbaren Elements.
ref
(Pflicht)
Exakte Element-Referenz aus dem Seiten-Snapshot.
text
(Pflicht)
Der Text, der in das Element eingegeben werden soll.
submit
(Optional)
Gibt an, ob nach der Texteingabe Enter gedrückt werden soll.
  • true: Enter nach Texteingabe drücken
  • false: Kein Enter drücken
slowly
(Optional)
Gibt an, ob der Text Zeichen für Zeichen eingegeben werden soll.
  • true: Einzelne Zeichen eingeben (nützlich für Key-Handler)
  • false: Gesamten Text auf einmal einfügen
Standard: false

 

playwright-browser_snapshot

Keine Parameter erforderlich. Erfasst einen Accessibility-Snapshot der aktuellen Seite. Dies ist besser als ein Screenshot für Interaktionen.

 

playwright-browser_take_screenshot

Parameter Beschreibung
type
(Optional)
Bildformat für den Screenshot. Mögliche Werte:
  • png
  • jpeg
Standard: png
filename
(Optional)
Dateiname zum Speichern des Screenshots.

Standard: page-{timestamp}.{png|jpeg}
element
(Optional)
Menschenlesbare Element-Beschreibung für Element-Screenshots. Wenn angegeben, muss auch ref angegeben werden.
ref
(Optional)
Exakte Element-Referenz für Element-Screenshots. Wenn angegeben, muss auch element angegeben werden.
fullPage
(Optional)
Gibt an, ob ein Screenshot der gesamten scrollbaren Seite erstellt werden soll.
  • true: Vollständige Seite erfassen
  • false: Nur sichtbaren Viewport erfassen
Hinweis: Kann nicht mit Element-Screenshots kombiniert werden.

 

playwright-browser_fill_form

Parameter Beschreibung
fields
(Pflicht)
Array von Formularfeldern, die ausgefüllt werden sollen. Jedes Feld-Objekt enthält:
  • name: Menschenlesbarer Feldname (Pflicht)
  • type: Feldtyp - textbox, checkbox, radio, combobox oder slider (Pflicht)
  • ref: Exakte Feld-Referenz aus dem Seiten-Snapshot (Pflicht)
  • value: Wert zum Ausfüllen. Bei checkbox "true" oder "false", bei combobox der Optionstext (Pflicht)

 

playwright-browser_select_option

Parameter Beschreibung
element
(Pflicht)
Menschenlesbare Element-Beschreibung des Dropdown-Menüs.
ref
(Pflicht)
Exakte Element-Referenz aus dem Seiten-Snapshot.
values
(Pflicht)
Array von Werten, die im Dropdown ausgewählt werden sollen. Kann ein einzelner Wert oder mehrere Werte sein.

 

playwright-browser_evaluate

Parameter Beschreibung
function
(Pflicht)
JavaScript-Ausdruck zur Ausführung auf der Seite oder einem Element. Format: () => { /* code */ } oder (element) => { /* code */ } wenn element angegeben ist.
element
(Optional)
Menschenlesbare Element-Beschreibung für Element-bezogene Evaluierung.
ref
(Optional)
Exakte Element-Referenz aus dem Seiten-Snapshot für Element-bezogene Evaluierung.

 

playwright-browser_hover

Parameter Beschreibung
element
(Pflicht)
Menschenlesbare Beschreibung des Elements, über das gehovert werden soll.
ref
(Pflicht)
Exakte Element-Referenz aus dem Seiten-Snapshot.

 

playwright-browser_drag

Parameter Beschreibung
startElement
(Pflicht)
Menschenlesbare Beschreibung des Quell-Elements.
startRef
(Pflicht)
Exakte Quell-Element-Referenz aus dem Seiten-Snapshot.
endElement
(Pflicht)
Menschenlesbare Beschreibung des Ziel-Elements.
endRef
(Pflicht)
Exakte Ziel-Element-Referenz aus dem Seiten-Snapshot.

 

playwright-browser_wait_for

Parameter Beschreibung
time
(Optional)
Die Wartezeit in Sekunden.
text
(Optional)
Der Text, auf dessen Erscheinen gewartet werden soll.
textGone
(Optional)
Der Text, auf dessen Verschwinden gewartet werden soll.

 

playwright-browser_press_key

Parameter Beschreibung
key
(Pflicht)
Name der zu drückenden Taste oder ein zu generierendes Zeichen, z.B. "ArrowLeft" oder "a".

 

playwright-browser_tabs

Parameter Beschreibung
action
(Pflicht)
Die auszuführende Operation. Mögliche Werte:
  • list - Alle Tabs auflisten
  • new - Neuen Tab erstellen
  • close - Tab schließen
  • select - Tab auswählen
index
(Optional)
Tab-Index für close/select-Aktionen. Wenn bei close nicht angegeben, wird der aktuelle Tab geschlossen.

 

playwright-browser_resize

Parameter Beschreibung
width
(Pflicht)
Breite des Browserfensters in Pixel.
height
(Pflicht)
Höhe des Browserfensters in Pixel.

 

playwright-browser_navigate_back

Keine Parameter erforderlich. Navigiert zur vorherigen Seite zurück.

 

playwright-browser_close

Keine Parameter erforderlich. Schließt die aktuelle Seite.

 

playwright-browser_console_messages

Keine Parameter erforderlich. Gibt alle Konsolen-Nachrichten zurück.

 

playwright-browser_network_requests

Keine Parameter erforderlich. Gibt alle Netzwerkanfragen seit dem Laden der Seite zurück.

 

playwright-browser_file_upload

Parameter Beschreibung
paths
(Optional)
Array mit absoluten Pfaden zu den hochzuladenden Dateien. Kann eine oder mehrere Dateien enthalten. Wenn weggelassen, wird die Dateiauswahl abgebrochen.

 

playwright-browser_handle_dialog

Parameter Beschreibung
accept
(Pflicht)
Gibt an, ob der Dialog akzeptiert werden soll.
  • true: Dialog akzeptieren
  • false: Dialog ablehnen
promptText
(Optional)
Der Text des Prompts bei einem Prompt-Dialog.

 

playwright-browser_install

Parameter Beschreibung
Keine Parameter erforderlich. Installiert den in der Konfiguration angegebenen Browser. Nur aufrufen, wenn ein Fehler auftritt, dass der Browser nicht installiert ist.

Beispiel-Prompt

Navigiere zur agorum Website und erstelle einen Screenshot:
1. Öffne die Seite https://www.agorum.com
2. Warte 2 Sekunden
3. Erstelle einen Screenshot der gesamten Seite
4. Zeige mir alle Konsolennachrichten

Oder:

Führe folgenden Bash-Befehl aus: ls -la /tmp und zeige mir das Ergebnis
  

Tipps und Tricks

Tipps:

  • Snapshot vor Interaktionen: Verwenden Sie immer zuerst playwright-browser_snapshot, um die Struktur der Seite zu erfassen, bevor Sie mit Elementen interagieren. Der Snapshot liefert die benötigten Element-Referenzen (ref).
  • Warte auf Seiteninhalte: Nutzen Sie playwright-browser_wait_for nach Navigation oder Klicks, um sicherzustellen, dass die Seite vollständig geladen ist.
  • Hintergrundprozesse: Lange laufende Befehle sollten mit bash-mcp-run_background gestartet werden. Mit bash-mcp-list_background könnnen Sie den Status überprüfen.
  • Browser-Installation: Falls Fehler wegen fehlendem Browser auftreten, rufen Sie einmalig playwright-browser_install auf.
  • Debugging: Nutzen Sie playwright-browser_console_messages und playwright-browser_network_requests für detaillierte Informationen über die Browser-Aktivitäten.
  • Screenshots vs. Snapshots: Verwenden Sie für Interaktionen immer Snapshots. Screenshots sind nur für visuelle Dokumentation gedacht.