AI Product Advisor Manual.

This manual walks you through setting up the AI-powered pre-sales chat, connecting an AI provider and tailoring the advice to your catalog.

Installation

Up and running in minutes.

Installation and activation happen entirely in the Shopware backend - no code changes required.

1 · Requirements

Requires Shopware 6.7 / PHP 8.2+. As always, create a database backup before larger changes.

2 · From the Store

In the backend, go to Extensions › Store, search for the plugin and install it. Updates then appear automatically in the backend.

3 · Activate

Activate the plugin under Extensions › My extensions, then run bin/console cache:clear or clear the cache from the backend.

4 · Open

Find the advisor in the backend under Extensions › Stone & Water › AI Product Advisor.

Configuration

Connect an AI provider.

The advisor uses your own AI account. Provider, API key and model are stored in the admin - nothing is routed through third parties.

AI provider

OpenAI, Anthropic, Mistral or Gemini

Pick the provider, enter your API key and the model. Use Test connection to verify the setup instantly.

Recommendation logic

Matches by keyword coverage

Thresholds control the term and attribute coverage required before an item is recommended, keeping suggestions close to the catalog.

Presentation

Chat icon & off-canvas

Position and visibility of the chat icon are configurable. The off-canvas can be suppressed on selected pages.

Usage

Advice right in the shop.

In the storefront the chat advises customers solely from your real product catalog - around the clock, without staff.

From the real catalog

Only items that actually exist are recommended. No invented products, no silent fallbacks.

Variant quickview

Matching variants can be configured directly in the chat and added to the cart.

Server-sent events

Answers appear as a flowing typing effect, so the conversation feels natural and fast.

Reporting & maintenance

See what works.

The advisor logs interactions so you can trace its contribution to sales.

Conversion tracking

Clicks, cart, value

Recommendations, cart actions and order value are captured and analysed in the admin.

Housekeeping

Automatic log cleanup

A scheduled task regularly clears old log data, keeping the database lean.

FAQ

Common questions.

Answered briefly - reach out for anything else.

Do I need my own AI account?

Yes. You store your own API key for the chosen provider, so you stay in control of cost and data flow.

Is customer data shared?

Only the content needed for the answer is sent to the AI provider. Processing can be set up in a GDPR-compliant way.

Does it recommend third-party products?

No. Only items from your Shopware catalog are suggested.

Questions?

Back to the Product Advisor.

See every feature on the product page. We are happy to help with setup and fine-tuning.