# FAQ AI Produkt — Kompletny przewodnik instalacji i konfiguracji
> Prezentacja DataFirefly FAQ AI Produkt automatycznie generuje kontekstowe FAQ dla kart produktów PrestaShop 8 przez OpenAI lub Anthropic Claude, z wstrzykiwaniem rich snippets Schema.org FAQPage do sekcji head dla wyników…
- Strona:
- Język: pl
- Zaktualizowano: 2026-08-12
- Inne języki: [fr](https://www.datafirefly.com/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md)
- Indeks:
## Prezentacja
**DataFirefly FAQ AI Produkt** automatycznie generuje kontekstowe FAQ dla kart produktów PrestaShop 8 przez OpenAI lub Anthropic Claude, z wstrzykiwaniem rich snippets Schema.org `FAQPage` do sekcji head dla wyników rozszerzonych Google. FAQ są przechowywane w bazie (tabela `ps_product_faq`) — żadne wywołanie API nie jest wykonywane po stronie front-office.
- **Kompatybilność:** PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
- **Wielojęzyczność:** FAQ generowane i przechowywane per język
- **Multistore:** niezależna konfiguracja per pod-sklep
## Instalacja
1. W back-office przejdź do **Moduły → Menedżer modułów → Zainstaluj moduł**.
2. Wgraj `productfaqai-3.0.0.zip`.
3. Kliknij **Zainstaluj**, potem **Konfiguruj**.
**Aktualizacja z v2.x (moduł Sash):** upgrade jest niedestrukcyjny. Schemat tabeli `ps_product_faq` pozostaje bez zmian — istniejące FAQ są zachowane. Po prostu zainstaluj v3.0.0 na wierzchu, a potem skonfiguruj ponownie klucz API w nowym interfejsie.
## 1. Dostawca AI i model
Pierwszy formularz strony konfiguracji.
- **Dostawca AI:** OpenAI lub Anthropic Claude. Moduł automatycznie przełącza się na właściwe API.
- **Klucz API OpenAI:** z [platform.openai.com](https://platform.openai.com) (zaczyna się od `sk-`).
- **Klucz API Anthropic:** z [console.anthropic.com](https://console.anthropic.com) (zaczyna się od `sk-ant-`).
- **Model:** dla OpenAI zalecany `gpt-4o-mini` (najtańszy). Dla Anthropic zalecany `claude-haiku-4-5`.
- **Liczba pytań:** 1 do 15 (domyślnie 5).
- **Temperatura:** 0 = deterministyczna, 2 = bardzo kreatywna. Zalecane: 0,7.
- **Max tokens:** maksymalna długość odpowiedzi (domyślnie 2000). Zwiększ, jeśli generujesz ponad 8 pytań.
- **Auto-generowanie:** automatycznie generuje FAQ (język domyślny) przy każdym utworzeniu produktu.
**Orientacyjny koszt:** generacja 5 pytań kosztuje ~0,0005 $ z gpt-4o-mini i ~0,001 $ z claude-haiku-4-5. 200 produktów × 3 języki ≈ 0,30 do 0,60 $ łącznie.
## 2. Prompt i wytyczne treści
Drugi formularz — steruje jakością i stylem generowanych FAQ.
- **Ton wypowiedzi:** profesjonalny, przyjazny, swobodny, techniczny, entuzjastyczny lub uspokajający.
- **Grupa docelowa** (opcjonalnie): tekst dowolny, np. „profesjonaliści medyczni B2B”, „kupujący po raz pierwszy”. AI dostosowuje słownictwo i poziom szczegółowości.
- **Własny prompt systemowy** (opcjonalnie): całkowicie zastępuje domyślne instrukcje. Zostaw puste, aby użyć wbudowanego promptu.
- **Dodatkowe wytyczne** (opcjonalnie): instrukcje dodawane do promptu, np. „zawsze wspominaj o 2-letniej gwarancji”, „unikaj żargonu”.
- **Dołącz kategorię / producenta / cechy:** trzy przełączniki wzbogacające kontekst wysyłany do AI. Włącz „cechy” dla produktów technicznych — precyzja odpowiedzi wyraźnie rośnie.
## 3. Wyświetlanie i SEO
- **Pozycja wyświetlania (hook):** wybierz spośród 5 miejsc:
- `displayProductFooter` — pod całą kartą (domyślnie, działa wszędzie)
- `displayFooterProduct` — wariant zależny od motywu
- `displayProductAdditionalInfo` — pod przyciskiem zakupu (bardziej widoczny)
- `displayReassurance` — blok zaufania
- `displayAfterProductThumbs` — pod miniaturami
- **Tytuł FAQ:** jedno pole na każdy język sklepu. Domyślne wartości w FR/EN/ES/DE/IT/PT/NL.
- **Tryb akordeonu:** włączony = pytania zwijane (pierwsze otwarte). Wyłączony = wszystkie odpowiedzi widoczne.
- **Rich snippets JSON-LD:** wstrzykuje znaczniki Schema.org `FAQPage` do head. Zalecane: włączone.
- **Wykluczone kategorie:** ID rozdzielone przecinkami (np. `12,45,78`). Produkty z tych kategorii są pomijane przy generowaniu masowym.
Moduł rejestruje 5 hooków przy instalacji, ale renderuje blok tylko w skonfigurowanym hooku. Jeśli hook nie istnieje w Twoim motywie, blok po prostu się nie wyświetli — najpierw przetestuj z domyślnym hookiem.
## Generowanie FAQ
### Generowanie pojedyncze
W panelu „Generuj FAQ dla produktów” każdy wiersz produktu ma przycisk **Generuj**. Najpierw wybierz język docelowy w rozwijanym menu u góry tabeli. Liczba istniejących FAQ per język jest wyświetlana dla każdego produktu.
### Generowanie masowe
- **Generuj dla wszystkich produktów (bieżący język):** przetwarza wszystkie produkty bez FAQ w aktywnym języku.
- **Generuj dla wszystkich produktów (wszystkie języki):** przetwarza wszystkie aktywne języki sklepu.
- **Wymuś regenerację:** zaznacz, aby nadpisać istniejące FAQ — przydatne po zmianie promptu, tonu lub dostawcy.
**Czas trwania:** licz ~1 produkt/sekundę na język (zmienna latencja API). 100 produktów × 3 języki ≈ 5 minut. Nie zamykaj karty podczas przetwarzania. Produkty z wykluczonych kategorii są automatycznie pomijane.
### Auto-generowanie
Jeśli włączone w pierwszym formularzu, każdy nowy produkt (hook `actionProductAdd`) automatycznie otrzymuje FAQ w domyślnym języku sklepu.
## Edytor FAQ per produkt
Kliknij **Edytuj FAQ** w wierszu produktu, aby otworzyć edytor:
- **Selektor języka** u góry — natychmiastowe przełączanie między językami.
- **Pozycja:** waga numeryczna, rosnąca kolejność wyświetlania.
- **Pytanie / Odpowiedź:** bezpośrednia edycja tekstu.
- **Status:** włączanie/wyłączanie wpisu bez usuwania (nieaktywny wpis nie pojawia się ani na karcie, ani w JSON-LD).
- **Usuń:** trwałe usunięcie wpisu.
- **Dodaj FAQ:** ręczne dodanie pytania/odpowiedzi.
Kliknij **Zapisz**, aby zatwierdzić wszystkie zmiany na stronie.
## Rich snippets FAQPage
Gdy opcja JSON-LD jest aktywna, moduł wstrzykuje do `head` każdej karty produktu z co najmniej jedną aktywną FAQ blok `application/ld+json` zgodny ze Schema.org `FAQPage`:
```
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "…",
"acceptedAnswer": { "@type": "Answer", "text": "…" }
}
]
}
```
Zweryfikuj znaczniki [testem wyników rozszerzonych Google](https://search.google.com/test/rich-results). Pojawienie się w SERP zależy od Google i może zająć kilka dni po ponownym zaindeksowaniu strony.
## Rozwiązywanie problemów
### „Skonfiguruj swój klucz API”
Klucz wybranego dostawcy jest pusty lub nieprawidłowy. Sprawdź, czy klucz odpowiada aktywnemu dostawcy (OpenAI = `sk-…`, Anthropic = `sk-ant-…`).
### Błędy generowania masowego
Błędy API (przekroczony limit, unieważniony klucz, timeout) są zapisywane w **Zaawansowane → Logi** przez PrestaShopLogger. Podsumowanie po przetworzeniu pokazuje szczegóły sukcesów / pominięć / błędów per język.
### FAQ nie wyświetla się na karcie produktu
1. Sprawdź, czy produkt ma co najmniej jedną **aktywną** FAQ w przeglądanym języku.
2. Sprawdź, czy skonfigurowany hook istnieje w Twoim motywie — wróć na `displayProductFooter` dla testu.
3. Wyczyść cache PrestaShop (**Zaawansowane → Wydajność**).
### Rich snippets nie pojawiają się w Google
Znaczniki mogą być poprawne, a Google i tak ich nie wyświetlać: pokazywanie wyników rozszerzonych pozostaje decyzją Google. Najpierw sprawdź znaczniki testem wyników rozszerzonych, potem poczekaj na ponowne zaindeksowanie.
## Odinstalowanie
Odinstalowanie usuwa tabelę `ps_product_faq` (wszystkie wygenerowane FAQ) i wszystkie klucze konfiguracji. Wymagane jest potwierdzenie. W razie potrzeby wcześniej wyeksportuj dane.