Workflows

Zugriff über: Prozesse → Workflows

Ein Workflow ist eine Automatisierung, die eine Abfolge von Schritten über deine Amazon-Daten ausführt, entweder auf Abruf oder gemäß einem Zeitplan. Er ermöglicht es dir, Produkte zu auditieren, Probleme zu erkennen und Prüfaufgaben zu erstellen, ohne es manuell tun zu müssen.

Wie werden sie erstellt?

Heute gibt es zwei Wege, einen Workflow in Epinium zu erstellen:

• Aus einer Vorlage — durch Klonen einer Vorlage aus der Vorlagenbibliothek. Das ist der empfohlene und schnellste Weg.
• Mit VelaxAI — beschreibe in natürlicher Sprache, was du automatisieren möchtest, und VelaxAI erzeugt den Workflow.

Es gibt noch keine Option, einen Workflow von Grund auf auf einer leeren Arbeitsfläche zu erstellen. Sobald der Workflow existiert (geklont aus einer Vorlage oder generiert von VelaxAI), kannst du ihn frei bearbeiten: Trigger, Bedingungen, Code, Verbindungen usw. ändern.

Workflow, Aufgabe oder VelaxAI?

• Workflow — für wiederkehrende Regeln, die periodisch laufen (jeden Montag, jeden 1. des Monats).
• Aufgabe — um die Vorschläge zu prüfen und zu genehmigen, die ein Workflow (oder VelaxAI) erzeugt.
• VelaxAI — für punktuelle Anfragen in natürlicher Sprache und um neue Workflows zu erstellen.

Workflow-Status

Ein Workflow kann sich in einem dieser drei Zustände befinden:

Status	Bedeutung
Pausiert	Konfiguriert, läuft aber nicht automatisch. Das ist der Standardzustand nach dem Klonen einer Vorlage. Manuelle Ausführung bleibt möglich.
Aktiv	Läuft automatisch gemäß seinem Trigger.
Mit Validierungsfehlern	Der Editor hat ein Problem im Graphen entdeckt (nicht verbundener Knoten, leere Bedingung, gebrochene Referenz). Kann nicht aktiviert werden, bis er korrigiert ist.

Der visuelle Editor

Der Editor zeigt den Workflow als Graphen: jede Box ist ein Knoten (ein Schritt) und jede Linie eine Verbindung (was als Nächstes kommt).

• Arbeitsfläche — du kannst Knoten verschieben, um visuell umzuorganisieren. Es beeinflusst die Logik nicht.
• Verbindungen — manche sind einfach (ein einziger Ausgangspfad). Andere verzweigen sich: eine Bedingung hat Ausgänge Ja und Nein; eine Schleife hat pro Element (für jedes Element) und am Ende (wenn die Iteration endet).
• Knoten konfigurieren — ein Klick auf einen Knoten öffnet ein Fenster, in dem du seine Parameter bearbeiten kannst: Nachricht, URL, Bedingung, Variablenzuweisung usw.
• Code eines Knotens bearbeiten — der Knoten Code ausführen öffnet einen Editor, in dem du das Skript lesen und ändern kannst (von VelaxAI generiert oder aus der Vorlage kopiert).
• Automatische Validierung — der Editor markiert Fehler rot (verwaiste Knoten, gebrochene Verbindungen, Bedingungen ohne Operator). Wenn es Fehler gibt, kann der Workflow nicht aktiviert werden.

Knotentypen

Das sind die verfügbaren Knoten:

Knoten	Was er tut
Start	Markiert, wo der Fluss beginnt. Jeder Workflow hat genau einen Startknoten.
Ende	Markiert einen Endpunkt. Ein Workflow kann mehrere Endknoten haben (z. B. einer pro Verzweigung).
Aktion	Führt eine konkrete Aufgabe aus. Hat mehrere Untertypen (siehe nächste Tabelle).
Bedingung	Ja / Nein-Verzweigung basierend auf einem Feld und einem Operator (gleich, größer als, enthält, ist leer…).
Multi-Verzweigung	Wie eine Bedingung, aber mit mehreren Ausgängen je nach Feldwert. Nützlich, wenn mehr als zwei Fälle möglich sind.
Schleife (Für jedes)	Iteriert über eine Menge von Elementen (Produkte, Kampagnen, Search Terms…). Siehe § Schleifen.
Wartezeit	Pausiert den Fluss für eine Dauer (Sekunden, Minuten, Stunden), bevor er fortgesetzt wird.

Untertypen des Knotens Aktion:

