# dfaimetagen: generator AI meta tytułów, opisów i ALT
> Prezentacja dfaimetagen generuje masowo meta tytuły, meta opisy i atrybuty ALT obrazów przez AI (Anthropic Claude, OpenAI GPT albo Mistral) w PrestaShop 8 i 9. Moduł obsługuje 6 typów encji…
- Strona:
- Język: pl
- Zaktualizowano: 2026-08-01
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfaimetagen/index.md), [en](https://www.datafirefly.com/en/documentation/dfaimetagen/index.md), [es](https://www.datafirefly.com/es/documentation/dfaimetagen/index.md), [de](https://www.datafirefly.com/de/documentation/dfaimetagen/index.md), [it](https://www.datafirefly.com/it/documentation/dfaimetagen/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaimetagen/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaimetagen/index.md)
- Indeks:
## Prezentacja
dfaimetagen generuje masowo meta tytuły, meta opisy i atrybuty ALT obrazów przez AI (Anthropic Claude, OpenAI GPT albo Mistral) w PrestaShop 8 i 9. Moduł obsługuje 6 typów encji (produkty, kategorie, strony CMS, producenci, dostawcy, obrazy produktów), stosuje sprawdzone wzorce CTR, tworzy warianty A/B, kontroluje długości pod SERP i odrzuca duplikaty przez podobieństwo Jaccarda.
## Wymagania
- PrestaShop 8.0 do 9.x
- PHP 8.1, 8.2, 8.3 albo 8.4
- Rozszerzenia PHP: curl, json, iconv
- MySQL 5.7+ albo MariaDB 10.3+
- Klucz API u co najmniej jednego dostawcy: [Anthropic](https://console.anthropic.com), [OpenAI](https://platform.openai.com) albo [Mistral](https://console.mistral.ai)
## Instalacja
1. Pobierz plik `dfaimetagen.zip` ze swojego konta klienta.
2. W back office PrestaShop przejdź do **Moduły > Menedżer modułów > Dodaj nowy moduł**.
3. Wgraj plik ZIP i kliknij **Zainstaluj**.
4. Moduł tworzy 6 tabel w bazie (prefiks `df_aimeta_`), instaluje 11 domyślnych wzorców CTR i generuje losowy token CRON.
5. W menu **Katalog** pojawia się nowa zakładka **AI Meta Generator**.
## Konfiguracja dostawcy AI
1. Przejdź do **Katalog > AI Meta Generator > Ustawienia**.
2. Wybierz aktywnego dostawcę: Anthropic (dobre rezultaty przy krótkich tekstach marketingowych, również po polsku), OpenAI albo Mistral.
3. Wklej swój klucz API w odpowiednie pole.
4. Kliknij przycisk **Test** obok pola, aby sprawdzić połączenie: powinieneś otrzymać odpowiedź „OK”.
5. Domyślne modele to `claude-sonnet-4-5`, `gpt-4o-mini` i `mistral-large-latest`. Możesz je zmienić, jeśli wolisz inny model tego samego dostawcy.
Klucze API są przechowywane w tabeli Configuration PrestaShop i nigdy nie są ujawniane po stronie front office. Moduł nie zawiera kredytów AI: każda generacja zużywa Twój własny limit u dostawcy (około 0,0005 do 0,003 euro za generację).
## Ustawienia generowania
Nadal w **Ustawieniach** możesz dostosować:
- **Limity długości**: domyślnie zgodne z zaleceniami Google SERP: meta tytuł od 35 do 60 znaków, meta opis od 120 do 158, ALT od 25 do 125. Jeśli AI przekroczy limit, tekst jest przycinany czysto na granicy wyrazu.
- **Warianty A/B na pozycję**: od 1 do 5 alternatyw generowanych na encję i na język.
- **Próg ochrony przed duplikatami**: procent podobieństwa Jaccarda, powyżej którego wariant jest odrzucany (domyślnie 85 procent). Porównanie jest niewrażliwe na znaki diakrytyczne.
- **Rozmiar partii**: liczba pozycji przetwarzanych na jeden cykl AJAX albo CRON (domyślnie 10, maksymalnie 100).
- **Timeout HTTP**: maksymalny czas oczekiwania na odpowiedź dostawcy (domyślnie 60 s).
- **Nadpisz / Pomiń niepuste**: domyślne zachowanie wobec już uzupełnionych metadanych.
## Uruchomienie masowego generowania
1. Przejdź do **Katalog > AI Meta Generator > Bulk Generation**.
2. **Encja**: produkty, kategorie, strony CMS, producenci, dostawcy albo obrazy produktów.
3. **Pole**: meta tytuł, meta opis albo ALT obrazu (ALT dotyczy obrazów produktów).
4. **Wzorzec CTR**: wybierz konkretny wzorzec albo zostaw _Auto_, aby użyć domyślnego wzorca dla danego pola.
5. **Języki**: wybór wielokrotny, generowanie jest mnożone (pozycje × języki).
6. **Zakres**: wszystkie encje, lista identyfikatorów albo filtr po kategorii lub producencie.
7. **Limit**: ustaw 10 albo 20 na potrzeby testu, 0 aby przetworzyć wszystko.
8. Kliknij **Utwórz zadanie**.
Zawsze zaczynaj od zadania ograniczonego do 10 albo 20 pozycji, aby zweryfikować ton i format generowanych tekstów, dostosuj wzorzec albo szablon, jeśli trzeba, a następnie uruchom ponownie bez limitu.
## Śledzenie i uruchamianie zadań
Strona **Zadania** wymienia wszystkie zadania z ich postępem, statystykami (udane / nieudane / pominięte) i statusem. Trzy tryby uruchamiania:
- **Uruchom do końca** (strona szczegółów zadania): przetwarza partie w pętli przez AJAX z paskiem postępu na żywo. Zostaw kartę otwartą.
- **Uruchom jedną partię**: przetwarza jedną partię, po czym przeładowuje stronę.
- **CRON**: przetwarzanie w tle, zalecane przy dużych katalogach (opis poniżej).
Zadanie można anulować w trakcie, uruchomić ponownie od początku albo usunąć. Pełna historia każdej generacji (status, tokeny wejściowe i wyjściowe, ewentualny błąd) jest zachowywana w zakładce Historia w szczegółach zadania.
## Konfiguracja CRON
1. W **Ustawieniach**, w sekcji CRON, skopiuj wyświetlony adres URL. Ma on postać: `https://twoj-sklep.pl/modules/dfaimetagen/cron.php?token=TWOJ_TOKEN`
2. Dodaj go do crontaba serwera, na przykład co 5 minut: `*/5 * * * * curl -s "https://twoj-sklep.pl/modules/dfaimetagen/cron.php?token=TWOJ_TOKEN" >/dev/null`
3. Każde przejście przetwarza do 5 partii najstarszego oczekującego zadania. Parametry opcjonalne: `&batch=20` (rozmiar partii) i `&loops=10` (liczba partii na przejście).
Token chroni endpoint: nie udostępniaj go. W razie wątpliwości wygeneruj go ponownie z Ustawień (przycisk „Wygeneruj token ponownie”), pamiętając o aktualizacji crontaba.
## Warianty A/B i aktywacja
Każda generacja tworzy skonfigurowaną liczbę wariantów (od 1 do 5). Pierwszy poprawny wariant jest zapisywany na encji i oznaczany jako **Aktywny**. Pozostałe czekają w rezerwie na stronie szczegółów zadania:
- Kliknij **Aktywuj** obok wariantu, aby natychmiast zapisać go na encji.
- Pozostałe warianty tej samej trójki (encja, pole, język) są automatycznie dezaktywowane.
- Licznik znaków przy każdym wariancie pozwala jednym rzutem oka sprawdzić zgodność z SERP.
## Wzorce CTR
11 preinstalowanych wzorców obejmuje trzy rodziny:
- **Meta tytuły**: korzyść plus rok, lista numerowana, nawiasy z USP, pytanie przyciągające uwagę, słowa o dużej sile oddziaływania.
- **Meta opisy**: nawarstwianie korzyści, społeczny dowód słuszności, problem i rozwiązanie, bezpośrednie CTA.
- **ALT obrazów**: opisowy, kontekstowy.
Aby tworzyć własne wzorce, przejdź do **Katalog > AI Meta Generator > Wzorce**. Szablon przyjmuje tokeny dynamiczne:
- `{NAME}`, `{BRAND}`, `{CATEGORY}`, `{PRICE}`, `{YEAR}`, `{NUMBER}`, `{LANG_NAME}`: wypełniane automatycznie przez moduł;
- `{BENEFIT}`, `{USP}`, `{CONTEXT}`: wypełniane przez AI w momencie generowania.
Wzorce oznaczone jako „systemowe” są dostarczane z modułem i zachowywane przy aktualizacjach.
## Zaawansowane szablony promptów
Aby mieć pełną kontrolę nad zachowaniem AI, twórz szablony w **Katalog > AI Meta Generator > Prompt Templates**. Każdy szablon celuje w trójkę (encja, pole, język albo wszystkie języki) i definiuje:
- **system prompt**: rolę, ton, ograniczenia globalne;
- **user prompt**: z tokenami `{NAME}`, `{BRAND}`, `{CATEGORY}`, `{DESCRIPTION}`, `{PRICE}`, `{PATTERN}`, `{LANG_NAME}`, `{MIN_LENGTH}`, `{MAX_LENGTH}`, `{AB_VARIANTS}`, `{EXISTING}`.
Oznacz szablon jako „domyślny”, aby stosował się automatycznie do swojej trójki.
## Ochrona przed duplikatami
Zanim wariant zostanie zachowany, moduł porównuje go z wariantami już zapisanymi:
1. **Dokładny hash** (sha1 znormalizowanej wersji): natychmiastowe odrzucenie przy idealnym duplikacie.
2. **Podobieństwo Jaccarda** na zbiorach znormalizowanych słów (małe litery, bez znaków diakrytycznych): odrzucenie, jeśli podobieństwo przekracza skonfigurowany próg.
Odrzucony wariant jest automatycznie generowany ponownie przez AI (w granicach liczby prób danej partii).
## Pulpit
Strona **Pulpit** agreguje: liczbę zadań (łącznie, oczekujących, zakończonych), warianty wygenerowane i aktywne, generacje udane i nieudane, zużyte tokeny (wejściowe plus wyjściowe), ostatnie zadania i ostatnie generacje. Używaj jej do pilnowania budżetu AI i wykrywania błędów dostawcy.
## Multistore
Moduł odczytuje i zapisuje wartości z uwzględnieniem kontekstu sklepu, jeśli dana tabela `*_lang` ma kolumnę `id_shop`. Przy instalacji multistore wybierz docelowy sklep w formularzu masowego generowania.
## Rozwiązywanie problemów
- **„FAIL” przy teście połączenia**: sprawdź klucz API, saldo kredytów u dostawcy oraz to, czy Twój serwer zezwala na wychodzące połączenia HTTPS (cURL) do api.anthropic.com, api.openai.com albo api.mistral.ai.
- **Zadanie zablokowane w stanie „running”**: uruchom partię ręcznie ze strony szczegółów albo poczekaj na kolejne przejście CRON. Zadanie zawsze można anulować i uruchomić ponownie.
- **Puste albo przycięte warianty**: zwiększ timeout HTTP w Ustawieniach albo wybierz szybszy model.
- **403 na adresie CRON**: token w adresie URL już nie pasuje (mógł zostać wygenerowany ponownie). Skopiuj adres URL jeszcze raz z Ustawień.
- **Dla niektórych encji nic się nie generuje**: jeśli opcja „Pomiń niepuste” jest aktywna, encje już uzupełnione są celowo pomijane. Zaznacz „Nadpisz”, aby wymusić generowanie.
## Deinstalacja
Deinstalacja usuwa 6 tabel modułu i jego klucze konfiguracji. Metadane wygenerowane i już zapisane na Twoich produktach, kategoriach i obrazach zostają zachowane: należą do Twojego katalogu.