Skip to content

Releases

0.14.0

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 18 Nov 13:16

Included commits: 0.13.1...0.14.0

Improvements

  • The Storefront Assistant answers questions from product attachment documents through the new product_knowledge_search tool (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) and KnowledgeSearchPluginInterface (Client: search).
  • Introduced BedrockKnowledgeBaseKnowledgeStorePlugin and BedrockKnowledgeBaseKnowledgeSearchPlugin, 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:setup fails when a registered source type has none.
  • Introduced background indexing of knowledge documents: the spy_knowledge_document table, the knowledge_document.index queue (KnowledgeDocumentIndexQueueMessageProcessorPlugin) and the KnowledgeDocumentWritePublisherPlugin event publisher.
  • Introduced the console commands knowledge-document:setup, knowledge-document:reindex and knowledge-document:status:refresh.
  • Introduced the extension points KnowledgeDocumentSourcePluginInterface and KnowledgeDocumentScopeResolverPluginInterface, with the product attachment plugins ProductAttachmentKnowledgeDocumentSourcePlugin and ProductAttachmentKnowledgeDocumentScopeResolverPlugin. 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 as abstract_sku). Each scope resolver plugin reads its own reference types.
  • Introduced AiCommerceConfig::getStorefrontAssistantCustomPageContextPromptLines() for project page types in the Storefront Assistant page context.
  • ProductKnowledgeSearchToolPlugin implements the Client ToolPluginInterface of spryker/ai-foundation-extension.
  • Added the dependencies aws/aws-sdk-php, spryker/http, spryker/queue, spryker/publisher-extension, spryker/product-attachment and spryker/product-attachment-storage.

0.13.1

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 18 Nov 12:16

Included commits: 0.13.0...0.13.1

Improvements

  • Added ProductComparisonAttributeCollector, MerchantProductOfferBuilder and CatalogSearchRangeFinder, which take over parts of ProductComparisonBuilder, ProductOfferDetailsExpander and CatalogSearchRefinementMapper.
  • Reduced the number of constructor parameters of CatalogSearchReader and reduced the complexity of other storefront assistant classes without changing their behavior.
  • Suppressed the remaining PHPMD findings in the module with @SuppressWarnings annotations.

0.13.0

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 13 Nov 12:48

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_US and de_DE suggested prompts.

Adjustments

  • BC: replaced AiCommerceConfig::getStorefrontAssistantSuggestedPromptValues() with AiCommerceConfig::getStorefrontAssistantSuggestedPrompts(), which takes the locale name.
  • BC: removed StorefrontAssistantSuggestedPromptReaderInterface::getSuggestedPromptSections() and the suggestedPromptSections parameter of StorefrontAssistantWidget; the pipe text format and the titled prompt sections are no longer supported.
  • BC: StorefrontAssistantSuggestedPromptReader has the new constructor argument LocaleClientInterface.
  • 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

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 13 Nov 11:20

Included commits: 0.11.2...0.12.0

Improvements

  • The AiCommerce Storefront Assistant tool plugins implement the Client ToolPluginInterface of spryker/ai-foundation-extension.
  • Increased the spryker/ai-foundation dependency to ^0.10.0 and added the spryker/ai-foundation-extension dependency.

0.11.2

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 10 Nov 15:36

Included commits: 0.11.1...0.11.2

Improvements

  • Renamed a short closure variable in CatalogProductFinder to satisfy the PHPMD naming rules.

0.11.1

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 05 Nov 12:35

Included commits: 0.11.0...0.11.1

Adjustments

  • Adjusted SmartCmsContentPanel to read and write CMS fields edited with the rich-text editor through window.SprykerRichTextEditor.
  • Added error logging when the Smart CMS content request or applying its content fails.

0.11.0

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 03 Nov 17:58

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 is false, so a comparison has no full-comparison link; set IS_STOREFRONT_ASSISTANT_PRODUCT_COMPARISON_PAGE_ENABLED to true in the project config when the product comparison page is installed.
  • Introduced AiCommerceConfig::isStorefrontAssistantStoreRoutingEnabled().
  • Introduced the ai_commerce.storefront_assistant.attachment.too_large_size glossary key with the %maxSize% placeholder.
  • Adjusted the attachment notice to use only the ai_commerce.storefront_assistant.attachment.too_large_size glossary 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.clearStorageKeys chat option. When another customer signs in, chat-session-persistence removes the stored session and these keys and does not restore them.
  • Added the spryker/price-product dependency.
  • Adjusted the constructors of PriceProductProductExpander, ProductComparisonBuilder, ShopPageReader, SuggestionResultFormatter, SeeAllLinkBuilder, ProductSetReader and ProductBundleDetailsExpander. Projects that extend these classes must update their factories.
  • Adjusted StorefrontAssistantWidget with the chatOwnerToken parameter. Projects that override the widget template must pass chatOwnerToken as chat.owner and the agent selector storage key in features.sessionPersistence.clearStorageKeys.

0.10.1

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 02 Nov 09:24

Included commits: 0.10.0...0.10.1

Adjustments

  • Updated the marked dependency from ~18.0.14 to ~18.1.1.

0.10.0

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 28 Oct 15:52

Included commits: 0.9.1...0.10.0

Breaking Changes

  • Replaced BackofficeAssistantPromptController and BackofficeAssistantConversationController with BackofficeAssistantChatController, which changed the Back Office assistant URLs.
  • Removed the BackofficeAssistantEventType enum 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.* and ai_commerce.storefront_assistant.* keys.
  • Removed SseEventEmitter, SseEventEmitterInterface and AiCommerceCommunicationFactory::createSseEventEmitter() in favor of the shared MessageStreamer.
  • Changed the Back Office assistant request contract: the CSRF token moves from the _token body field to the X-CSRF-Token header, payload keys use camelCase, and the stream uses the shared chat event protocol instead of the agent_selected, ai_response and form_fill events.
  • Adjusted ToolResultProductEnricherInterface to extend ToolResultExpanderInterface, which adds expandToolResult() to its implementations.
  • Replaced the Yves AiCommerceConfig::getStorefrontAssistantSuggestedPrompts() with AiCommerceConfig::getStorefrontAssistantSuggestedPromptValues(), which returns the raw configured values; the parsing moved to StorefrontAssistantSuggestedPromptReader.
  • 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/Chat that the Storefront, Back Office and Merchant Portal assistants use, loaded by the spryker/twig SharedThemeTwigLoaderPlugin.
  • Introduced StorefrontAssistantWidget to render the storefront assistant with titled suggested prompt sections.
  • Added BackofficeAssistantConversationCollectionDeleteCriteria.idUser so that AiCommerceFacade::deleteBackofficeAssistantConversationCollection() deletes nothing and returns an error when that user does not own every requested conversation.
  • Added StorefrontAssistantChatRequestTransfer.isRegeneration to let a response be regenerated, replacing the stored exchange of that message.

Adjustments

  • Added spryker/gui as a required dependency with the ^5.12.0 constraint for the Back Office @shared/<module>/* frontend alias.
  • Added spryker/twig as a required dependency with the ^3.34.0 constraint for SharedThemeTwigLoaderPlugin.
  • Increased the spryker-shop/shop-ui version constraint to ^2.7.0.

202610.0

Choose a tag to compare

@spryker-release-bot spryker-release-bot released this 27 Oct 16:51