Untertyp	Was er tut
Log-Nachricht	Schreibt eine Nachricht ins Ausführungsprotokoll. Nützlich zum Debuggen oder um Spuren zu hinterlassen.
HTTP-Anfrage	Ruft eine externe URL auf (ein Webhook, eine Integration mit einem anderen System). Erlaubt das Senden von Daten an Drittanbieter-Tools.
Code ausführen	Führt eigene Logik in einer Sandbox aus. Das ist der Motor hinter den Checks der Audit-Vorlagen: er bewertet komplexe Regeln über ein Produkt und gibt ein strukturiertes Ergebnis zurück. Du kannst das Skript im Editor lesen und ändern.
Aufgabe erstellen	Generiert oder aktualisiert eine Aufgabe mit einem oder mehreren Elementen zur menschlichen Prüfung. Siehe § Aufgaben und menschliche Überwachung.
Aufgabe lösen	Markiert die Elemente einer Aufgabe als gelöst, deren Probleme nicht mehr existieren (weil sie behoben wurden).

Trigger

Ein Workflow kann auf zwei Weisen gestartet werden:

• Manuell — Schaltfläche Ausführen auf der Workflow-Seite. Öffnet ein Fenster, das die geschätzten maximalen Kosten vor der Bestätigung anzeigt.
• Geplant — der Workflow startet automatisch gemäß einem Zeitplan:
  • Cron — standardmäßige 5-Felder-Cron-Expression. Beispiele: jeden Montag um 9:00, am 1. jedes Monats um 5:00.
  • Intervall — alle N Minuten, Stunden oder Tage.
  • Einmaliges Datum — eine einzige Ausführung zu einem bestimmten Datum/Uhrzeit.
• Zeitzone — pro Workflow konfigurierbar (z. B. Europe/Berlin). Der Trigger wird in dieser Zeitzone interpretiert, nicht in UTC.

Geschätzte Kosten

Vor der manuellen Ausführung eines Workflows berechnet und zeigt Epinium die maximalen Kosten in Credits an. Diese Zahl spiegelt den schlimmsten Fall wider (alle auditierten Produkte, alle Knoten ohne Sprünge ausgeführt).

Prüfe die Kosten vor dem Aktivieren

Wenn du einen geplanten Workflow aktivieren willst, der über den gesamten Katalog iteriert, führe ihn zuerst manuell aus, um die tatsächlichen Kosten zu sehen. Auf großen Katalogen kann eine versehentlich tägliche Ausführung mehr Credits verbrauchen als erwartet.

Schleifen (Für jedes)

Ein Für jedes-Knoten wiederholt die enthaltenen Schritte einmal pro Element einer Liste.

Datenquelle — zwei Modi:

• Abfrage — wähle eine Sammlung aus deinem Konto (Produkte, Kampagnen, Search Terms, Ad Groups, Product Ads, Keywords, Cluster) und wende Filter an, um sie einzugrenzen. Das ist der am häufigsten verwendete Modus.
• Referenz — iteriert über eine Liste, die ein vorheriger Knoten erzeugt hat (z. B. das Ergebnis einer HTTP-Anfrage).

Fehlerbehandlung pro Element — wenn die Auswertung eines Elements fehlschlägt, kann die Schleife:

• Fortfahren (Standard) — weitere Elemente weiterverarbeiten.
• Abbrechen — die gesamte Schleife stoppen.

Ergebnisse sammeln — optional kann die Schleife das, was jede Iteration erzeugt, zu einer finalen Zusammenfassung aggregieren. Die Audit-Vorlagen nutzen das, um zu zählen, wie viele Produkte konform sind und wie viele nicht, und die Zusammenfassung im Log anzuzeigen.

Die Schleife hat zwei Ausgänge: pro Element (was für jedes Element ausgeführt wird) und am Ende (was läuft, sobald alle verarbeitet sind).

Variablen und Kontext

Workflows verwenden Variablen, um Daten zwischen Knoten zu übergeben. Die Syntax ist {{ ... }} und es gibt drei Quellen:

Variable	Woher sie kommt	Beispiel
{{trigger.X}}	An den Workflow übergebene Daten bei manueller Ausführung.	{{trigger.email}}
{{nodes.NAME.result.X}}	Ausgabe eines vorherigen Knotens.	{{nodes.checkTitle.result.titleTooLong}}
{{forEach.NAME}}	Das aktuelle Element, wenn du innerhalb einer Schleife bist. Standardmäßig heißt es item, aber Vorlagen verwenden häufig lesbarere Namen wie product.	{{forEach.product}}

Beispiel für die Verwendung in einer Bedingung: prüfen, ob das Ergebnis eines Code-Knotens anzeigt, dass der Titel zu kurz ist:

• Feld: {{nodes.checkTitle.result.titleTooLong}}
• Operator: ist wahr

Aufgaben und menschliche Überwachung

Workflows können Aufgaben erzeugen, damit ein Mensch ihre Ergebnisse prüft, bevor Änderungen angewendet werden. Das ist die Stärke des Systems: die Automatisierung erkennt Probleme, aber nichts wird angewendet, bis du genehmigst.

