Forks

Ein Fork ist eine Prompt-Vorlage, die den Standard für eine Teilmenge von Produkten überschreibt. Wenn das Plugin einen Auftrag für ein bestimmtes Produkt ausführen muss, betrachtet es jeden Fork des passenden Typs, findet denjenigen, dessen Regel das Produkt erfüllt, und verwendet ihn. Trifft kein Fork zu, greift der Standard.

Mit Forks können Sie eine Tonalität für Küchenartikel und eine andere für Werkzeuge haben, oder strenge SEO-Regeln für einen Verkaufskanal und lockerere für einen anderen — ohne separate Vorlagen von Hand zu jonglieren.

Den Assistenten starten

Verwenden Sie auf einer beliebigen Prompt-Detailseite die Aktion Fork von dieser Vorlage erstellen (oder Fork erstellen auf der Listenseite). Der Assistent Prompt-Fork erstellen öffnet sich.

Der vierstufige Assistent

Schritt 1 — Beschreiben

Was soll sich ändern — Klartext, z. B. „Technischerer Ton für Elektrowerkzeuge” oder „Erwähne die Marke immer im ersten Satz”. Erforderlich.
Schnellauswahl-Buttons — Kürzer, Länger, Formeller, Marketing-Ton, Weniger technisch, Mehr SEO, Keine Emojis, Vielfältiger — anklicken, um vorformulierte Anweisungen in das Feld einzufügen.
Bewahrungsregeln (dürfen NICHT gelockert werden) — vorbelegt mit „Keine Fakten erfinden; Produktspezifikationen bewahren”; bei Bedarf anpassen. Optional.

Schritt 2 — Geltungsbereich

Wählen Sie über das Radio Geltungsbereich-Modus, für welche Produkte dieser Fork gelten soll:

Auf ähnliche Produkte anwenden (automatisch erkannt) — wählen Sie ein echtes Produkt; der Assistent erkennt dessen Hersteller und Kategorien automatisch als Geltungsbereich.
Geltungsbereich manuell definieren (Filter) — Mehrfachauswahl von Kategorien, Herstellern, Verkaufskanälen, aktivem / inaktivem Status.
Vorhandene Shopware-Regel verwenden — wählen Sie eine vorhandene Regel über die Regelauswahl (es wird keine neue Regel erstellt).
Keine Einschränkung (global) — der Fork gilt für jedes Produkt dieses Typs (mit Vorsicht verwenden).

Im selben Schritt wählen Sie außerdem die KI-Verbindung (zum Generieren der vorgeschlagenen Prompts) und können in einem ausklappbaren Panel Harte Constraints (erweitert) Max./Min.-Länge, Ausgabesprache, verbotene Wörter und erforderliche Keywords festlegen.

Der Assistent prüft in Echtzeit auf Konflikte — wenn sich Ihr Geltungsbereich mit einem vorhandenen Fork desselben Typs überschneidet, lässt eine Warnung Sie den vorhandenen Fork bearbeiten, statt ein Duplikat anzulegen.

Schritt 3 — Prüfen

Das Modell nimmt Ihre Beschreibung, den Eltern-Prompt und die Constraints und schlägt einen neuen System-Prompt und User-Prompt vor. Beide Vorschläge erscheinen in editierbaren Textbereichen — Sie können sie direkt anpassen. Diese einmalige Generierung wird von der Vorlage meta.fork_wizard gesteuert.

Klicken Sie auf Verfeinern — was fehlt noch, um einen iterativen Chat zu öffnen (dieselbe Engine wie der KI-Assistent-Chat) und zu iterieren, ohne den Assistenten zu verlassen.

Mit KI besprechen (Brainstorm)

Wenn Sie noch nicht genau wissen, was Sie ändern wollen, schalten Sie den Schritt „Beschreiben” auf Mit KI besprechen um, statt eine feste Beschreibung zu schreiben. Dies öffnet einen mehrstufigen Brainstorm-Chat, gesteuert von der Vorlage meta.fork_brainstorm:

Die KI stellt gezielte Rückfragen zu Ihren Zielen.
Nach jeder Runde veröffentlicht sie einen laufenden Entwurf der Beschreibung, des Fork-Namens sowie des vorgeschlagenen System-Prompts + User-Prompts, sodass Sie den Vorschlag in Echtzeit wachsen sehen.
Brainstorm-Sitzungen werden gespeichert und neben den anderen KI-Assistent-Chats aufgelistet — siehe Gespeicherte Chat-Sitzungen.
Wenn die KI signalisiert, dass sie fertig ist (oder Sie entscheiden, dass es gut genug ist), wird der Entwurf in den Rest des Assistenten übernommen — genauso, als hätten Sie ihn manuell geschrieben.

Beide Meta-Abläufe nutzen dieselbe Verbindung — wählen Sie sie einmal in Schritt 2.

Schritt 4 — Testen & speichern

Führen Sie optional Test gegen aktuelles Produkt aus, um die Ausgabe zu sehen, die der vorgeschlagene Fork erzeugen würde.
Füllen Sie Fork-Name (erforderlich) und Priorität (optional, Standard 10) aus.
Klicken Sie auf Fork speichern, um zu sichern.

Priorität

Wenn mehrere Forks auf dasselbe Produkt passen, gewinnt derjenige mit der niedrigsten Prioritätszahl. Nutzen Sie dies bei verschachtelten Geltungsbereichen — z. B. ein Fork für „alle Werkzeuge” mit Priorität 50 und ein spezifischerer Fork für „Bohrmaschinen” mit Priorität 10.

Wie Geltungsbereich-Regeln ausgewertet werden

Die Modi Filter / aus Produkt / ausgewählt des Assistenten erzeugen alle eine reguläre Shopware-Regel-Entität, sodass Sie sie auch unter Einstellungen → Shop → Rule Builder prüfen oder bearbeiten können. Um Produkte ohne vollständigen Verkaufskanal-Kontext abzugleichen, liefert das Plugin eigene produktbezogene Regelbedingungen mit:

p2labAiProductActive — trifft zu, wenn product.active dem erwarteten Wert entspricht.
p2labAiProductCategoryStrict — trifft zu, wenn das Produkt direkt einer der gewählten Kategorien zugeordnet ist (keine Vererbung).
p2labAiProductCategoryWithChildren — trifft zu, wenn das Produkt einer gewählten Kategorie oder einem ihrer Nachfahren zugeordnet ist (vom aus-Produkt-Modus verwendet).
p2labAiProductManufacturer — trifft auf einen der gewählten Hersteller zu.
p2labAiProductSalesChannel — trifft zu, wenn das Produkt in einem der gewählten Verkaufskanäle sichtbar ist.

Wenn Sie Vorhandene Shopware-Regel verwenden wählen, funktionieren alle Standard-Regelbedingungen — das Plugin wertet sie über dieselbe Engine aus.

Vom Assistenten erstellte Regeln werden [P2LabAi] <Fork-Label> benannt und tragen einen stabilen Fingerabdruck in der Beschreibung, sodass ein erneuter Lauf des Assistenten mit demselben Geltungsbereich die vorhandene Regel wiederverwendet, statt ein Duplikat zu erzeugen.