Back Office Assistant

Last updated: March 31, 2026

Edit on GitHub

Back Office Assistant is an AI-powered chat widget embedded in the Spryker Back Office. It lets admin users ask natural language questions, navigate the Back Office, manage orders, and create or update discounts — all through a conversational interface.

For the business overview, see Back Office Assistant.

Architecture

Back Office Assistant is built on the AiFoundation abstraction layer and runs entirely in the Zed (Back Office) application. The chat widget is rendered by a Twig plugin injected into the Back Office layout.

Each conversation is routed through an intent router that selects the most appropriate specialized agent. Each agent has its own system prompt, named AI configuration, and toolset — so they can be configured, observed, and scaled independently.

Streaming responses are delivered to the browser using Server-Sent Events (SSE), which are triggered by pre- and post-tool-call plugins registered in AiFoundationDependencyProvider.

Agents

Back Office Assistant ships with three built-in agents:

AGENT	PLUGIN	DESCRIPTION
General Purpose	`GeneralPurposeAgentPlugin`	Answers general Spryker Back Office questions and provides navigation guidance.
Order Management	`OrderManagementAgentPlugin`	Provides read-only access to order data and OMS state information for diagnosing order issues.
Discount Management	`DiscountManagementAgentPlugin`	Creates and updates discounts through the Back Office API.

Agents are registered in AiCommerceDependencyProvider::getBackofficeAssistantAgentPlugins().

Toolsets

Each agent uses a set of tools registered in AiFoundationDependencyProvider::getAiToolSetPlugins():

PLUGIN	DESCRIPTION
`NavigationToolSetPlugin`	Provides tools for resolving Back Office navigation paths.
`OrderManagementToolSetPlugin`	Provides tools for fetching order lists and OMS process information.
`OrderDetailsToolSetPlugin`	Provides tools for fetching detailed order data by reference or ID.
`DiscountManagementToolSetPlugin`	Provides tools for reading, creating, and updating discounts.

SSE streaming

Tool call progress is streamed to the browser in real time using Server-Sent Events:

PLUGIN	DESCRIPTION
`BackofficeAssistantSsePreToolCallPlugin`	Sends a streaming event before each tool call.
`BackofficeAssistantSsePostToolCallPlugin`	Sends a streaming event after each tool call.

AI configuration

Each agent uses a dedicated named AI configuration entry in AiFoundation. This isolates model settings per agent and keeps audit log entries separate.

The following configuration keys are used:

CONSTANT	DESCRIPTION
`AiCommerceConstants::AI_CONFIGURATION_INTENT_ROUTER`	Configuration for the intent routing model.
`AiCommerceConstants::AI_CONFIGURATION_GENERAL_PURPOSE`	Configuration for the General Purpose agent.
`AiCommerceConstants::AI_CONFIGURATION_ORDER_MANAGEMENT`	Configuration for the Order Management agent.
`AiCommerceConstants::AI_CONFIGURATION_DISCOUNT_MANAGEMENT`	Configuration for the Discount Management agent.

System prompts

System prompts for each agent are managed in the Back Office under AI Commerce > Back Office Assistant > System Prompts. The default prompts are defined in ai_commerce.configuration.yml and can be customized per environment through the configuration UI.

Feature flags

The feature and individual agents can be enabled or disabled from the Back Office under AI Commerce > Back Office Assistant > General:

SETTING	DEFAULT	DESCRIPTION
`is_enabled`	`false`	Enables or disables the Back Office Assistant chat widget.
`is_order_management_agent_enabled`	`true`	Enables or disables the Order Management Agent.
`is_discount_management_agent_enabled`	`true`	Enables or disables the Discount Management Agent.

Install

Install Back Office Assistant