Configuration Guide
This comprehensive guide explains all configuration options for the FEL AI Product Advisor plugin, from global plugin settings to individual CMS element configuration.
Configuration Overview
The FEL AI Product Advisor has a two-tier configuration structure:
- Global Plugin Settings - Apply to all chatbot instances (optional)
- CMS Element Settings - Unique configuration for each chatbot instance (main configuration)
Most customization happens at the CMS element level, allowing you to create different chatbots for different pages with unique personalities, themes, and settings.
Global Plugin Configuration
Access global plugin settings by navigating to Settings → System → Plugins → Find "FEL AI Product Advisor" → Click "..." → Configuration.
Plugin Activation
| Setting | Description | Default |
|---|---|---|
| Plugin aktivieren | Enable or disable the chatbot globally across all pages | ✅ Enabled |
Disabling the plugin here will hide all chatbot instances across your entire store.
Customer Authentication
| Setting | Description | Default |
|---|---|---|
| Nur für authentifizierte Nutzer | Restrict chatbot access to logged-in customers only | ❌ Disabled |
| Kundengruppen | Limit chatbot to specific customer groups | All groups |
Use Cases:
- ✅ B2B Stores: Restrict to business customers only
- ✅ Premium Services: Limit to VIP customer groups
- ✅ Member-Only Advice: Require login for product consultation
OpenAI API Configuration
These settings are inherited from the FEL OAI Assistants Manager base plugin and don't need to be configured separately.
| Setting | Standard | Description |
|---|---|---|
| Organization ID | - | Optional: Your OpenAI Organization ID |
| API Base URL | https://api.openai.com | OpenAI API endpoint (don't change) |
| API Version | v1 | API version (don't change) |
| API Beta Version | assistants=v2 | Beta features (recommended: v2) |
| Max. Versuche | 50 | Maximum loop iterations before timeout |
| Wartezeit (Sekunden) | 2 | Wait time between API requests |
- Max. Versuche: 30-50 is optimal for most use cases
- Wartezeit: 2 seconds is ideal - increase for slower API responses
Content Optimization Settings
Configure how products and content are provided to the AI.
| Setting | Default | Description |
|---|---|---|
| Maximale Eingabelänge | 400 | Maximum characters per customer message |
| Suchergebnis-Limit | 8 | Maximum products returned in internal searches |
| Max. Beschreibungslänge | 500 | Truncate product descriptions at this length |
| Max. Produkte im Chat | 4 | Number of products displayed directly in chat |
Advanced Content Filters
Kategorien ausschließen
- Select categories to exclude from AI recommendations
- Reduces complexity and improves performance
- Recommended: Exclude service categories, internal categories
Kategorie-Level definieren
- Default:
0(shows all levels) - Example:
1starts at "Catalog #1" instead of "Home" - Simplifies breadcrumb navigation
Hersteller ausschließen
- Exclude specific manufacturers from recommendations
- Useful for limited-availability brands or discontinued products
Eigenschaftsgruppen filtern
- Empty: All property groups available
- Filled: Only selected groups (e.g., "Color", "Size")
- Reduces information overload for the AI
Max. Eigenschaften pro Gruppe
- Default:
20 - Recommended: 15-25 for optimal performance
- Prevents overload with many product variants
The less data the AI needs to process, the faster and more precise the responses. Use filter options strategically!
CMS Element Configuration
The main configuration happens when you add the chatbot as a CMS element to your pages.
Adding the Chatbot to a Page
- Navigate to Content → Shopping Experiences
- Edit an existing page or create a new one
- Drag the "KI Produktberater" element into your layout
- Click on the element to open configuration options
Tab 1: Chatbot Settings
Basic Chatbot Configuration
| Setting | Description | Example |
|---|---|---|
| Assistent auswählen | Choose a configured OpenAI Assistant | "Product Advisor DE" |
| Berater Titel | Title displayed in chat window header | "Your Personal Product Advisor" |
| Berater Name | Name of the assistant | "Max" |
| Kategorie | Optional: Restrict to specific product category | "Men's Fashion" |
| Begrüßungsnachricht | First message shown to customer | "Hello! How can I help you?" |
| Chat-Fenster Höhe | Height of chat window in pixels | 420 (default) |
| Avatar | Profile picture for the assistant | Upload image file |
Produktberater für (AI Instructions)
This field contains the system prompt that defines the AI's behavior and personality.
Default Template Provided: The plugin includes a professional prompt template optimized for product consultation.
Customization: Use the ChatGPT Prompt Generator for optimal results tailored to your product catalog.
Tab 2: Design Settings
| Setting | Description |
|---|---|
| Chat-Theme | Visual design theme (see Chat Themes) |
| Chat-Theme-Farbe | Primary color for Standard theme (Hex code, e.g., #3b82f6) |
| Runde Ecken | Enable rounded borders for chat elements |
1. Standard (Anpassbar)
- Use Case: Universal application
- Features:
- Fully customizable theme color
- Optional rounded corners
- Adapts to your shop design
- Recommended for: Standard shops, custom branding requirements
2. Clean (2025 Modern Advisor)
- Use Case: Modern e-commerce
- Features:
- Clean lines and professional look
- Optimized for product presentation
- Smooth animations
- Recommended for: Fashion, electronics, premium products
3. Minimal (Ultra-clean SaaS)
- Use Case: Minimalist design
- Features:
- Black and white color scheme
- Focus on content
- Very fast and performant
- Recommended for: B2B, software, technical products
4. Glass (Modern Glassmorphism)
- Use Case: Modern, airy designs
- Features:
- Frosted glass effect with backdrop blur
- Transparent elements
- Modern iOS-style look
- Recommended for: Lifestyle, design products, premium brands
5. Dark (Premium Night Mode)
- Use Case: Dark mode
- Features:
- Elegant dark mode
- Eye-friendly
- Premium feel
- Recommended for: Gaming, electronics, tech products
6. Space (Neon Futuristic)
- Use Case: Futuristic design
- Features:
- Neon gradients (blue/pink)
- Glowing effects
- Sci-fi aesthetic
- Recommended for: Gaming, tech gadgets, innovative products
Themes can be changed at any time in the CMS element settings. Changes are immediately visible.
For detailed theme information, see Design Customization.
System Instruction Best Practices
The Produktberater für field is crucial for the AI's effectiveness. Follow these guidelines:
Structure for Effective Prompts
You are a [specific role] for our online shop.
Your task is to help customers find the right products.
Be [personality traits] and [communication style].
When helping customers:
- Ask specific questions about [requirements]
- Focus on [key factors]
- Present maximum 3-4 products at once
- Explain why a product is suitable
Use the product search to find matching products.
Example: Outdoor Equipment Advisor
You are a friendly advisor for outdoor equipment.
Ask targeted questions about:
- Use case (hiking, camping, climbing)
- Experience level (beginner, advanced, professional)
- Budget
- Special requirements (weather, terrain)
Recommend maximum 3-4 products with reasoning.
Use the ChatGPT Prompt Generator for professional, optimized prompts tailored to your product catalog.
Performance Optimization
Model Selection
Choose the appropriate model based on your needs:
| Model | Cost | Quality | Best For |
|---|---|---|---|
| GPT-4o-mini | ⭐ Very Low | ⭐⭐⭐⭐ Excellent | Standard product consultation, most use cases |
| GPT-5-mini | ⭐ Very Low | ⭐⭐⭐⭐ Excellent | Latest mini model, excellent value |
| GPT-4o | ⭐⭐ Medium | ⭐⭐⭐⭐⭐ Outstanding | Complex products, advanced reasoning |
| Reasoning Models | ⭐⭐⭐ Higher | ⭐⭐⭐⭐⭐ Outstanding | Complex decision-making, deep analysis |
Mini models (GPT-4o-mini, GPT-5-mini) offer excellent performance at very affordable costs - perfect for most e-commerce use cases. Premium models provide advanced capabilities like reasoning but require monitoring token usage to manage costs.
Token Optimization
Reduce API costs by optimizing token usage:
- ✅ Keep system instructions concise
- ✅ Limit product description length (500 chars)
- ✅ Filter unnecessary categories and properties
- ✅ Restrict search results (8 products max)
- ✅ Limit displayed products (4 in chat)
Interactive Features
Button Syntax in Chat Messages
The chatbot supports interactive buttons for better UX:
Syntax:
[BUTTON:Button Text]
Examples:
Which category interests you?
[BUTTON:Men's Shoes] [BUTTON:Women's Shoes] [BUTTON:Kids Shoes]
In which price range?
[BUTTON:Up to €50] [BUTTON:€50-100] [BUTTON:Over €100]
Option buttons automatically submit when clicked - no need for customers to click "Send"!
Next Steps
After configuring your product advisor:
- Design Customization - Explore all 6 themes in detail
- Best Practices - Learn optimization strategies
- Creating a Product Advisor - Deploy your configured chatbot
- Troubleshooting - Solve common configuration issues
You're now ready to deploy your AI product advisor. Head to Creating a Product Advisor to add it to your pages!