Repository navigation
Releases
Releases · spryker-feature/ai-commerce
0.14.0
Included commits: 0.13.1...0.14.0
Improvements
- The Storefront Assistant answers questions from product attachment documents through the new
product_knowledge_searchtool (ProductKnowledgeSearchToolPlugin). The tool searches only the attachments of the products that the question or the page names. - Introduced the knowledge store extension points
KnowledgeStorePluginInterface(Zed: setup, index, delete, status) andKnowledgeSearchPluginInterface(Client: search). - Introduced
BedrockKnowledgeBaseKnowledgeStorePluginandBedrockKnowledgeBaseKnowledgeSearchPlugin, which store and search the documents in an Amazon Bedrock knowledge base with managed reranking. - Introduced
AiCommerceConstants::BEDROCK_KNOWLEDGE_BASE_DATA_SOURCE_IDS: the custom data source of the knowledge base for each knowledge document source type. Several source types can use one data source;knowledge-document:setupfails when a registered source type has none. - Introduced background indexing of knowledge documents: the
spy_knowledge_documenttable, theknowledge_document.indexqueue (KnowledgeDocumentIndexQueueMessageProcessorPlugin) and theKnowledgeDocumentWritePublisherPluginevent publisher. - Introduced the console commands
knowledge-document:setup,knowledge-document:reindexandknowledge-document:status:refresh. - Introduced the extension points
KnowledgeDocumentSourcePluginInterfaceandKnowledgeDocumentScopeResolverPluginInterface, with the product attachment pluginsProductAttachmentKnowledgeDocumentSourcePluginandProductAttachmentKnowledgeDocumentScopeResolverPlugin. A project adds a document source with these two plugins and one data source configuration entry. - Introduced generic search scope references (
KnowledgeDocumentScopeRequestTransfer.scopeReferences, keyed by reference type such asabstract_sku). Each scope resolver plugin reads its own reference types. - Introduced
AiCommerceConfig::getStorefrontAssistantCustomPageContextPromptLines()for project page types in the Storefront Assistant page context. ProductKnowledgeSearchToolPluginimplements the ClientToolPluginInterfaceofspryker/ai-foundation-extension.- Added the dependencies
aws/aws-sdk-php,spryker/http,spryker/queue,spryker/publisher-extension,spryker/product-attachmentandspryker/product-attachment-storage.
0.13.1
Included commits: 0.13.0...0.13.1
Improvements
- Added
ProductComparisonAttributeCollector,MerchantProductOfferBuilderandCatalogSearchRangeFinder, which take over parts ofProductComparisonBuilder,ProductOfferDetailsExpanderandCatalogSearchRefinementMapper. - Reduced the number of constructor parameters of
CatalogSearchReaderand reduced the complexity of other storefront assistant classes without changing their behavior. - Suppressed the remaining PHPMD findings in the module with
@SuppressWarningsannotations.
0.13.0
Included commits: 0.12.0...0.13.0
Improvements
- Storefront Assistant suggested prompts are now configured for each locale: each suggested prompt setting is a JSON object with a list of prompts for each locale name, and the storefront shows the list of the current locale.
- Introduced
StorefrontAssistantSuggestedPromptsConstraint: Configuration Management rejects a suggested prompt value that is not a locale-keyed object, a locale that no store uses, or prompts that are not a list of text values. - The module defaults have
en_USandde_DEsuggested prompts.
Adjustments
- BC: replaced
AiCommerceConfig::getStorefrontAssistantSuggestedPromptValues()withAiCommerceConfig::getStorefrontAssistantSuggestedPrompts(), which takes the locale name. - BC: removed
StorefrontAssistantSuggestedPromptReaderInterface::getSuggestedPromptSections()and thesuggestedPromptSectionsparameter ofStorefrontAssistantWidget; the pipe text format and the titled prompt sections are no longer supported. - BC:
StorefrontAssistantSuggestedPromptReaderhas the new constructor argumentLocaleClientInterface. - A suggested prompt value saved in the old text format shows no prompts; save it again as JSON in the Back Office.
0.12.0
Included commits: 0.11.2...0.12.0
Improvements
- The AiCommerce Storefront Assistant tool plugins implement the Client
ToolPluginInterfaceofspryker/ai-foundation-extension. - Increased the
spryker/ai-foundationdependency to^0.10.0and added thespryker/ai-foundation-extensiondependency.
0.11.2
Included commits: 0.11.1...0.11.2
Improvements
- Renamed a short closure variable in
CatalogProductFinderto satisfy the PHPMD naming rules.
0.11.1
Included commits: 0.11.0...0.11.1
Adjustments
- Adjusted
SmartCmsContentPanelto read and write CMS fields edited with the rich-text editor throughwindow.SprykerRichTextEditor. - Added error logging when the Smart CMS content request or applying its content fails.
0.11.0
Included commits: 0.10.1...0.11.0
Fixes
- Fixed Storefront Assistant product prices: products with several variants now show the abstract price, the same as the product detail page.
- Fixed the Storefront Assistant full-comparison link, which returned 404 on shops without the product comparison page. The link is now behind a feature flag that is off by default.
- Fixed Storefront Assistant links on shops with store routing: product, CMS, category, product-set and comparison links now get the store prefix.
- Fixed the Storefront Assistant widget, which showed when no agent was enabled.
- Fixed the Storefront Assistant prompt and conversation-delete endpoints, which accepted an unknown agent, non-array attachments and an empty delete payload; they now return 400.
- Fixed the expanded chat panel under the shop header, horizontal scroll at small widths, overflowing follow-up chips, and the page-context chip that could not be attached again.
- Fixed the attachment notice texts: readable file types and a readable size limit.
- Fixed a stored chat session that the next customer in the same browser could restore: the session is bound to a hash of the customer reference, and the chat removes the session of another customer.
- Fixed the Back Office assistant trigger, which covered the configuration save bar.
Improvements
- Introduced
AiCommerceConfig::isStorefrontAssistantProductComparisonPageEnabled(). The default isfalse, so a comparison has no full-comparison link; setIS_STOREFRONT_ASSISTANT_PRODUCT_COMPARISON_PAGE_ENABLEDtotruein the project config when the product comparison page is installed. - Introduced
AiCommerceConfig::isStorefrontAssistantStoreRoutingEnabled(). - Introduced the
ai_commerce.storefront_assistant.attachment.too_large_sizeglossary key with the%maxSize%placeholder. - Adjusted the attachment notice to use only the
ai_commerce.storefront_assistant.attachment.too_large_sizeglossary key. Projects must import this key:en_US"File is too large. Maximum size is %maxSize%.",de_DE"Datei ist zu groß. Maximale Größe: %maxSize%.". - Introduced the
features.sessionPersistence.clearStorageKeyschat option. When another customer signs in,chat-session-persistenceremoves the stored session and these keys and does not restore them. - Added the
spryker/price-productdependency. - Adjusted the constructors of
PriceProductProductExpander,ProductComparisonBuilder,ShopPageReader,SuggestionResultFormatter,SeeAllLinkBuilder,ProductSetReaderandProductBundleDetailsExpander. Projects that extend these classes must update their factories. - Adjusted
StorefrontAssistantWidgetwith thechatOwnerTokenparameter. Projects that override the widget template must passchatOwnerTokenaschat.ownerand the agent selector storage key infeatures.sessionPersistence.clearStorageKeys.
0.10.1
Included commits: 0.10.0...0.10.1
Adjustments
- Updated the
markeddependency from~18.0.14to~18.1.1.
0.10.0
Included commits: 0.9.1...0.10.0
Breaking Changes
- Replaced
BackofficeAssistantPromptControllerandBackofficeAssistantConversationControllerwithBackofficeAssistantChatController, which changed the Back Office assistant URLs. - Removed the
BackofficeAssistantEventTypeenum and the legacy Back Office assistant JS and SCSS assets in favor of the shared chat core. - Replaced the plain-text Back Office assistant Zed glossary keys with
ai_commerce.backoffice_assistant.*andai_commerce.storefront_assistant.*keys. - Removed
SseEventEmitter,SseEventEmitterInterfaceandAiCommerceCommunicationFactory::createSseEventEmitter()in favor of the sharedMessageStreamer. - Changed the Back Office assistant request contract: the CSRF token moves from the
_tokenbody field to theX-CSRF-Tokenheader, payload keys use camelCase, and the stream uses the shared chat event protocol instead of theagent_selected,ai_responseandform_fillevents. - Adjusted
ToolResultProductEnricherInterfaceto extendToolResultExpanderInterface, which addsexpandToolResult()to its implementations. - Replaced the Yves
AiCommerceConfig::getStorefrontAssistantSuggestedPrompts()withAiCommerceConfig::getStorefrontAssistantSuggestedPromptValues(), which returns the raw configured values; the parsing moved toStorefrontAssistantSuggestedPromptReader. - Changed the default Storefront Assistant system prompt (
AiCommerceConfig::getStorefrontAssistantSystemPrompt()) to limit answers to the shop and its products and to format replies as easy-to-scan markdown; projects that keep the default get the new behavior.
Improvements
- Introduced one shared chat core under
Shared/AiCommerce/Theme/default/Chatthat the Storefront, Back Office and Merchant Portal assistants use, loaded by thespryker/twigSharedThemeTwigLoaderPlugin. - Introduced
StorefrontAssistantWidgetto render the storefront assistant with titled suggested prompt sections. - Added
BackofficeAssistantConversationCollectionDeleteCriteria.idUserso thatAiCommerceFacade::deleteBackofficeAssistantConversationCollection()deletes nothing and returns an error when that user does not own every requested conversation. - Added
StorefrontAssistantChatRequestTransfer.isRegenerationto let a response be regenerated, replacing the stored exchange of that message.
Adjustments
- Added
spryker/guias a required dependency with the^5.12.0constraint for the Back Office@shared/<module>/*frontend alias. - Added
spryker/twigas a required dependency with the^3.34.0constraint forSharedThemeTwigLoaderPlugin. - Increased the
spryker-shop/shop-uiversion constraint to^2.7.0.
202610.0
Product Release August 2026
https://docs.spryker.com/docs/about/all/releases/release-notes-202610.0.html