guiziweb/sylius-grid-assistant-plugin

AI-powered grid filtering for Sylius. Natural language to grid filters.

v0.3.0 2026-05-14 09:30 UTC

Requires

• php: ^8.2
• api-platform/symfony: ^4.3
• league/commonmark: ^2.8
• sylius/sylius: ^2.1
• symfony/ai-platform: ^0.8
• symfony/framework-bundle: ^7.3
• symfony/property-info: ^6.4 || ~7.3.0
• symfony/rate-limiter: ^7.3
• symfony/type-info: ~7.3.0

Requires (Dev)

• behat/behat: ^3.16
• dbrekelmans/bdi: ^1.4
• dmore/behat-chrome-extension: ^1.4
• dmore/chrome-mink-driver: ^2.9
• friends-of-behat/mink: ^1.11
• friends-of-behat/mink-browserkit-driver: ^1.6
• friends-of-behat/mink-debug-extension: ^2.1
• friends-of-behat/mink-extension: ^2.7
• friends-of-behat/page-object-extension: ^0.3
• friends-of-behat/suite-settings-extension: ^1.1
• friends-of-behat/symfony-extension: ^2.6
• friends-of-behat/variadic-extension: ^1.6
• nyholm/psr7: ^1.8
• phpstan/phpstan: ^1.12
• phpstan/phpstan-doctrine: ^1.3
• phpstan/phpstan-webmozart-assert: ^1.2
• phpunit/phpunit: ^10.5
• robertfausk/behat-panther-extension: ^1.1
• sylius-labs/coding-standard: ^4.4
• sylius-labs/suite-tags-extension: ~0.2
• sylius/sylius-rector: ^2.0
• sylius/test-application: ^2.0.0@alpha
• symfony/ai-agent: ^0.8
• symfony/ai-bundle: ^0.8
• symfony/ai-open-ai-platform: ^0.8
• symfony/browser-kit: ^7.3
• symfony/debug-bundle: ^7.3
• symfony/dotenv: ^7.3
• symfony/http-client: ^7.3
• symfony/intl: ^7.3
• symfony/runtime: ^7.3
• symfony/web-profiler-bundle: ^7.3
• symfony/webpack-encore-bundle: ^2.2

Suggests

• symfony/ai-anthropic-platform: To use Anthropic Claude as AI provider
• symfony/ai-bundle: Required to enable AI features (declares Platform services from ai.yaml config)
• symfony/ai-mistral-platform: To use Mistral as AI provider
• symfony/ai-open-ai-platform: To use OpenAI as AI provider

MIT

• filter
• grid
• sylius
• ai
• sylius-plugin
• natural-language

README

Sylius Grid Assistant Plugin

Natural language → filtered grid. AI-powered filtering for Sylius admin grids.

How it works

In an admin grid (orders, products, customers...), the assistant adds a search bar at the top. Type your query in plain language:

"orders over $100 from [e-mail] last month"

The plugin sends the query to a Large Language Model (OpenAI, Gemini, Anthropic, Mistral...), gets back structured filters and sorting (JSON Schema strict), and redirects to the same grid with the filters applied - exactly as if you had clicked them manually.

Requirements

• PHP ^8.2
• Sylius ^2.1
• An AI provider account (OpenAI, Gemini, Anthropic, Mistral...) and its API key

Quick install

This plugin ships a Symfony Flex recipe. With the Guiziweb recipe endpoint configured in your project (see linked repo), the install boils down to:

composer require guiziweb/sylius-grid-assistant-plugin
composer require symfony/ai-bundle symfony/ai-open-ai-platform  # or another bridge

Then fill in your API key in .env.local and enable the grids you want. The Flex recipes (plugin + bridge) take care of the rest (bundle registration, config files, env var stub).

Full step-by-step guide (with and without Flex): installation.

Documentation

• Installation - full setup steps
• Usage - admin guide with query examples
• Extending - add custom filter types

License

MIT - see LICENSE.