Konfigurationsleitfaden
Dieser umfassende Leitfaden erklärt alle Konfigurationsoptionen für das FEL AI Product Advisor Plugin, von globalen Plugin-Einstellungen bis zur individuellen CMS-Element-Konfiguration.
Konfigurationsübersicht
Der FEL AI Product Advisor hat eine zweistufige Konfigurationsstruktur:
- Globale Plugin-Einstellungen - Gelten für alle Chatbot-Instanzen (optional)
- CMS-Element-Einstellungen - Einzigartige Konfiguration für jede Chatbot-Instanz (Hauptkonfiguration)
Die meiste Anpassung erfolgt auf CMS-Element-Ebene, sodass Sie verschiedene Chatbots für verschiedene Seiten mit einzigartigen Persönlichkeiten, Themes und Einstellungen erstellen können.
Globale Plugin-Konfiguration
Greifen Sie auf die globalen Plugin-Einstellungen zu, indem Sie zu Einstellungen → System → Plugins → Suchen Sie "FEL AI Product Advisor" → Klicken Sie auf "..." → Konfiguration navigieren.
Plugin-Aktivierung
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Plugin aktivieren | Aktivieren oder deaktivieren Sie den Chatbot global auf allen Seiten | ✅ Aktiviert |
Wenn Sie das Plugin hier deaktivieren, werden alle Chatbot-Instanzen in Ihrem gesamten Shop ausgeblendet.
Kundenauthentifizierung
| Einstellung | Beschreibung | Standard |
|---|---|---|
| Nur für authentifizierte Nutzer | Chatbot-Zugriff auf angemeldete Kunden beschränken | ❌ Deaktiviert |
| Kundengruppen | Chatbot auf bestimmte Kundengruppen beschränken | Alle Gruppen |
Anwendungsfälle:
- ✅ B2B-Shops: Nur für Geschäftskunden
- ✅ Premium-Services: Nur für VIP-Kundengruppen
- ✅ Nur-Mitglieder-Beratung: Login für Produktberatung erforderlich
OpenAI API-Konfiguration
Diese Einstellungen werden vom FEL OAI Assistants Manager Basis-Plugin übernommen und müssen nicht separat konfiguriert werden.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Organization ID | - | Optional: Ihre OpenAI Organization ID |
| API Base URL | https://api.openai.com | OpenAI API-Endpunkt (nicht ändern) |
| API Version | v1 | API-Version (nicht ändern) |
| API Beta Version | assistants=v2 | Beta-Funktionen (empfohlen: v2) |
| Max. Versuche | 50 | Maximale Schleifeniterationen vor Timeout |
| Wartezeit (Sekunden) | 2 | Wartezeit zwischen API-Anfragen |
- Max. Versuche: 30-50 ist optimal für die meisten Anwendungsfälle
- Wartezeit: 2 Sekunden ist ideal - erhöhen Sie für langsamere API-Antworten
Inhaltsoptimierungs-Einstellungen
Konfigurieren Sie, wie Produkte und Inhalte der KI bereitgestellt werden.
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Maximale Eingabelänge | 400 | Maximale Zeichen pro Kundennachricht |
| Suchergebnis-Limit | 8 | Maximale Produkte in internen Suchen zurückgegeben |
| Max. Beschreibungslänge | 500 | Produktbeschreibungen bei dieser Länge abschneiden |
| Max. Produkte im Chat | 4 | Anzahl der direkt im Chat angezeigten Produkte |
Erweiterte Inhaltsfilter
Kategorien ausschließen
- Wählen Sie Kategorien aus, die von KI-Empfehlungen ausgeschlossen werden sollen
- Reduziert Komplexität und verbessert Leistung
- Empfohlen: Service-Kategorien, interne Kategorien ausschließen
Kategorie-Level definieren
- Standard:
0(zeigt alle Ebenen) - Beispiel:
1beginnt bei "Katalog #1" statt "Startseite" - Vereinfacht Breadcrumb-Navigation
Hersteller ausschließen
- Bestimmte Hersteller von Empfehlungen ausschließen
- Nützlich für begrenzt verfügbare Marken oder eingestellte Produkte
Eigenschaftsgruppen filtern
- Leer: Alle Eigenschaftsgruppen verfügbar
- Gefüllt: Nur ausgewählte Gruppen (z.B. "Farbe", "Größe")
- Reduziert Informationsüberflutung für die KI
Max. Eigenschaften pro Gruppe
- Standard:
20 - Empfohlen: 15-25 für optimale Leistung
- Verhindert Überlastung bei vielen Produktvarianten
Je weniger Daten die KI verarbeiten muss, desto schneller und präziser die Antworten. Nutzen Sie Filteroptionen strategisch!
CMS-Element-Konfiguration
Die Hauptkonfiguration erfolgt, wenn Sie den Chatbot als CMS-Element zu Ihren Seiten hinzufügen.
Chatbot zur Seite hinzufügen
- Navigieren Sie zu Inhalte → Erlebniswelten
- Bearbeiten Sie eine vorhandene Seite oder erstellen Sie eine neue
- Ziehen Sie das "KI Produktberater" Element in Ihr Layout
- Klicken Sie auf das Element, um Konfigurationsoptionen zu öffnen
Tab 1: Chatbot-Einstellungen
Basis-Chatbot-Konfiguration
| Einstellung | Beschreibung | Beispiel |
|---|---|---|
| Assistent auswählen | Wählen Sie einen konfigurierten OpenAI Assistant | "Product Advisor DE" |
| Berater Titel | Im Chat-Fenster-Header angezeigter Titel | "Ihr persönlicher Produktberater" |
| Berater Name | Name des Assistenten | "Max" |
| Kategorie | Optional: Auf bestimmte Produktkategorie beschränken | "Herrenmode" |
| Begrüßungsnachricht | Erste dem Kunden angezeigte Nachricht | "Hallo! Wie kann ich Ihnen helfen?" |
| Chat-Fenster Höhe | Höhe des Chat-Fensters in Pixeln | 420 (Standard) |
| Avatar | Profilbild für den Assistenten | Bilddatei hochladen |
Produktberater für (AI-Anweisungen)
Dieses Feld enthält den System-Prompt, der das Verhalten und die Persönlichkeit der KI definiert.
Bereitgestellte Standard-Vorlage: Das Plugin enthält eine professionelle Prompt-Vorlage, die für Produktberatung optimiert ist.
Anpassung: Verwenden Sie den ChatGPT Prompt Generator für optimale, auf Ihren Produktkatalog zugeschnittene Ergebnisse.
Tab 2: Design-Einstellungen
| Einstellung | Beschreibung |
|---|---|
| Chat-Theme | Visuelles Design-Theme (siehe Chat Themes) |
| Chat-Theme-Farbe | Primärfarbe für Standard-Theme (Hex-Code, z.B. #3b82f6) |
| Runde Ecken | Abgerundete Ränder für Chat-Elemente aktivieren |
1. Standard (Anpassbar)
- Anwendungsfall: Universelle Anwendung
- Funktionen:
- Vollständig anpassbare Theme-Farbe
- Optionale abgerundete Ecken
- Passt sich Ihrem Shop-Design an
- Empfohlen für: Standard-Shops, individuelle Branding-Anforderungen
2. Clean (2025 Modern Advisor)
- Anwendungsfall: Moderner E-Commerce
- Funktionen:
- Klare Linien und professionelles Aussehen
- Optimiert für Produktpräsentation
- Sanfte Animationen
- Empfohlen für: Mode, Elektronik, Premium-Produkte
3. Minimal (Ultra-clean SaaS)
- Anwendungsfall: Minimalistisches Design
- Funktionen:
- Schwarz-Weiß-Farbschema
- Fokus auf Inhalt
- Sehr schnell und performant
- Empfohlen für: B2B, Software, technische Produkte
4. Glass (Modern Glassmorphism)
- Anwendungsfall: Moderne, luftige Designs
- Funktionen:
- Mattglas-Effekt mit Backdrop-Blur
- Transparente Elemente
- Moderner iOS-Stil-Look
- Empfohlen für: Lifestyle, Design-Produkte, Premium-Marken
5. Dark (Premium Night Mode)
- Anwendungsfall: Dunkelmodus
- Funktionen:
- Eleganter Dunkelmodus
- Augenfreundlich
- Premium-Gefühl
- Empfohlen für: Gaming, Elektronik, Tech-Produkte
6. Space (Neon Futuristic)
- Anwendungsfall: Futuristisches Design
- Funktionen:
- Neon-Farbverläufe (blau/pink)
- Leuchteffekte
- Sci-Fi-Ästhetik
- Empfohlen für: Gaming, Tech-Gadgets, innovative Produkte
Themes können jederzeit in den CMS-Element-Einstellungen geändert werden. Änderungen sind sofort sichtbar.
Für detaillierte Theme-Informationen siehe Design-Anpassung.
Best Practices für Systemanweisungen
Das Feld Produktberater für ist entscheidend für die Effektivität der KI. Befolgen Sie diese Richtlinien:
Struktur für effektive Prompts
Sie sind ein [spezifische Rolle] für unseren Online-Shop.
Ihre Aufgabe ist es, Kunden zu helfen, die richtigen Produkte zu finden.
Seien Sie [Persönlichkeitsmerkmale] und [Kommunikationsstil].
Bei der Unterstützung von Kunden:
- Stellen Sie spezifische Fragen zu [Anforderungen]
- Konzentrieren Sie sich auf [Schlüsselfaktoren]
- Präsentieren Sie maximal 3-4 Produkte auf einmal
- Erklären Sie, warum ein Produkt geeignet ist
Verwenden Sie die Produktsuche, um passende Produkte zu finden.
Beispiel: Outdoor-Ausrüstungs-Berater
Sie sind ein freundlicher Berater für Outdoor-Ausrüstung.
Stellen Sie gezielte Fragen zu:
- Anwendungsfall (Wandern, Camping, Klettern)
- Erfahrungsniveau (Anfänger, Fortgeschritten, Profi)
- Budget
- Besondere Anforderungen (Wetter, Gelände)
Empfehlen Sie maximal 3-4 Produkte mit Begründung.
Verwenden Sie den ChatGPT Prompt Generator für professionelle, optimierte Prompts, die auf Ihren Produktkatalog zugeschnitten sind.
Leistungsoptimierung
Modellauswahl
Wählen Sie das passende Modell basierend auf Ihren Anforderungen:
| Modell | Kosten | Qualität | Am besten für |
|---|---|---|---|
| GPT-4o-mini | ⭐ Sehr niedrig | ⭐⭐⭐⭐ Ausgezeichnet | Standard-Produktberatung, die meisten Anwendungsfälle |
| GPT-5-mini | ⭐ Sehr niedrig | ⭐⭐⭐⭐ Ausgezeichnet | Neuestes Mini-Modell, ausgezeichnetes Preis-Leistungs-Verhältnis |
| GPT-4o | ⭐⭐ Mittel | ⭐⭐⭐⭐⭐ Herausragend | Komplexe Produkte, fortgeschrittenes Reasoning |
| Reasoning Models | ⭐⭐⭐ Höher | ⭐⭐⭐⭐⭐ Herausragend | Komplexe Entscheidungsfindung, tiefe Analyse |
Mini-Modelle (GPT-4o-mini, GPT-5-mini) bieten ausgezeichnete Leistung zu sehr erschwinglichen Kosten - perfekt für die meisten E-Commerce-Anwendungsfälle. Premium-Modelle bieten erweiterte Funktionen wie Reasoning, erfordern jedoch Überwachung der Token-Nutzung zur Kostenkontrolle.
Token-Optimierung
Reduzieren Sie API-Kosten durch Optimierung der Token-Nutzung:
- ✅ Halten Sie Systemanweisungen prägnant
- ✅ Begrenzen Sie Produktbeschreibungslänge (500 Zeichen)
- ✅ Filtern Sie unnötige Kategorien und Eigenschaften
- ✅ Beschränken Sie Suchergebnisse (8 Produkte max)
- ✅ Begrenzen Sie angezeigte Produkte (4 im Chat)
Interaktive Funktionen
Button-Syntax in Chat-Nachrichten
Der Chatbot unterstützt interaktive Buttons für bessere UX:
Syntax:
[BUTTON:Button-Text]
Beispiele:
Welche Kategorie interessiert Sie?
[BUTTON:Herrenschuhe] [BUTTON:Damenschuhe] [BUTTON:Kinderschuhe]
In welcher Preisklasse?
[BUTTON:Bis 50€] [BUTTON:50-100€] [BUTTON:Über 100€]
Options-Buttons werden automatisch abgesendet, wenn sie angeklickt werden - Kunden müssen nicht auf "Senden" klicken!
Nächste Schritte
Nach der Konfiguration Ihres Produktberaters:
- Design-Anpassung - Erkunden Sie alle 6 Themes im Detail
- Best Practices - Lernen Sie Optimierungsstrategien
- Produktberater erstellen - Stellen Sie Ihren konfigurierten Chatbot bereit
- Fehlerbehebung - Lösen Sie häufige Konfigurationsprobleme
Sie sind nun bereit, Ihren AI-Produktberater einzusetzen. Gehen Sie zu Produktberater erstellen, um ihn zu Ihren Seiten hinzuzufügen!