Zum Hauptinhalt springen

Content Flows — Vollständiger Leitfaden

Content Flows sind das Kern-Automatisierungsfeature von Fozzels. Ein Flow ist eine Regel, die automatisch KI-Inhalte für ein ausgewähltes Produktattribut generiert und das Ergebnis zurück in Ihren Shop schreibt.

Was ein Flow tut​

  1. Filtert Produkte nach Ihren Bedingungen (z. B. "description is empty")
  2. Sendet Produktdaten mit Ihrer Eingabeaufforderung an die KI
  3. Speichert den generierten Inhalt als "Abschluss"
  4. Sendet den Inhalt an Ihr Shop-Attribut

Erstellen eines Flow​

Gehen Sie zu Flows → Create Flow

Schritt 1 — Shop & Zielattribut​

  • Wählen Sie den Shop aus, dessen Produkte verarbeitet werden sollen
  • Geben Sie dem Flow einen Namen
  • Wählen Sie das Zielattribut — das Attribut, das KI-generierte Inhalte erhält
    • Muss das Flag Mutable in Integration → Attribute aktiviert haben

Schritt 2 — KI-Anbieter​

  • Wählen Sie KI-Anbieter: OpenAI GPT-4o, Google Gemini 2.5 Flash oder Anthropic Claude
  • Wählen Sie ein bestimmtes Modell
  • Konfigurieren Sie Modellparameter bei Bedarf