Knoten Aufgabe erstellen

Wenn ein Workflow ein Problem erkennt, erstellt dieser Knoten eine Aufgabe (oder fügt Elemente zu einer bestehenden Aufgabe hinzu). Elemente können einen Vorschlagswert (Auto-Fix) enthalten, den der Benutzer mit einem Klick akzeptieren kann.

• Idempotenz — der Workflow verwendet einen eindeutigen Schlüssel pro Problem. Eine erneute Ausführung dupliziert keine Aufgaben: sie fügt neue Elemente hinzu, wenn neue Probleme auftauchen, und lässt diejenigen in Ruhe, die bereits da waren.
• HITL (Human-in-the-Loop) — wenn aktiviert, werden Elemente nicht automatisch angewendet. Ein Mensch prüft und genehmigt sie, bevor sie das Produkt oder die Kampagne erreichen.

Knoten Aufgabe lösen

Markiert die Elemente einer Aufgabe als gelöst, deren Probleme nicht mehr existieren. Nützlich, wenn du einen Workflow erneut ausführst und ein Produkt, das zuvor fehlgeschlagen ist, nun konform ist — der Knoten schließt die zugehörigen Elemente automatisch.

Mehr Details zum Aufgabensystem in Aufgaben.

Ausführungsverlauf

Jede Ausführung eines Workflows wird registriert und kann von seiner Seite aus eingesehen werden. Mögliche Zustände:

Status	Bedeutung
Ausstehend	In Warteschlange, noch nicht begonnen.
Wird ausgeführt	Läuft gerade.
Abgeschlossen	Ohne Fehler beendet.
Fehlgeschlagen	Ein Knoten ist fehlgeschlagen und hat den Fluss abgebrochen.
Abgebrochen	Manuell gestoppt.

Ausführungs-Inspektor

Klicke auf einen Knoten innerhalb einer Ausführung, um den Inspektor zu öffnen und zu sehen:

• Eingang — die aufgelösten Variablen, die der Knoten erhalten hat.
• Ausgang — das Ergebnis, das er produziert hat.
• Fehler — falls vorhanden, mit lesbarer Nachricht.

Eine fehlgeschlagene Ausführung debuggen

Beginne beim ersten rot markierten Knoten. Lies seinen Ausgang oder Fehler. Prüfe die Eingangsvariablen — die meisten Fehler stammen von einer gebrochenen Referenz zu einem vorherigen Knoten oder von leeren Daten, wo ein Wert erwartet wurde.

Workflows mit VelaxAI erstellen

VelaxAI enthält einen spezialisierten Agenten, der Workflows aus natürlicher Sprache generiert. Der Benutzer beschreibt, was er automatisieren möchte, und VelaxAI schlägt einen vollständigen Workflow vor: Knoten, Verbindungen, Bedingungen und, wenn nötig, den Code der Code ausführen-Knoten.

Was du tun kannst:

• Dein Anliegen in einer Konversation beschreiben.
• Änderungen am ursprünglichen Vorschlag anfordern.
• Den generierten Code in den Code ausführen-Knoten manuell prüfen und bearbeiten.
• Den Trigger anpassen (Zeitplan, Intervall).
• Den Workflow aktivieren, wenn du zufrieden bist.

Generierung im Wandel

Die Generierung mit VelaxAI verbessert sich kontinuierlich. Sehr komplexe Workflows können nach der ersten Generierung manuelle Anpassungen erfordern — VelaxAI wird dir sagen, was fehlt oder zu prüfen ist.

Mehr zu VelaxAI in VelaxAI.

Bewährte Praktiken und Grenzen

• Aktiviere HITL, wenn der Workflow sensible Daten ändert (Preise, Titel, Beschreibungen, Kampagnenbudgets). Er gibt dir einen Kontrollpunkt, bevor die Änderung Amazon erreicht.
• Prüfe die geschätzten Kosten, bevor du einen geplanten Workflow aktivierst, besonders wenn er über den gesamten Katalog iteriert. Ein vorheriger manueller Lauf zeigt dir die tatsächlichen Kosten.
• Starte pausiert. Führe den Workflow einmal manuell aus, um das Ergebnis zu validieren, und aktiviere erst dann den Cron.
• Fehlgeschlagene Ausführungen wiederholen sich nicht von selbst. Wenn eine Ausführung fehlschlägt, öffne den Verlauf, identifiziere den fehlerhaften Knoten, behebe die Ursache und starte sie manuell erneut.
• Bevorzuge für Massen-Audits die Vorlagen — sie sind für die Verarbeitung großer Kataloge mit Batch-Verarbeitung und Fehlerbehandlung pro Element optimiert.