Forki

Fork to szablon promptu, który nadpisuje default dla podzbioru produktów. Kiedy plugin musi uruchomić zadanie dla danego produktu, przegląda każdy fork pasującego typu, znajduje ten, którego reguła jest spełniana przez produkt, i używa go. Jeśli żaden fork nie pasuje, wchodzi default.

Forki pozwalają mieć jeden ton głosu dla artykułów kuchennych, a inny dla narzędzi, lub ścisłe reguły SEO dla jednego kanału sprzedaży i luźniejsze dla innego — bez ręcznego żonglowania osobnymi szablonami.

Uruchamianie kreatora

Z dowolnej strony szczegółów szablonu promptu użyj akcji Fork from this (albo Create fork na stronie listy). Otwiera się kreator Create prompt fork.

4-etapowy kreator

Krok 1 — Opis

What should change — zwykły tekst, np. “More technical tone for power tools” albo “Always mention the brand in the first sentence”. Wymagane.
Quick preset buttons — Shorter, Longer, Formal, Marketing, Less Technical, More SEO, No Emoji, Varied — kliknij, aby wrzucić wstępnie napisane instrukcje do pola.
Preservation rules (must NOT be relaxed) — wstępnie wypełnione “Never invent facts; preserve product specs”; edytuj w razie potrzeby. Opcjonalne.

Krok 2 — Zakres

Wybierz, do których produktów ten fork ma się stosować, przez radio Scope mode:

Apply to similar products (auto-detected) — wybierz prawdziwy produkt; kreator automatycznie wykrywa jego producenta i kategorie jako zakres.
Define scope manually (filters) — multi-select kategorii, producentów, kanałów sprzedaży, stan aktywny / nieaktywny.
Use an existing Shopware rule — wybierz istniejącą regułę przez picker reguł (nie tworzy się nowej reguły).
No restriction (global) — fork stosuje się do każdego produktu tego typu (używaj ostrożnie).

W tym samym kroku wybierasz też AI connection (używane do generowania proponowanych promptów), a w zwijanym panelu Hard constraints (advanced) możesz ustawić max / min długość, język wyjściowy, słowa zabronione i słowa kluczowe wymagane.

Kreator sprawdza konflikty w czasie rzeczywistym — jeśli Twój zakres pokrywa się z istniejącym forkiem tego samego typu, ostrzeżenie pozwala zamiast tego edytować istniejący fork, zamiast tworzyć duplikat.

Krok 3 — Przegląd

Model bierze Twój opis, prompt rodzica i ograniczenia, i proponuje nowy system prompt oraz user prompt. Obie propozycje pojawiają się w edytowalnych textareach — możesz je modyfikować bezpośrednio. To jednorazowe generowanie napędzane jest przez szablon meta.fork_wizard.

Kliknij Refine — say what’s still missing, aby otworzyć iteracyjny czat (ten sam silnik co czat z asystentem AI) i iterować bez wychodzenia z kreatora.

Discuss with AI (brainstorm)

Jeśli nie jesteś jeszcze pewny, co dokładnie zmienić, przełącz krok Describe na Discuss with AI zamiast pisać sztywny opis. Otwiera to wieloturowy czat brainstormingowy napędzany szablonem meta.fork_brainstorm:

AI zadaje skupione pytania uzupełniające o Twoich celach.
Po każdej turze publikuje bieżący draft description, fork name oraz proponowanego system prompt + user prompt, więc obserwujesz, jak propozycja ewoluuje w czasie rzeczywistym.
Sesje brainstorm są zapisywane i wyświetlane razem z innymi czatami asystenta AI — zobacz Zapisane sesje czatu.
Kiedy AI sygnalizuje, że skończyło (albo Ty zdecydujesz, że jest wystarczająco dobre), draft jest przenoszony do reszty kreatora dokładnie tak, jakbyś napisał go ręcznie.

Oba meta-flow dzielą to samo połączenie — wybierz je raz w kroku 2.

Krok 4 — Test i zapis

Opcjonalnie uruchom Test against current product, aby zobaczyć output, który wygenerowałby proponowany fork.
Wypełnij Fork name (wymagane) i Priority (opcjonalnie, domyślnie 10).
Kliknij Save fork, aby utrwalić.

Priorytet

Jeśli wiele forków pasuje do tego samego produktu, wygrywa ten z najniższym numerem priorytetu. Używaj tego, gdy masz zagnieżdżone zakresy — np. fork dla “wszystkich narzędzi” z priorytetem 50 i bardziej szczegółowy fork dla “wiertarek” z priorytetem 10.

Jak ewaluowane są reguły zakresu

Tryby filter / from-product / selected kreatora produkują regularną encję Shopware Rule, więc możesz je też inspekcjonować lub edytować w Settings → Shop → Rule builder. Aby dopasowywać produkty bez pełnego kontekstu sales-channel, plugin dostarcza własne warunki reguł ograniczonych do produktu:

p2labAiProductActive — pasuje, gdy product.active równa się oczekiwanej wartości.
p2labAiProductCategoryStrict — pasuje, gdy produkt jest bezpośrednio przypisany do jednej z wybranych kategorii (bez dziedziczenia).
p2labAiProductCategoryWithChildren — pasuje, gdy produkt jest przypisany do wybranej kategorii lub dowolnego jej potomka (używane przez tryb from-product).
p2labAiProductManufacturer — pasuje jednemu z wybranych producentów.
p2labAiProductSalesChannel — pasuje, gdy produkt jest widoczny w jednym z wybranych kanałów sprzedaży.

Gdy wybierzesz Use an existing Shopware rule, działa każdy standardowy warunek reguły — plugin ewaluuje je przez ten sam silnik.

Reguły tworzone przez kreatora są nazwane [P2LabAi] <fork label> ze stabilnym fingerprintem w opisie, więc ponowne uruchomienie kreatora z tym samym zakresem ponownie używa istniejącej reguły zamiast produkować duplikat.