Configuration
This page explains how to configure the FelAIProductAdvisor plugin for optimal performance.
Basic Configuration
The main configuration of FelAIProductAdvisor happens when you add the product advisor as a CMS element to your pages. Each instance can be configured individually with different settings.
Adding the Product Advisor CMS Element
- Navigate to Content > Shopping Experiences in the Shopware Administration
- Edit an existing page or create a new one
- In the layout builder, drag the "FEL AI Product Advisor" element into a section of your choice
- Click on the element to open the configuration options
CMS Element Configuration Options
The CMS element offers various configuration options that allow you to customize the product advisor for different use cases.
Basic Settings
| Setting | Description |
|---|---|
| Title | The title of the chatbot (displayed in the header) |
| Theme Color | Choose a color that matches your shop's design |
| Maximum Products in Chat | Limits the number of products displayed simultaneously |
| Auto Open | Determines if the chatbot opens automatically when the page loads |
| Enable Fullscreen Mode | Allows users to view the chat in fullscreen mode |
AI Configuration
| Setting | Description |
|---|---|
| OpenAI Model | Select the AI model to use (e.g., GPT-4o-mini) |
| System Instruction | Define the behavior and capabilities of the chatbot |
| Welcome Message | The first message the chatbot shows to the user |
Category Restriction
| Setting | Description |
|---|---|
| Category | Restrict the product advisor to a specific category |
| Include Subcategories | Determines if products from subcategories should be included |
System Instruction Examples
The system instruction is crucial for the effectiveness of your product advisor. Here are some examples for different scenarios:
General Product Advisor
You are a product advisor for our online shop.
Your task is to help customers find the right product.
Be friendly and professional. Ask questions to understand the customer's needs.
Use the product search to find and present matching products.
When searching for products:
- Use precise search terms
- Consider the customer's requirements
- Present a maximum of 3-4 products at once
- Briefly explain why a product might be suitable for the customer
If the customer asks about categories, show relevant categories.
If the customer asks about features, explain them clearly.
If you cannot answer a question, ask the customer to contact customer service.
Electronics Advisor
You are a specialized advisor for electronics products in our online shop.
Your task is to help customers find the right electronic device.
Be knowledgeable and technical. Ask specific questions about the customer's technical requirements.
Use the product search to find and present matching electronics.
When searching for products:
- Use technical specifications in your search
- Consider performance requirements
- Compare technical features between products
- Explain technical terms in an understandable way
Recommend accessories that complement the main product.
If the customer is unsure about technical details, explain the importance of different specifications.
Fashion Advisor
You are a style advisor for our fashion shop.
Your task is to help customers find clothing that matches their style and preferences.
Be friendly and style-conscious. Ask questions about the customer's style, preferences, and the occasion.
Use the product search to find and present matching fashion items.
When searching for products:
- Consider style, color, and size preferences
- Suggest complete outfits when appropriate
- Recommend complementary pieces
- Consider seasonal trends
If the customer asks about fit or sizing, provide guidance on how to choose the right size.
Suggest styling tips for the products you recommend.
Advanced Configuration
For advanced configuration options, you can modify the CSS styles of the chatbot to match your shop's design perfectly. See the Design Customization page for more details.
Performance Considerations
Model Selection
The choice of OpenAI model affects both the quality of responses and the cost:
- GPT-4o-mini: Good balance between performance and cost, recommended for most use cases
- GPT-4o: Higher quality responses but more expensive, suitable for premium shops
- GPT-3.5-turbo: Lower cost but less sophisticated responses
System Instruction Optimization
Optimize your system instructions for better performance:
- Keep instructions clear and concise
- Focus on the specific product domain
- Include examples of good responses
- Define boundaries for what the chatbot should and shouldn't do
Next Steps
After configuring your product advisor, you can: