Hyvä Enterprise Sensei Integration

Hyvä Enterprise Sensei provides compatibility modules that integrate Adobe Commerce's AI-powered search and recommendation services with Hyvä-based storefronts. These modules enable Live Search results, Product Recommendations, and behavioral event tracking on Hyvä Theme and Hyvä Checkout.

What is Adobe Sensei?

Adobe Sensei is Adobe Commerce's AI and machine learning platform that powers intelligent storefront features. For Hyvä implementations, the relevant Sensei services are:

• Live Search: AI-powered instant search with faceted filtering, autocomplete, and intelligent ranking
• Product Recommendations: Personalized product suggestions based on shopper behavior and catalog analysis

For detailed feature information, see Adobe's documentation:

• Live Search Overview
• Product Recommendations Overview

Module Architecture

Hyvä Enterprise Sensei compatibility is organized into three interconnected modules:

Module	Purpose	Features
Data Services	Behavioral event tracking	Captures user interactions (page views, cart activity, purchases) and sends events to Adobe's data layer for analytics and personalization
Live Search	Search functionality	Provides storefront popover for instant results and search results page rendering (server-side or via PLP Widget)
Product Recommendations	Product suggestions	Displays AI-driven product recommendations with Page Builder integration support

Installation: See Sensei installation instructions for setup requirements and Composer commands.

Hyvä Checkout Compatibility

Unlike the separate Commerce and B2B metapackages for Theme and Checkout, Sensei uses a single metapackage that provides compatibility for both Hyvä Theme and Hyvä Checkout. The checkout integration is minimal—consisting of a layout XML file for checkout_index_index that adds event tracking to the checkout review page using shared Data Services templates.

Non-Hyvä Theme Compatibility

The Sensei metapackage can be safely installed even when the main storefront uses a non-Hyvä theme (such as Luma). All Hyvä-specific output is automatically suppressed through:

• hyva_ prefixed layout XML handles that only apply to Hyvä themes
• The Hyva\Theme\Service\CurrentTheme::isHyva() method that conditionally executes code only on Hyvä-based themes

This design allows stores using Hyvä Checkout with a Luma storefront to benefit from Sensei event tracking in checkout without affecting the non-Hyvä storefront pages.