Arbeitsbereiche

Ein Arbeitsbereich ist ein Ordner, den Guida als Automatisierungsprojekt öffnet. Ein geöffneter Arbeitsbereich aktiviert persistenten Speicher (g.store), Arbeitswarteschlangen (g.queue), Volltextsuche (g.search), Ereignisauslöser und eigene MCP-Werkzeuge.

Arbeitsbereich öffnen

Wählen Sie File > Open Workspace oder den Toolbar-Button und wählen Sie einen Ordner. Guida erstellt die Standardstruktur, wenn sie noch nicht existiert.

Ordnerstruktur

my-workspace/
  scripts/              # Automatisierungsskripte (*.js, *.lua, *.janet)
  lib/                  # Gemeinsame Bibliotheken für JS, Lua und Janet
  views/                # Queue-Ansichten
  events.json           # Ereignisauslöser
  tools.json            # Eigene MCP-Werkzeuge
  queues.json           # Worker-Pool-Definitionen
  domains.json          # Zugelassene Domains für MCP
  workflows/            # Benannte Automatisierungspipelines
  store.db              # Persistenter Speicher
  queue.db              # Queue-Daten
  workflow-ledger.db    # Workflow-Run-/Item-Historie
  search-index/         # Volltextindex

Das Workspace-Panel listet automatisch .js-, .lua- und .janet-Dateien aus scripts/, lib/ und Workflow-Ordnern.

Datenbankdateien

Guida erstellt diese Dateien bei der ersten Nutzung der jeweiligen API:

• store.db - LiteDB-Datenbank für g.store.*
• queue.db - SQLite-Datenbank für StratQueue-gestützte g.queue.*-Operationen
• workflow-ledger.db - SQLite-Datenbank für Runs, Items, Events, verknüpfte Ausgaben, Leases, Wiederholungen und Wiederherstellung
• search-index/ - Lucene.NET-Index für g.search.*

Alle Daten sind arbeitsbereichslokal und reisen mit dem Ordner.

Für Archive nutzen Sie File > Backup Workspace… oder File > Backup Managed Workspace Files…. Details stehen unter Arbeitsbereich-Backups.

Konfigurationsdateien

events.json

Ereignisse starten Skripte automatisch:

{
  "triggers": [
    {
      "event": "url-match",
      "pattern": "https://example.com/products/*",
      "script": "scripts/extract-product.js"
    },
    {
      "event": "page-loaded",
      "script": "scripts/inject-styles.js"
    }
  ]
}

Event	Muster	Auslösung
url-match	Glob-Muster	Navigation endet auf passender URL
page-loaded	-	Eine Seite ist geladen
tab-created	-	Ein neuer Tab wurde erstellt
tab-closed	-	Ein Tab wurde geschlossen
tab-activated	-	Ein Tab wurde aktiv
dom-mutation	CSS-Selektor	Ein beobachtetes DOM-Element ändert sich
external-queue	-	Ein Poll-Skript liefert Arbeit

dom-mutation nutzt MutationObserver für reaktive Beobachtung, zum Beispiel Preisänderungen oder Dashboardwerte. external-queue fragt externe Quellen regelmäßig ab. Trigger-Skripte können Kontext über g.trigger.getContext() lesen.

tools.json

Eigene Werkzeuge für externe KI-Agenten. Siehe Eigene Werkzeuge.

queues.json

Deklarative Worker-Pools. Siehe Warteschlangen-Worker.

domains.json

Zugelassene Domains für MCP-Navigation:

{
  "allowedDomains": [
    "example.com",
    "*.example.com",
    "trusted-site.org"
  ]
}

Siehe MCP-Integration.

Arbeitsbereichsgebundene Dienste

Diese APIs benötigen einen geöffneten Arbeitsbereich:

API	Beschreibung
g.store.*	Persistenter Dokumentenspeicher
g.queue.*	Transaktionale Arbeitswarteschlangen
g.search.*	Volltextindex
g.workers.*	Queue-Worker-Pools
g.workflows.*	Workflow-Inspektion und Wechsel

Kern-APIs wie g.dom.click, g.nav.navigateToUrl und g.tabs.getTabs funktionieren auch ohne Arbeitsbereich.

Nächste Schritte

• Scripting-Überblick - die g.*-API kennenlernen
• Seitendaten extrahieren und speichern - lokalen Speicher praktisch nutzen
• URLs in eine Warteschlange stellen und verarbeiten - Queue-basierte Browserautomatisierung
• Workflows - mehrere Pipelines in einem Arbeitsbereich organisieren
• Arbeitsbereich-Backups - Arbeitsbereiche und Guida-Daten sicher archivieren
• Eigene Werkzeuge - Arbeitsbereichsskripte per MCP bereitstellen