Opisy produktów AI

Moduł opisów produktów AI umożliwia automatyczne generowanie opisów produktów WooCommerce z wykorzystaniem dowolnego API kompatybilnego z OpenAI. Opisy są zoptymalizowane pod SEO i dostosowane do wybranego tonu komunikacji.

Wymagania

Wymagany jest klucz API do usługi kompatybilnej z OpenAI (np. OpenAI, Azure OpenAI, lokalne LLM z endpointem chat/completions).

Jak to działa

1. Administrator otwiera edycję produktu WooCommerce
2. W meta boxie “Opisy AI” wybiera cel generowania i ton
3. Plugin wysyła kontekst produktu do API
4. Wygenerowany tekst pojawia się w meta boxie do podglądu
5. Administrator akceptuje lub edytuje tekst przed zapisaniem

Konfiguracja

Przejdź do WooCommerce > Ustawienia > Polski PRO > Opisy AI.

Ustawienia są przechowywane w opcji:

polski_pro_ai_descriptions

Ustawienia API

Ustawienie	Opis	Domyślnie
Klucz API	Klucz autoryzacji do API	-
URL API	Endpoint chat/completions	https://api.openai.com/v1/chat/completions
Model	Model AI do generowania	gpt-4o-mini
Max tokens	Maksymalna dlugosc odpowiedzi	1024

Ustawienia generowania

Ustawienie	Opis	Domyślnie
Ton	Styl komunikacji	professional
Język	Język generowanych opisów	pl
Słowa kluczowe SEO	Uwzględniaj słowa kluczowe w opisie	Tak
Własny prompt	Dodatkowe instrukcje dla modelu AI	-

Dostępne tony

Ton	Opis
professional	Formalny, rzeczowy styl biznesowy
casual	Przyjazny, konwersacyjny styl
persuasive	Przekonujacy, nastawiony na sprzedaz
technical	Szczegolowy, techniczny opis specyfikacji
luxurious	Ekskluzywny, aspiracyjny styl premium

Cele generowania

Meta box na stronie edycji produktu pozwala wybrać, jaki tekst ma zostać wygenerowany:

Cel	Opis
Pełny opis	Główny opis produktu (post_content)
Krótki opis	Zajawka produktu (post_excerpt)
Tytuł SEO	Tytuł meta dla wyszukiwarek
Opis meta SEO	Meta description dla wyszukiwarek

Tytuły i opisy SEO są automatycznie zapisywane w polach odpowiedniego pluginu SEO (Yoast SEO lub RankMath).

Integracja z pluginami SEO

Moduł wykrywa zainstalowany plugin SEO i zapisuje wygenerowane dane w odpowiednich polach meta:

Yoast SEO

• Tytuł SEO zapisywany w _yoast_wpseo_title
• Opis meta SEO zapisywany w _yoast_wpseo_metadesc

RankMath

• Tytuł SEO zapisywany w rank_math_title
• Opis meta SEO zapisywany w rank_math_description

Jeśli żaden plugin SEO nie jest aktywny, opcje generowania tytułu i opisu meta SEO są niedostępne.

Kontekst produktu

Przy każdym zadaniu generowania plugin wysyła do API następujące dane produktu:

• Nazwa produktu - tytuł produktu
• SKU - numer katalogowy
• Cena - cena regularna i promocyjna
• Kategorie - lista kategorii produktu
• Atrybuty - wszystkie atrybuty i ich wartości
• Istniejące opisy - aktualny pełny i krótki opis (jeśli istnieją)

Dane te pozwalają modelowi AI wygenerować trafny i kontekstowo poprawny opis.

Generowanie zbiorcze

Moduł obsługuje generowanie opisów dla wielu produktów jednocześnie:

1. Przejdź do Produkty > Wszystkie produkty
2. Zaznacz produkty do generowania
3. Z listy “Akcje zbiorcze” wybierz Generuj opisy AI
4. Wybierz cel i ton generowania
5. Kliknij “Zastosuj”

Generowanie zbiorcze działa asynchronicznie przez AJAX - każdy produkt jest przetwarzany osobno, a pasek postępu pokazuje stan operacji. Pozwala to uniknąć przekroczenia limitu czasu serwera przy dużej liczbie produktów.

Limity

• Każde zadanie to osobne wywołanie API
• Należy uwzględnić limity rate-limiting usługi API
• Przy dużej liczbie produktów generowanie może zająć kilka minut

Przykład użycia

Generowanie opisu dla pojedynczego produktu

1. Otwórz edycję produktu
2. Przewiń do meta boxa Opisy AI
3. Wybierz cel: “Pełny opis”
4. Wybierz ton: “persuasive”
5. Kliknij Generuj
6. Przejrzyj wygenerowany tekst
7. Kliknij Wstaw do opisu aby przenieść tekst do edytora

Konfiguracja własnego endpointu

Jeśli korzystasz z lokalnego modelu LLM lub innego dostawcy:

1. Zmień URL API na adres swojego endpointu (musi być kompatybilny z formatem OpenAI chat/completions)
2. Ustaw odpowiedni Model (nazwa modelu rozpoznawana przez Twój endpoint)
3. Podaj Klucz API (jeśli wymagany przez Twój endpoint)

Włączanie modułu

Moduł jest kontrolowany przez przełącznik w ustawieniach modułów PRO:

WooCommerce > Ustawienia > Polski PRO > Moduły > Opisy AI

Transparentność AI (art. 50)

Treść, którą zastosujesz z tego modułu, jest traktowana jako wygenerowana przez AI. Gdy zastosujesz wygenerowany tekst do opisu lub krótkiego opisu produktu, wtyczka:

• zapisuje na produkcie znacznik maszynowy (_polski_ai_generated), oraz
• pokazuje krótką informację i ukryty znacznik data-ai-generated na stronie produktu.

W meta boksie Opisy AI pojawia się też plakietka AI Act art. 50, gdy produkt zostanie oznaczony.

Widoczna informacja na stronie jest sterowana jednym ustawieniem, domyślnie włączonym, w ustawieniach AI darmowej wtyczki:

WooCommerce > Ustawienia > Polski > Funkcje AI > Oznaczaj treści generowane przez AI

Wyłączenie zostawia zapis maszynowy na produkcie, ale usuwa notkę ze sklepu. Tytuł SEO i meta opis nie są oznaczane, bo nie są renderowane jako widoczna treść produktu.

Notatka

To wsparcie zgodności, a nie porada prawna. To, czy i jak dokładnie art. 50 dotyczy Twojego sklepu, potwierdzasz samodzielnie.

Ta strona ma wyłącznie charakter informacyjny i nie stanowi porady prawnej. Polski PRO for WooCommerce jest oprogramowaniem komercyjnym dostarczanym bez gwarancji.