RPA-Abläufe

Workflows sind gespeicherte Definitionen. Das Ausführen ist eine getrennte Aktion mit eigenem Ergebnis und Abbruchpfad.

Vorhandenen Ablauf prüfen und ausführen

HTTP

GET /api/v1/automation/workflows
POST /api/v1/automation/workflows/{id}/run
GET /api/v1/automation/runs
POST /api/v1/automation/runs/{id}/cancel

Prüfe steps und profile_ids vor der Ausführung. Verwende runtime:control zusammen mit rpa:write für die Konfiguration oder rpa:run für die Ausführung. Auflisten oder Kopieren gespeicherter Abläufe benötigt außerdem secrets:read, da Definitionen entschlüsselte Werte enthalten können. MCP-Tokens können secrets:read nicht erhalten; diese Werkzeuge sind für sie nicht verfügbar. Die Ausführung prüft benötigte Cookie- und Geheimnisrechte auch in Unterabläufen vor dem Start und zwischen Schritten erneut. Widerruf kann einen bereits gesendeten Browserbefehl nicht rückgängig machen. Bewahre die zurückgegebenen Laufinformationen auf und prüfe die Laufliste auf Abschluss, Fehler und Abbruch. Eine angenommene Laufanfrage bedeutet keinen erfolgreichen Ablauf.

Definition erstellen

POST /api/v1/automation/workflows benötigt name, steps, profile_ids, concurrency, close_after, delay_ms und schedule. Lies das vollständige Schema der jeweiligen Schrittaktion: Die gemeinsame Schrittstruktur enthält viele optionale Felder, deren Bedeutung von action abhängt. Beginne mit einem kleinen Ablauf mit ausdrücklich ausgewählten Profilen.

JSON

{
  "name": "Example navigation",
  "steps": [
    {
      "action": "navigate",
      "value": "https://example.com"
    }
  ],
  "profile_ids": [
    "PROFILE_ID"
  ],
  "concurrency": 1,
  "close_after": false,
  "delay_ms": 0,
  "schedule": null
}

Das Schema erlaubt höchstens 500 Profil-IDs und Parallelität 1–20. Dies sind Validierungsgrenzen, keine Leistungs- oder Tarifzusage. Ein null-Schedule bedeutet keinen konfigurierten Zeitplan. Nutze vor dem Speichern eines Zeitplans /api/v1/automation/schedule/preview und prüfe Zeitzone und nächste Ausführungszeitpunkte.

Browser- und Eingabegrenzen

Verwende beobachtete Selektoren, den beabsichtigten Tab und ausdrücklichen Frame-Kontext. Unterstützung hängt von Browserengine, Seitentyp und Aktion ab; nicht jedes native Bedienelement, jede Erweiterungsseite oder Shadow-DOM-Operation ist austauschbar. Geschlossene Shadow Roots sind kein allgemein unterstütztes Ziel. Lies den tatsächlichen Schrittfehler und prüfe die geänderte Seite. Ein Ablaufabbruch macht abgeschlossene Schritte nicht rückgängig.