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.

Das Konfigurationsfenster eines Knotens

Das Zahnrad-Symbol (⚙️) jedes Knotens öffnet seine Konfiguration. Je nach Knotentyp erscheinen andere Tabs:

Tab	Was er enthält
Allgemein	Der Knotenname — der Text, der im Diagramm zu sehen ist. In allen Knoten vorhanden
Konfiguration	Die typspezifischen Parameter des Knotens: die Bedingung, die Aufgabendaten, die URL der HTTP-Anfrage…
Filter	Nur in Für jedes-Schleifen mit Quelle Abfrage: welche Elemente iteriert werden. Siehe § Filter der Schleife
Reduce-Code	Nur in Für jedes-Schleifen, die Ergebnisse sammeln: der Code, der sie zusammenfasst. Siehe § Reduce Code

Einen Knoten umbenennen — ändere es im Tab Allgemein. Gib ihm einen Namen, der sagt, was er tut („Titel prüfen", „In Slack benachrichtigen") statt des generischen: die Namen erscheinen im Diagramm, im Ausführungsverlauf und in den Variablenreferenzen anderer Knoten, ein klarer Name zahlt sich beim Debuggen also von selbst aus. Lässt du das Feld leer, wird der Standardname beibehalten.

Versionshistorie

Jedes Mal, wenn du einen Workflow speicherst, archiviert Epinium die vorherige Version, bevor sie überschrieben wird. Die Schaltfläche Versionshistorie öffnet die Liste, mit einer Zeile pro Version: Name, Status, Anzahl der Knoten, Validierungsfehler und Datum.

Dort kannst du jede frühere Version Wiederherstellen. Vor dem Wiederherstellen wird auch die aktuelle Version archiviert, ein Rückschritt verliert also nichts: war die zurückgeholte Version nicht die gewünschte, stelle die vorherige wieder her.

Beim Wiederherstellen wird der Graph erneut validiert. Hatte die zurückgeholte Version Fehler, bleibt der Workflow mit Validierungsfehlern zurück und kann erst nach dem Beheben 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).

Filter der Schleife

Mit der Quelle im Modus Abfrage grenzt der Tab Filter des Knotens ein, welche Elemente iteriert werden. Ohne Filter durchläuft die Schleife alle Elemente der Collection.

Die Filter sind in Regelgruppen organisiert, und wie sie kombiniert werden, ist der entscheidende Punkt:

• Die Regeln innerhalb derselben Gruppe werden mit ODER verknüpft — eine erfüllte Regel genügt.
• Die Gruppen untereinander werden mit UND verknüpft — alle Gruppen müssen erfüllt sein.

So drückt man Bedingungen der Art „(Marke A oder Marke B) und (ohne Hauptbild)" aus: eine Marke pro Regel in der ersten Gruppe und die Bildbedingung in einer zweiten Gruppe.

Jede Regel hat drei Teile und einen Schalter:

Teil	Wofür er dient
Feld	Der Pfad des Datenfelds im Element, zum Beispiel commonFields.ASIN
Wert	Womit verglichen wird
Format	Wie der Wert zu interpretieren ist: Text, ObjectId, Boolean, Datum oder Existiert (Zahl) — letzteres nimmt die Elemente, die in diesem Feld eine Zahl haben
Aktiv	Deaktiviert die Regel, ohne sie zu löschen, praktisch zum Testen

Das Format ist entscheidend

Derselbe Wert filtert je nach Format anders. true als Text sucht die Zeichenkette „true"; als Boolean sucht es den Wahrheitswert; als Existiert (Zahl) prüft es, dass das Feld eine Zahl enthält (etwa ein konfiguriertes Maximalgebot). Wenn ein Filter nicht liefert, was du erwartest, ist das Format das erste, was du prüfen solltest.

Im Modus Referenz greift der Tab Filter nicht: die Schleife iteriert über das, was ein vorheriger Knoten erzeugt hat, das Filtern muss also in diesem Knoten passieren.

Reduce Code

Wenn die Schleife Ergebnisse sammeln aktiviert hat, erlaubt der Tab Reduce-Code, das, was jede Iteration zurückgibt, zu einem einzigen Endergebnis zusammenzufassen.

Er arbeitet in Stapeln (Streaming): der Code läuft einmal pro Stapel, nicht einmal pro Element. Er erhält input.items (den aktuellen Stapel) und input.accumulator (das Ergebnis des vorherigen Stapels, null beim ersten) und muss den Akkumulator zurückgeben für den nächsten Stapel.

So bekommt man die Summen eines Audits — wie viele Produkte bestehen und wie viele nicht — ohne den gesamten Katalog im Speicher zu halten. Das Endergebnis ist am Knoten im Inspektor der Ausführung sichtbar.

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

Kampagnenauswahl (Smart Campaigns)

Der Workflow Smart Campaigns Optimizer bietet in seinem Tab Variablen eine Steuerung, um festzulegen, auf welche Kampagnen er wirkt.

Alle Kampagnen mit konfiguriertem Ziel-ACOS einbeziehen (Schalter):

• Ein — der Workflow verwaltet automatisch jede Kampagne, deren Ziel-ACOS/ROAS und maximales Gebot konfiguriert sind.
• Aus — manuelle Auswahl: der Workflow wirkt nur auf die von Ihnen gewählten Kampagnen. Beim Hinzufügen eines neuen Workflows startet der Schalter ausgeschaltet. Er speichert sofort (ohne „Änderungen speichern" zu klicken).

Bei ausgeschaltetem Schalter wird die Schaltfläche Algorithmus-Kampagnen aktiviert; sie öffnet eine Tabelle, in der pro Kampagne (Sponsored Products):

Spalte	Was sie tut
Optimieren	Ob der Workflow diese Kampagne optimieren soll. Nur aktivierbar, wenn die Kampagne ein Ziel gesetzt hat.
Ziel	Zieltyp — ACOS oder ROAS.
Wert	Der Zielwert (z. B. 25 % ACOS).

Die Tabelle ist paginiert, hat eine Suche und zeigt bereits verwaltete Kampagnen zuerst. Änderungen werden mit der Speichern-Schaltfläche des Dialogs gespeichert.

Beziehung zu den KI-Einstellungen pro Kampagne

Eine Kampagne hier anzuhaken entspricht dem Erzwingen dieses Workflows aus den KI-Einstellungen der Kampagne: dieselbe Information von der Workflow-Seite aus gesehen, und das Ziel, das Sie bearbeiten, ist das der Kampagne.

Wenn Sie bei ausgeschaltetem Schalter keine Kampagne anhaken, verarbeitet der Workflow keine — er schlägt nicht fehl, er wirkt nur nicht, bis Sie wählen.

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.
Teilweise	Beendet, aber einige Elemente sind fehlgeschlagen und blieben unbearbeitet. Das taucht in Workflows auf, die iterieren: etwa eine Kampagne, die fehlschlägt, während die übrigen normal optimiert werden.
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.