Page Agent Bridge

Page Agent Bridge is a Shopware 6 plugin that integrates alibaba/page-agent into the storefront. It adds an AI agent panel that can inspect and control storefront pages through natural language tasks.

The project is developed by the Agentic Commerce Lab within Shopware.

Download

Download the latest plugin build here:

PageAgentBridge.zip

Then upload the zip in the Shopware Administration under Extensions > My extensions > Upload extension, install and activate it.

Alternatively, clone this repository into your Shopware installation under custom/plugins.

This is an experimental build. The latest-main download always tracks the newest commit on main and is intended for technical evaluation only.

Features

• Injects page-agent into the Shopware storefront through Shopware's storefront extension system.
• Displays a storefront agent panel when the plugin is enabled.
• Supports page-agent's hosted demo provider for technical evaluation.
• Supports custom OpenAI-compatible chat completion providers for production setups.
• Keeps custom provider API keys on the server side through a storefront proxy.
• Applies a Shopware-aligned panel style through src/Resources/public/page-agent-bridge.css.
• Preserves running page-agent tasks across multi-page storefront navigation with sessionStorage.
• Applies a per-IP rate limit to the provider proxy endpoint.

Provider Modes

The plugin is enabled in Free provider mode by default after installation. This mode uses page-agent's hosted demo LLM and is intended for technical evaluation only.

For production use, switch to Custom provider mode and configure your own OpenAI-compatible provider in the Shopware Administration. Prompts and relevant runtime data entered into the widget are sent to the selected provider.

Requirements

• PHP 8.4
• Composer
• Shopware 6.5 or newer
• A Shopware storefront

Installation

Shopware Administration Upload

For a shop installation, upload a release archive that contains the plugin under a single top-level PageAgentBridge/ directory:

PageAgentBridge/
+-- composer.json
+-- composer.lock
+-- README.md
+-- src/

After uploading the archive in the Shopware Administration, install and activate the plugin, then clear the cache and rebuild the storefront if your environment does not do that automatically.

Local Development Install

From a local Shopware project root, symlink this repository into custom/plugins:

mkdir -p custom/plugins
ln -s /path/to/page-agent-shopware custom/plugins/PageAgentBridge
bin/console plugin:refresh
bin/console plugin:install --activate PageAgentBridge
bin/build-storefront.sh
bin/console cache:clear

If symlinks are not suitable for the environment, copy the repository instead:

mkdir -p custom/plugins/PageAgentBridge
rsync -a --delete /path/to/page-agent-shopware/ custom/plugins/PageAgentBridge/
bin/console plugin:refresh
bin/console plugin:install --activate PageAgentBridge
bin/build-storefront.sh
bin/console cache:clear

Configuration

Open the Shopware Administration and go to Extensions > My extensions > Page Agent Bridge.

• Enable Page Agent in the storefront: injects and shows the widget when active.
• Provider mode: selects either the hosted page-agent demo provider or a custom OpenAI-compatible provider.
• Model: model name sent to the custom provider.
• Base URL: HTTPS base URL of the custom OpenAI-compatible provider.
• API key: custom provider API key. The key is stored server-side and is not rendered into storefront HTML.
• Language: forwards the selected page-agent language to the storefront script.

When the plugin is enabled, storefront visitors can trigger provider requests through the widget. The proxy accepts only public HTTPS provider hosts.

Manual Test

1. Open the storefront.
2. Confirm the page-agent widget appears.
3. Enter a storefront task, for example:

Open the product catalogue, pick any product, add it to the shopping cart, then open the shopping cart page.

4. Navigate between storefront pages while the task is running and confirm the task resumes after page reloads.

Development

Install development dependencies in the plugin repository:

composer install
npm ci
npm ci --prefix src/Resources/app/storefront

Run focused quality checks from the plugin root:

composer run format:check
composer run lint
composer run typecheck
composer run quality

The PHP toolchain is configured for PHP 8.4.

Contributing

Contributions are welcome once the public repository is available. Please keep changes focused, follow Shopware plugin conventions, and run the narrowest useful quality checks before opening a pull request.

Security issues should not be disclosed through public issues. Use the repository's private security reporting channel if it is enabled, or contact the maintainers privately.

License

Page Agent Bridge is released under the MIT License.