Workspace einrichten

Was ein neu angelegter Workspace braucht, bevor die erste Automatisierung läuft.

Wenn du einen neuen Workspace bekommst, ist er leer. Hier ist die Reihenfolge, in der du am schnellsten produktiv wirst.

#1. Workspace-Code kennen

Du brauchst den Code deines Workspace (z. B. mecomedia). Er ist:

• Der Name deines Config-Ordners
• Der Wert für --tenant=<code> in allen CLI-Befehlen
• Der URL-Slug in manchen öffentlichen Endpunkten

#2. Grundgerüst anlegen

Dein Workspace-Ordner sollte diese Dateien und Unterordner haben. Lege sie an, auch wenn sie zunächst leer sind:

apis.php                ← externe API-Definitionen
prompts/                ← wiederverwendbare Prompt-Snippets
assistants/           ← eine Datei pro Task
scheduled.php     ← automatische Task-Ausführungen
tools/                  ← eigene Tool-Definitionen
public.php         ← welche Tools ein nicht eingeloggter Chat sehen darf

Details zu Inhalten: Workspace-Config.

#3. Erste Integration anbinden

Wähle einen externen Dienst, den du automatisieren willst — Google Drive, Dropbox, eine eigene REST-API, eine Datenbank.

• Für OAuth-basierte Dienste (Google, Dropbox): gehe auf /manage/o-auth-connections und verbinde sie.
• Für Dienste mit statischen API-Keys: trage sie in apis.php ein.

Siehe OAuth-Flow.

#4. Erstes Tool anlegen

Beginne klein. Ein Tool, das eine einzige Sache kann — zum Beispiel „Liste meine letzten 10 Dateien in Dropbox auf".

Lege eine Datei in deinem Workspace an: tools/dropbox/listRecent.php. Siehe Tools — Überblick und Tool als Config-Datei anlegen.

#5. Erstes Tool testen

Nicht raten, ob es klappt. Installiere die TaskMonkey CLI und teste direkt:

tm test-tool listRecent limit=10

Siehe Tools testen.

#6. Ersten Assistant bauen

Erstelle assistants/mein-assistent.php in deinem Workspace mit Name, Prompt und der Tool-Liste, die dieser Task nutzen darf. Danach erscheint der Task im Dashboard.

Siehe Assistenten.

#7. Scheduled machen (optional)

Wenn der Task regelmäßig laufen soll (z. B. „jede Nacht neue E-Mails einsortieren"), trage ihn in scheduled.php ein. Die Betriebsseite führt deine Scheduled Tasks dann automatisch in den konfigurierten Intervallen aus.

Siehe Scheduled Tasks.

#Empfohlener Ablauf

Erst manuell im Chat austesten → dann zum Assistant promoten → erst wenn's stabil ist, scheduled machen.

So merkst du Fehler früh und riskierst keine automatisierten Aktionen mit kaputten Prompts.