Skip to main content

Creating a Product Advisor

This guide will walk you through the process of creating a specialized product advisor for your Shopware store.

Overview​

The FelAIProductAdvisor is implemented as a CMS element that you can add to any page in your Shopware store. You can create multiple advisors with different configurations for various product categories or purposes.

Step-by-Step Guide​

1. Create or Edit a CMS Page​

  1. Navigate to Content > Shopping Experiences in the Shopware Administration
  2. Choose an existing page or create a new one by clicking Create new layout
  3. If creating a new page, select a layout type (e.g., Default, Landing Page)

2. Add the Product Advisor Element​

  1. In the layout builder, locate the "FEL AI Product Advisor" element in the elements panel
  2. Drag and drop the element into a section of your page
  3. The element will be added with default settings

3. Configure Basic Settings​

Click on the element to open its configuration panel and adjust the basic settings:

  1. Title: Enter a title for your product advisor (e.g., "Electronics Advisor", "Fashion Consultant")
  2. Theme Color: Select a color that matches your store's design
  3. Maximum Products in Chat: Set the maximum number of products to display at once (recommended: 3-4)
  4. Auto Open: Choose whether the chat should open automatically when the page loads
  5. Enable Fullscreen Mode: Allow users to expand the chat to fullscreen

4. Configure AI Settings​

In the same configuration panel, scroll down to the AI settings:

  1. OpenAI Model: Select the AI model to use

    • GPT-4o-mini (recommended for good balance of performance and cost)
    • GPT-4o (higher quality but more expensive)
    • GPT-3.5-turbo (lower cost but less sophisticated)

  2. System Instruction: Enter detailed instructions for the AI

    • Define the advisor's personality and tone
    • Specify how it should help customers
    • Include product knowledge and guidance
    • Set boundaries for what it should and shouldn't do

  3. Welcome Message: Set the first message the advisor will show to customers

5. Set Category Restrictions​

If you want to limit the advisor to specific product categories:

  1. Category: Select a category from the dropdown
  2. Include Subcategories: Check this option to include products from subcategories

6. Save and Preview​

  1. Click Save to apply your changes
  2. Use the preview function to test how the advisor will appear on your page
  3. Test the advisor by asking various product-related questions

Creating Specialized Advisors​

You can create multiple specialized advisors for different purposes. Here are some examples:

Electronics Advisor​

Placement: Electronics category page or landing page

System Instruction Example:

You are a specialized advisor for electronics products in our online shop.
Your task is to help customers find the right electronic device based on their needs.

Be knowledgeable about technical specifications and explain them in simple terms.
Ask questions about the customer's usage patterns, budget, and technical requirements.

When recommending products:
- Compare key specifications
- Explain the benefits of different features
- Suggest accessories that complement the main product
- Consider the customer's budget constraints

If asked about technical terms, provide clear explanations.

Fashion Consultant​

Placement: Fashion category page or landing page

System Instruction Example:

You are a style consultant for our fashion shop.
Your task is to help customers find clothing that matches their style and preferences.

Be friendly and style-conscious. Ask about the customer's style preferences, body type, and the occasion.
Provide styling advice and suggest complete outfits.

When recommending products:
- Consider seasonal trends
- Suggest complementary pieces
- Provide advice on fit and sizing
- Recommend styling options

If asked about materials or care instructions, provide helpful information.

Home & Garden Advisor​

Placement: Home & Garden category page

System Instruction Example:

You are a home and garden specialist for our online shop.
Your task is to help customers find the right products for their home and garden projects.

Be practical and solution-oriented. Ask about the customer's space, requirements, and preferences.
Provide advice on product selection and usage.

When recommending products:
- Consider the customer's space constraints
- Suggest complementary items
- Provide practical advice on usage and maintenance
- Consider seasonal factors for garden products

If asked about installation or maintenance, provide helpful tips.

Best Practices​

Effective System Instructions​

  • Be specific: Clearly define the advisor's role and expertise
  • Include domain knowledge: Add specific product knowledge to make recommendations more valuable
  • Set boundaries: Define what the advisor should and shouldn't do
  • Specify tone: Determine how formal or casual the advisor should be
  • Include examples: Provide examples of good responses for common questions

Optimal Placement​

  • Place specialized advisors on relevant category pages
  • Consider adding a general advisor on the homepage
  • Add advisors to landing pages for special promotions or collections

Testing and Optimization​

  • Test your advisor with various customer scenarios
  • Review chat logs to identify areas for improvement
  • Refine system instructions based on actual customer interactions
  • Adjust settings based on performance and customer feedback

Next Steps​

After creating your product advisor, you can:

  1. Customize its appearance
  2. Fine-tune the AI configuration
  3. Monitor its performance
  4. Explore advanced integration options