# Produkt-FAQ KI — Vollständige Installations- und Konfigurationsanleitung

> Überblick DataFirefly Produkt-FAQ KI generiert automatisch kontextbezogene FAQs für Ihre PrestaShop-8-Produktseiten über OpenAI oder Anthropic Claude und injiziert Schema.org-FAQPage-Rich-Snippets in den Head für Google Rich Results. Die FAQs werden in…

- Seite: <https://www.datafirefly.com/de/documentation/datafirefly-faq-ia-produit-prestashop-8/>
- Sprache: de
- Aktualisiert am: 2026-07-02
- Weitere Sprachen: [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), [it](https://www.datafirefly.com/it/documentation/datafirefly-faq-ia-produit-prestashop-8/index.md), [pl](https://www.datafirefly.com/pl/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)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

**DataFirefly Produkt-FAQ KI** generiert automatisch kontextbezogene FAQs für Ihre PrestaShop-8-Produktseiten über OpenAI oder Anthropic Claude und injiziert Schema.org-`FAQPage`-Rich-Snippets in den Head für Google Rich Results. Die FAQs werden in der Datenbank gespeichert (Tabelle `ps_product_faq`) — im Front-Office erfolgt kein API-Aufruf.

- **Kompatibilität:** PrestaShop 8.0 → 8.99, PHP 7.2 → 8.3
- **Mehrsprachig:** FAQs werden pro Sprache generiert und gespeichert
- **Multishop:** unabhängige Konfiguration pro Sub-Shop

## Installation

1. Gehen Sie im Back-Office zu **Module → Modul-Manager → Modul hochladen**.
2. Laden Sie `productfaqai-3.0.0.zip` hoch.
3. Klicken Sie auf **Installieren**, dann auf **Konfigurieren**.

**Upgrade von v2.x (Sash-Modul):** Das Upgrade ist nicht destruktiv. Das Schema der Tabelle `ps_product_faq` bleibt unverändert — Ihre bestehenden FAQs bleiben erhalten. Installieren Sie einfach v3.0.0 darüber und konfigurieren Sie Ihren API-Schlüssel in der neuen Oberfläche neu.

## 1. KI-Anbieter & Modell

Erstes Formular auf der Konfigurationsseite.

- **KI-Anbieter:** OpenAI oder Anthropic Claude. Das Modul wechselt automatisch zur richtigen API.
- **OpenAI-API-Schlüssel:** von [platform.openai.com](https://platform.openai.com) (beginnt mit `sk-`).
- **Anthropic-API-Schlüssel:** von [console.anthropic.com](https://console.anthropic.com) (beginnt mit `sk-ant-`).
- **Modell:** für OpenAI wird `gpt-4o-mini` empfohlen (am günstigsten). Für Anthropic wird `claude-haiku-4-5` empfohlen.
- **Anzahl der Fragen:** 1 bis 15 (Standard: 5).
- **Temperatur:** 0 = deterministisch, 2 = sehr kreativ. Empfohlen: 0,7.
- **Max. Tokens:** maximale Antwortlänge (Standard: 2000). Erhöhen Sie den Wert bei mehr als 8 Fragen.
- **Auto-Generierung:** generiert die FAQ automatisch (Standardsprache) bei jeder Produkterstellung.

**Richtwert Kosten:** Die Generierung von 5 Fragen kostet ~0,0005 $ mit gpt-4o-mini und ~0,001 $ mit claude-haiku-4-5. 200 Produkte × 3 Sprachen ≈ 0,30 bis 0,60 $ insgesamt.

## 2. Prompt & Inhaltsvorgaben

Zweites Formular — steuert Qualität und Stil der generierten FAQs.

- **Tonfall:** professionell, freundlich, locker, technisch, enthusiastisch oder beruhigend.
- **Zielgruppe** (optional): Freitext, z. B. „B2B-Mediziner", „Erstkäufer". Die KI passt Vokabular und Detailtiefe an.
- **Benutzerdefinierter System-Prompt** (optional): ersetzt die Standardanweisungen vollständig. Leer lassen, um den integrierten Prompt zu verwenden.
- **Zusätzliche Vorgaben** (optional): an den Prompt angehängte Anweisungen, z. B. „immer die 2-Jahres-Garantie erwähnen", „Fachjargon vermeiden".
- **Kategorie / Hersteller / Eigenschaften einbeziehen:** drei Schalter, die den an die KI gesendeten Kontext anreichern. Aktivieren Sie „Eigenschaften" bei technischen Produkten — die Präzision der Antworten verbessert sich deutlich.

## 3. Anzeige & SEO

- **Anzeigeposition (Hook):** Wählen Sie eine von 5 Positionen:
   - `displayProductFooter` — unter der gesamten Produktseite (Standard, funktioniert überall)
   - `displayFooterProduct` — Variante je nach Theme
   - `displayProductAdditionalInfo` — unter dem Kaufen-Button (sichtbarer)
   - `displayReassurance` — Vertrauensblock
   - `displayAfterProductThumbs` — unter den Miniaturansichten
- **FAQ-Titel:** ein Feld pro Shop-Sprache. Standardwerte in FR/EN/ES/DE/IT/PT/NL vorhanden.
- **Akkordeon-Modus:** aktiviert = einklappbare Fragen (erste geöffnet). Deaktiviert = alle Antworten sichtbar.
- **JSON-LD Rich Snippets:** injiziert das Schema.org-`FAQPage`-Markup in den Head. Empfohlen: aktiviert.
- **Ausgeschlossene Kategorien:** kommagetrennte IDs (z. B. `12,45,78`). Produkte dieser Kategorien werden bei der Massengenerierung übersprungen.

Das Modul registriert bei der Installation alle 5 Hooks, rendert den Block aber nur am konfigurierten. Existiert ein Hook in Ihrem Theme nicht, wird der Block einfach nicht angezeigt — testen Sie zuerst mit dem Standard-Hook.

## FAQs generieren

### Einzelgenerierung

Im Panel „FAQs für Produkte generieren" zeigt jede Produktzeile einen **Generieren**-Button. Wählen Sie zuerst die Zielsprache im Dropdown über der Tabelle. Die Anzahl vorhandener FAQs pro Sprache wird für jedes Produkt angezeigt.

### Massengenerierung

- **Für alle Produkte generieren (aktuelle Sprache):** verarbeitet alle Produkte ohne FAQ in der aktiven Sprache.
- **Für alle Produkte generieren (alle Sprachen):** verarbeitet alle aktiven Shop-Sprachen.
- **Regenerierung erzwingen:** aktivieren Sie diese Checkbox, um bestehende FAQs zu überschreiben — nützlich nach einer Änderung von Prompt, Tonfall oder Anbieter.

**Dauer:** Rechnen Sie mit ~1 Produkt/Sekunde pro Sprache (API-Latenz variiert). 100 Produkte × 3 Sprachen ≈ 5 Minuten. Schließen Sie den Tab während der Verarbeitung nicht. Produkte in ausgeschlossenen Kategorien werden automatisch übersprungen.

### Auto-Generierung

Wenn im ersten Formular aktiviert, erhält jedes neue Produkt (Hook `actionProductAdd`) automatisch eine FAQ in der Standardsprache des Shops.

## FAQ-Editor pro Produkt

Klicken Sie auf **FAQs bearbeiten** in einer Produktzeile, um den Editor zu öffnen:

- **Sprachauswahl** oben — sofortiger Wechsel zwischen den Sprachen.
- **Position:** numerisches Gewicht, aufsteigende Anzeigereihenfolge.
- **Frage / Antwort:** direkte Textbearbeitung.
- **Status:** Eintrag aktivieren/deaktivieren, ohne ihn zu löschen (ein inaktiver Eintrag erscheint weder auf der Seite noch im JSON-LD).
- **Löschen:** endgültiges Entfernen eines Eintrags.
- **FAQ hinzufügen:** manuelles Hinzufügen einer Frage/Antwort.

Klicken Sie auf **Speichern**, um alle Änderungen der Seite zu übernehmen.

## FAQPage Rich Snippets

Wenn die JSON-LD-Option aktiviert ist, injiziert das Modul in den `head` jeder Produktseite mit mindestens einer aktiven FAQ einen `application/ld+json`-Block gemäß Schema.org `FAQPage`:

```
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "…",
      "acceptedAnswer": { "@type": "Answer", "text": "…" }
    }
  ]
}
```

Überprüfen Sie das Markup mit dem [Google-Test für Rich-Suchergebnisse](https://search.google.com/test/rich-results). Die Anzeige in der SERP liegt bei Google und kann nach der Neuindexierung der Seite mehrere Tage dauern.

## Fehlerbehebung

### „Bitte konfigurieren Sie Ihren API-Schlüssel"

Der Schlüssel des ausgewählten Anbieters ist leer oder ungültig. Prüfen Sie, ob der Schlüssel zum aktiven Anbieter passt (OpenAI = `sk-…`, Anthropic = `sk-ant-…`).

### Fehler bei der Massengenerierung

API-Fehler (Kontingent überschritten, widerrufener Schlüssel, Timeout) werden über PrestaShopLogger in **Erweiterte Einstellungen → Logs** protokolliert. Der Abschlussbericht zeigt die Aufschlüsselung Erfolge / Übersprungen / Fehler pro Sprache.

### Die FAQ erscheint nicht auf der Produktseite

1. Prüfen Sie, ob das Produkt mindestens eine **aktive** FAQ in der angezeigten Sprache hat.
2. Prüfen Sie, ob der konfigurierte Hook in Ihrem Theme existiert — wechseln Sie zum Testen zurück zu `displayProductFooter`.
3. Leeren Sie den PrestaShop-Cache (**Erweiterte Einstellungen → Leistung**).

### Rich Snippets erscheinen nicht in Google

Das Markup kann gültig sein, ohne dass Google es anzeigt: Rich Results liegen im Ermessen von Google. Validieren Sie zuerst das Markup mit dem Rich-Results-Test und warten Sie dann die Neuindexierung ab.

## Deinstallation

Die Deinstallation löscht die Tabelle `ps_product_faq` (alle generierten FAQs) und entfernt alle Konfigurationsschlüssel. Eine Bestätigung wird angefordert. Exportieren Sie Ihre Daten vorher, falls nötig.