Intégrer un agent IA à une boutique Sylius en Belgique
Pour intégrer un agent IA à une boutique Sylius en Belgique, vérifiez d'abord votre version : les briques IA officielles exigent Sylius 2.1 ou plus. Choisissez ensuite par où l'agent passe (API d'administration, plugin MCP ou code dans la boutique), puis réglez les points propres à la Belgique : deux langues, transporteurs, factures Peppol pour le B2B et protection des données. L'agent lit, prépare et propose ; une personne valide tout ce qui engage la boutique.
Je suis développeur Sylius et Symfony indépendant, et j'ai créé Sylius Upgrade Analyzer, un outil open source publié sur le Sylius Store. J'intègre des agents IA sur des boutiques en Belgique et en France, Sylius en priorité. Voici les étapes dans l'ordre où je les mène, et ce qu'un agent IA pour Sylius demande concrètement.
Votre version de Sylius le permet-elle ?
C'est la première question. Les trois plugins IA officiels, le serveur MCP boutique, le serveur MCP d'administration et Ask AI, exigent tous Sylius 2.1 ou plus, et Ask AI exige 2.2. Sur Sylius 1.x, aucune de ces briques ne s'installe. Un agent sur mesure reste possible, mais vous construiriez sur une base que vous devrez de toute façon migrer. La migration vers Sylius 2 est donc souvent la vraie première étape, et Sylius Upgrade Analyzer en mesure le travail.
Être sur Sylius 2 ne suffit pas : il faut être à jour. Sylius v2.3.2 a corrigé six failles, dont une qui permettait d'accéder aux données d'autres clients par l'API shop. Ouvrir une API à un agent sans ces correctifs, c'est prendre un risque inutile.
Par où l'agent passe-t-il dans Sylius ?
| Voie | Ce qu'elle permet | Sa limite |
|---|---|---|
| API Sylius 2 (/api/v2/admin) | Lire commandes, clients, expéditions, avec un jeton et le rôle ROLE_API_ACCESS | Il faut écrire soi-même les outils de l'agent |
| Plugin Admin MCP (v0.2.0) | 171 outils prêts, groupes désactivables, accès OAuth 2.0 | Version jeune, télémétrie Sylius imposée |
| Plugin Shop MCP (v0.3.0) | Recherche produit, panier, commande en mode invité | Pas d'authentification décrite, pas de données de compte client |
| Code dans la boutique | Outils taillés au plus juste, aucune exposition externe | Développement sur mesure |
Pour un agent de service client, le serveur MCP boutique ne convient pas : il fonctionne en mode invité et ne lit pas les commandes d'un client connecté. Je passe le plus souvent par des outils écrits sur mesure, qui n'exposent que ce dont l'agent a besoin, ou par l'API d'administration avec des accès limités. Le plugin Admin MCP est intéressant pour un usage interne, à condition d'en désactiver les groupes d'outils inutiles.
Et si un agent le faisait pour vous ?
Laissez votre numéro : je vous rappelle sous 24 heures ouvrées et je regarde avec vous ce qu'un agent peut prendre en charge dans votre boutique, dans votre budget.
Quelles spécificités belges prévoir ?
Les deux langues. Une boutique belge a souvent un canal ou des locales en français et en néerlandais. L'agent lit le canal et la langue de la commande et répond dans la bonne langue, avec des règles écrites une seule fois. L'article sur le SAV bilingue détaille la méthode.
Les transporteurs. Chez bpost, l'intégration par API est réservée à l'offre contractuelle « Large », au-delà de 1 000 colis par an, selon la page de comparaison des offres. En dessous, l'agent s'appuie sur l'état d'expédition enregistré dans Sylius et renvoie le client vers le suivi public. DPD propose une API de suivi sur demande, avec une clé. L'article sur le suivi bpost va plus loin.
Les factures B2B. Si vous vendez à des entreprises belges, vos factures passent par Peppol depuis 2026. L'agent n'émet pas de facture, mais il peut préparer beaucoup de choses autour ; voyez l'article sur Peppol.
Les données. L'Autorité de protection des données fixe la liste des traitements qui exigent une analyse d'impact. Selon ce que l'agent lit et décide, la question se pose ; l'article sur l'AIPD aide à y répondre.
Que lit l'agent, que prépare-t-il, que valide un humain ?
Dans Sylius, un agent de service client lit le client, ses commandes, les paiements, les expéditions, les variantes commandées, le canal et les promotions appliquées. Il prépare un brouillon de réponse et, si besoin, une action en attente : un retour à créer, une expédition à relancer. C'est le fonctionnement de l'agent que je construis en ce moment pour une boutique sous Sylius 2, avec un brouillon dans Gmail et une action logistique en attente de validation dans l'administration.
Chaque passage de l'agent est tracé : ce qu'il a lu, ce qu'il a proposé, les règles citées et leur version, le modèle utilisé. Quand un brouillon est faux, on retrouve en quelques secondes ce qui l'a induit en erreur, et on corrige la règle plutôt que le seul message. Cette trace sert aussi de base aux tests rejoués avant chaque changement de règles ou de modèle.
Ce que l'agent ne fait jamais seul : envoyer un mail, rembourser, modifier une commande, accorder un geste commercial ou changer ses propres règles. Ces garde-fous sont dans le code : il n'a pas d'outil pour le faire.
Dans quel ordre avancer ?
Je procède toujours de la même façon. Vérifier la version et les correctifs de sécurité. Choisir une seule famille de messages, la plus fréquente. Écrire avec vous les règles qui la gouvernent. Réunir des cas réels anonymisés, dans les deux langues, pour les tests. Brancher les outils minimaux. Mesurer, puis étendre. Si vous n'avez encore jamais utilisé d'agent, l'article sur le premier agent d'un commerçant belge aide à choisir ce premier cas.
Pas d'abonnement de plateforme imposé : la consommation du modèle est payée sur votre propre compte, et le code vous appartient. Vous parlez directement au développeur Sylius qui écrit le code. Je propose un diagnostic IA offert : je vous rappelle sous 24 heures ouvrées, je passe votre boutique au crible des 8 couches, et je vous propose la solution qui rentre dans votre budget.