Schritt 3 — Produkte & Eingabeaufforderung​

  • Bedingungen — visueller Abfragebuilder, um zu filtern, welche Produkte dieser Flow verarbeitet
    • Beispiel: "description is empty AND category equals Electronics"
    • Leer lassen, um alle Produkte im Shop zu verarbeiten
    • Eine Produktanzahl-Vorschau zeigt, wie viele Produkte dem Filter entsprechen
  • Prompt-Vorlage — die Anweisung an die KI mit Platzhaltern {{attribute_code}}
    • Beispiel: Write a product description for {{name}} (SKU: {{sku}}) in category {{category}}
    • Attribute-Tab ({{attribute_code}}) — immer in der Eingabeaufforderung enthalten, auch wenn das Produkt keinen Wert für dieses Attribut hat
    • Attribute (if filled) Tab (#attribute_code) — nur in der Eingabeaufforderung enthalten, wenn das Produkt tatsächlich einen Wert hat; nützlich, um zu vermeiden, dass leere Zeilen an die KI gesendet werden

Schritt 4 — Automatisierungseinstellungen​

  • Aktiv-Umschalter — aktivieren/deaktivieren Sie den Flow
  • Stapelgröße — wie viele Produkte pro Durchlauf verarbeitet werden (Standard 10)
  • Automation-Umschalter — wenn ON werden bestätigte Inhalte automatisch an Ihren Shop gesendet ohne manuelle Überprüfung
  • Bei Attributänderung neu generieren — erneut ausführen, wenn Quellattribute aktualisiert werden (⚠ kann zu Rekursion führen, wenn das Zielattribut auch eine Quelle ist)
  • Überlappende Generierung verhindern — Cooldown zwischen Regenerationen pro Produkt:
    • Erben — verwenden Sie globalen Cooldown aus Kontoeinstellungen
    • Außer Kraft setzen — legen Sie einen benutzerdefinierten Cooldown nur für diesen Flow fest
    • Ausschalten — generieren Sie immer neu, unabhängig von bisherigen Durchläufen

Tipps für Prompt-Vorlagen​

Referenzieren Sie Attribute mit {{attribute_code}} — verwenden Sie den exakten Code, der in Integration → Attribute angezeigt wird.

Zwei Attribut-Syntaxen:

  • {{attribute_code}} — immer enthalten (entspricht dem Attribute-Tab im Editor). Verwenden Sie dies standardmäßig.
  • #attribute_code — enthalten, nur wenn das Produkt einen Wert hat (entspricht dem Attribute (if filled)-Tab). Verwenden Sie dies, um leere Felder zu überspringen.

Seien Sie spezifisch über:

  • Format und Länge ("150–200 Wörter")
  • Sprache ("auf Englisch")
  • Ton ("professionell, aber freundlich")
  • Was zu vermeiden ist ("erwähnen Sie keine Konkurrenten")

Beispiel für Produktbeschreibung:

Write a compelling product description (150–200 words) in English.

Product name: {{name}}
Brand: {{brand}}
Category: {{category_name}}
Current short description: {{short_description}}

Focus on benefits, not just features. Use a professional but friendly tone.

Wenn die Ausgabe HTML enthalten muss, aktivieren Sie die relevanten Tags in Einstellungen → Flow-Einstellungen → Trusted HTML Tags.

Flow ausführen​

Run Now — verarbeitet sofort bis zu 10 Produkte. Verwenden Sie dies zum Testen oder für kleine Chargen.

Plan & Close — reiht die vollständige Charge zur Verarbeitung im Hintergrund ein. Verwenden Sie dies für Massendurchläufe.

Abschluss-Lebenszyklus​

Jeder generierte Artikel durchläuft diese Stadien:

StatusBedeutung
PendingGeneriert, wartet auf Überprüfung
ConfirmedVon Ihnen genehmigt, bereit zur Synchronisierung
SynchronizedErfolgreich an den Shop gesendet
SuspiciousEnthält gekennzeichnete Inhalte — erfordert manuelle Überprüfung vor Synchronisierung

Mit Automation ON — werden saubere Inhalte automatisch bestätigt und gesendet. Verdächtige Inhalte warten immer auf manuelle Überprüfung.

Mit Automation OFF — warten alle Inhalte darauf, dass Sie sie überprüfen und bestätigen, bevor sie synchronisiert werden.

Überprüfung der Abschlüsse​

Gehen Sie zu einem Flow → View Completions, um alle generierten Inhalte anzuzeigen.

Pro Element können Sie:

  • Bearbeiten des generierten Textes manuell
  • Neu generieren — bitten Sie KI, erneut zu generieren
  • Bestätigen — genehmigen Sie Inhalte zur Synchronisierung
  • Synchronisieren — senden Sie an Ihren Shop
  • Revisionen anzeigen — vollständigen Bearbeitungsverlauf und Diff zwischen Versionen anzeigen

Massenaktionen: mehrere Elemente auswählen → Bestätigen & Synchronisieren, Neu generieren oder Senden.

Verdächtige Inhalte​

Fozzels kennzeichnet automatisch Inhalte, die falsch aussehen:

  • KI-Artefakte: "Sorry, I can't...", "As an AI...", "Note:", "Please"
  • Leere Werte
  • Doppelt kodiertes HTML (<, >)
  • Markdown-Syntax in einem Nicht-Markdown-Feld
  • Ihre benutzerdefinierten verdächtigen Wörter (konfigurieren Sie unter Einstellungen → Flow-Einstellungen)

Gekennzeichnete Inhalte zeigen genau, warum sie gekennzeichnet wurden. Sie können:

  • Bearbeiten und beheben
  • Neu generieren
  • Außer Kraft setzen und trotzdem genehmigen (wenn es ein falsches positives Ergebnis ist)

Warum Inhalte nicht synchronisiert werden (Push blockiert)​

GrundBehebung
Flow ist inaktivAktivieren Sie das Aktiv-Feld im Flow
Nicht bestätigtBestätigen Sie den Abschluss (oder aktivieren Sie Automation)
Verdächtige InhalteÜberprüfen und genehmigen Sie, oder bearbeiten Sie und speichern Sie erneut
Produkt aus dem Shop gelöschtNichts zu tun — Produkt existiert nicht mehr
Shop/Integration inaktivAktivieren Sie den Shop oder die Integration
Attribut nicht veränderbarAktivieren Sie das Mutable-Flag in Integration → Attribute

Flow-Verwaltung​

  • Duplizieren — kopieren Sie einen Flow auf denselben oder einen anderen Shop
  • Archivieren — verstecken Sie den Flow von der Hauptliste; Daten bleiben erhalten und können wiederhergestellt werden
  • Löschen — permanente Entfernung
  • Veraltet — wenn ein Flow aufgrund von strukturellen Änderungen geklont wird (Zielattribut oder Bedingungen geändert), wird die alte Version veraltet; sein Abschluss-Verlauf bleibt erhalten

Warnung vor strukturellen Änderungen​

Wenn Sie das Zielattribut oder die Bedingungen in einem Flow ändern, der bereits Abschlüsse hat, warnt Sie Fozzels und bietet an, "Veraltet und Duplizieren" — dies erstellt einen neuen Flow mit Ihren Änderungen und bewahrt die Geschichte des alten.

Rekursions-Warnung​

Ausgelöst, wenn das gleiche Attribut wie folgt angezeigt wird:

  • Eine Eingabe in Ihrer Eingabeaufforderung ({{attr_code}})
  • Das Ausgabe-Zielattribut

Dies erzeugt eine Endlosschleife — jede Generierung überschreibt die Eingabe für den nächsten Durchlauf.

Behebung:

  • Entfernen Sie {{attr_code}} aus der Prompt-Vorlage
  • ODER deaktivieren Sie "Bei Attributänderung neu generieren"

Häufige Probleme​

Keine Produkte entsprechen dem Flow

  • Überprüfen Sie Ihre Bedingungen — versuchen Sie, sie temporär zu entfernen, um alle Produkte zu sehen
  • Überprüfen Sie, dass die in Bedingungen verwendeten Attribute das Flag Filterable in Integration → Attribute haben

Leere KI-Ausgabe

  • Überprüfen Sie, dass Quellattribute Werte für Ihre Produkte haben
  • Überprüfen Sie, dass Attribute, auf die in der Eingabeaufforderung verwiesen wird, das Flag Filterable haben
  • Machen Sie die Eingabeaufforderung spezifischer

Inhalte senden nicht an den Shop

  • Überprüfen Sie die Push-Blockierungsgründe oben
  • Überprüfen Sie, dass das Integrations-Aktiv-Feld ON ist
  • Überprüfen Sie, dass das Zielattribut das Flag Mutable hat

OpenAI-Kontingent überschritten

Duplizierte Inhalte über Flows

  • Aktivieren Sie "Überlappende Generierung verhindern" mit einem Cooldown-Zeitraum (z. B. 7 Tage)
  • Dies verhindert, dass mehrere Flows das gleiche Produkt innerhalb des Cooldown-Fensters neu generieren