Szablony opisów produktów AI - jak je pisać
Szablon, czyli polecenie wysyłane do modelu, decyduje o tym, czy opisy będą spójne. Dobry szablon ma stałą część z zasadami marki i zmienną część z danymi produktu. Warto przygotować osobne szablony dla głównych kategorii, bo opis butów i opis części samochodowej wymagają innej struktury.
| Element szablonu | Co zawiera | Po co |
|---|
| Rola i ton | Dla kogo piszemy, jakim językiem, czy zwracamy się na Ty | Spójny styl w całym sklepie |
| Struktura | Akapit wstępny, lista cech, sekcja zastosowania, długość w słowach | Opisy, które da się porównać i łatwo przeczytać |
| Dane produktu | Atrybuty w ustalonym formacie, np. klucz - wartość | Opis oparty na faktach, a nie na domysłach |
| Zakazy | Słowa, obietnice i porównania, których nie wolno używać | Zgodność z regulaminami i prawem |
| Format odpowiedzi | Schemat JSON z polami, np. opis, krótki opis, lista cech, meta opis | Automatyczny zapis do odpowiednich pól sklepu |
Wymuszenie odpowiedzi w formacie JSON to jeden z najważniejszych elementów integracji. Zamiast wycinać fragmenty z wolnego tekstu, program dostaje gotowe pola i może sprawdzić, czy wszystkie są wypełnione. Każdy z dużych dostawców API pozwala przekazać schemat, którego model ma się trzymać.
Opisy pod sklep i pod marketplace
Ten sam produkt często sprzedaje się w sklepie i na Allegro. Opisy w obu kanałach mają inne wymagania: na Allegro liczą się parametry kategorii i czytelna struktura sekcji, w sklepie - treść pod wyszukiwarkę i frazy, którymi klienci szukają produktu. Zamiast kopiować jeden tekst, lepiej generować dwa warianty z osobnych szablonów. Przy okazji zmniejsza się ryzyko, że identyczne treści w kilku miejscach będą konkurować ze sobą w wynikach wyszukiwania.
Kontrola jakości automatycznych opisów produktów
Kontrola jakości ma dwa poziomy. Pierwszy to walidacja automatyczna, którą program wykonuje dla każdego opisu przed zapisem. Drugi to kontrola człowieka na próbce, która pozwala wychwycić błędy, których reguły nie widzą.
Kompletność - czy odpowiedź ma wszystkie pola ze schematu i czy mieszczą się w limitach długości.
Zgodność z danymi - czy liczby w opisie, np. wymiary i pojemności, występują w atrybutach produktu.
Zakazane frazy - czy w tekście nie ma słów z listy zakazanej, np. deklaracji zdrowotnych lub nazw konkurencji.
Podobieństwo - czy opis nie jest prawie identyczny z opisem innego produktu w tej samej kategorii.
Kontrola człowieka - redaktor sprawdza próbkę opisów z każdej partii i oznacza te, które wymagają poprawki.
Postęp warto mierzyć prostym wskaźnikiem: jaki odsetek opisów ze sprawdzonej próbki trzeba było odrzucić lub poprawić. Przykładowo, jeśli redaktor sprawdził 300 opisów, a 27 z nich wymagało poprawki, odsetek poprawek wynosi 9%. Gdy wskaźnik rośnie, to sygnał, że trzeba poprawić szablon albo dane w danej kategorii.
[#chart:wpr24b]
Zapis opisów do sklepu i unikanie duplikatów
Gotowy opis trafia do sklepu przez jego API: WooCommerce REST API, Shoper API, Shopify Admin API czy Webservice PrestaShop. Jeśli produkty są zarządzane w integratorze, np. Base, opis można zapisać tam i pozwolić, by integrator przesłał go do sklepu i na marketplace'y. Przy zapisie warto przestrzegać kilku zasad:
zapisuj opis do wersji roboczej lub osobnego pola, a nie od razu do opublikowanego produktu, dopóki przepływ nie jest sprawdzony,
przechowuj poprzednią wersję opisu, żeby w razie błędu przywrócić ją jednym poleceniem,
oznaczaj produkty z wygenerowanym opisem, np. tagiem lub atrybutem, żeby nie generować go drugi raz,
zapisuj sumę kontrolną danych wejściowych - gdy atrybuty się nie zmieniły, nie ma potrzeby generować opisu ponownie,
aktualizuj tylko te pola, które obejmuje przepływ, i nie nadpisuj ręcznie poprawionych opisów.
Przed pierwszym masowym zapisem zrób pełną kopię bazy produktów, łącznie z opisami i atrybutami. Ogólne zasady łączenia sklepu z zewnętrznymi systemami znajdziesz we wpisie integracja API sklepu internetowego - jak to działa.
Publikacja automatyczna czy po akceptacji
Nie każdy opis musi przechodzić przez redaktora, ale nie każdy powinien trafiać do sklepu bez kontroli. O tym, którą drogę wybrać, decydują ryzyko błędu w danej kategorii i jakość danych źródłowych.
[#chart:wpr24c]
Koszty i wydajność generowania opisów przez API
Koszt generowania zależy od liczby tokenów, czyli długości polecenia z danymi i długości odpowiedzi, oraz od wybranego modelu. Mniejsze modele są tańsze i szybsze, większe lepiej radzą sobie z dłuższymi opisami i trzymaniem się zasad. Przy katalogach liczonych w tysiącach produktów warto skorzystać z trybu wsadowego, który oferują m.in. OpenAI i Anthropic: zapytania są przetwarzane asynchronicznie, zwykle w ciągu doby, za około połowę ceny zwykłych zapytań (stan na sierpień 2026 - sprawdź aktualny cennik dostawcy). Do generowania opisów, które nie są potrzebne natychmiast, to zwykle najlepszy wybór.
Prosty przepływ da się zbudować w narzędziu do automatyzacji, np. w Make lub n8n, bez pisania dużej ilości kodu. Porównanie obu narzędzi znajdziesz we wpisie Make czy n8n - które narzędzie wybrać dla sklepu. Przy dużych katalogach, walidacji podobieństwa i trybie wsadowym lepiej sprawdza się skrypt lub mała usługa napisana przez programistę.
Bezpieczeństwo klucza API i danych
Klucz API dostawcy modelu to dostęp do płatnej usługi, więc trzymaj go w zmiennych środowiskowych lub menedżerze sekretów, a nie w kodzie wtyczki czy arkuszu. Ustaw w panelu dostawcy limit wydatków i powiadomienie o przekroczeniu budżetu, żeby błąd w pętli nie wygenerował rachunku za kilka przebiegów całego katalogu. Do modelu wysyłaj wyłącznie dane produktów. Dane klientów i zamówień nie są potrzebne do pisania opisów, a ich przekazywanie zewnętrznemu dostawcy wymagałoby dodatkowej analizy pod kątem RODO. Warunki przetwarzania danych przesyłanych przez API sprawdź w umowie wybranego dostawcy.
Opisy produktów AI w wielu językach
Ten sam przepływ dobrze sprawdza się przy sprzedaży zagranicznej, np. na Kauflandzie w Niemczech czy na Allegro w Czechach i na Słowacji. Zamiast tłumaczyć gotowy polski opis, lepiej generować tekst w języku docelowym z tych samych atrybutów i osobnego szablonu, w którym zapisano lokalne jednostki, nazewnictwo rozmiarów i zwroty typowe dla danego rynku. Kontrolę próbek powinna wtedy wykonywać osoba znająca język, bo błędy brzmiące naturalnie są dla nie-native'a trudne do wychwycenia.
Jak Vinson pomaga wdrożyć automatyczne opisy produktów z AI
Programiści Vinson budują przepływy generowania opisów od danych do publikacji. Zaczynamy od przeglądu atrybutów w sklepie, PIM lub ERP, bo bez nich żaden model nie napisze rzetelnego opisu. Potem przygotowujemy szablony dla głównych kategorii, ustawiamy format odpowiedzi i walidację, a na końcu łączymy przepływ z API sklepu, Base lub marketplace'u, z wersjonowaniem i raportem odrzuconych opisów. Zajmujemy się też utrzymaniem: aktualizujemy szablony, gdy zmienia się asortyment, i dostosowujemy integrację do zmian w API dostawców modeli. Szczegóły współpracy znajdziesz na stronie Wsparcie programistyczne dla e-commerce.
Najczęściej zadawane pytania
Czy opisy produktów napisane przez AI szkodzą SEO?
Samo użycie AI nie jest problemem - Google ocenia, czy treść jest pomocna dla użytkownika, a nie to, jak powstała. Problemem są masowo generowane, powtarzalne teksty bez wartości, które Google traktuje jako spam. Opisy oparte na rzeczywistych atrybutach, różne dla każdego produktu i sprawdzane przed publikacją nie mają z tym związku.
Jak połączyć sklep z ChatGPT, żeby generował opisy?
Nie przez okno czatu, tylko przez API dostawcy modelu, np. OpenAI. Skrypt lub narzędzie do automatyzacji pobiera dane produktu z API sklepu, wysyła je z szablonem do modelu, sprawdza odpowiedź i zapisuje opis z powrotem w sklepie. Potrzebny jest klucz API dostawcy i dostęp do API sklepu.
Ile kosztuje wygenerowanie opisów dla całego sklepu?
Koszt zależy od liczby produktów, długości danych i opisów oraz wybranego modelu, bo dostawcy rozliczają się za tokeny. Tryb wsadowy, oferowany m.in. przez OpenAI i Anthropic, obniża koszt mniej więcej o połowę. Do tego dochodzi jednorazowy koszt zbudowania przepływu i czas redaktora na kontrolę próbek.
Jak uniknąć zmyślonych parametrów w opisach AI?
Przekazuj modelowi pełne atrybuty produktu i zapisz w instrukcji, że może korzystać tylko z nich. Po wygenerowaniu automatycznie porównuj liczby i parametry z opisu z danymi produktu, a opisy z rozbieżnościami kieruj do ręcznej kontroli. W kategoriach o wysokim ryzyku publikuj opisy dopiero po akceptacji człowieka.
Czy można użyć tego samego opisu w sklepie i na Allegro?
Można, ale lepiej generować dwa warianty z osobnych szablonów. Allegro wymaga parametrów kategorii i czytelnej struktury, a w sklepie opis ma też pracować na widoczność w wyszukiwarce. Różne wersje ograniczają też ryzyko, że identyczne teksty w kilku miejscach będą ze sobą konkurować.
Który model AI najlepiej pisze opisy produktów po polsku?
Modele największych dostawców, takich jak OpenAI, Anthropic i Google, dobrze radzą sobie z językiem polskim, a różnice między nimi zmieniają się z każdą nową wersją. Zamiast wybierać na podstawie rankingów, przetestuj dwa lub trzy modele na tej samej próbce kilkudziesięciu produktów z Twojego katalogu i porównaj odsetek poprawek. Dobrze zbudowana integracja pozwala później zmienić model bez przepisywania przepływu.
Automatyczne opisy produktów z AI oszczędzają czas, gdy stoją za nimi dobre dane, przemyślane szablony i kontrola jakości przed publikacją. Jeśli chcesz połączyć swój sklep z modelem językowym i zrobić to bezpiecznie dla katalogu, sprawdź wsparcie programistyczne Vinson. O tym, które narzędzie do automatyzacji wybrać na start, przeczytasz we wpisie Zapier czy Make dla sprzedawcy online.
