Interroger l'admin Sylius en langage naturel
Pour interroger l'administration Sylius en langage naturel, on branche un modèle de langage sur des outils de lecture de la boutique : il comprend la question, appelle les bons outils et répond avec les chiffres et les liens. Sur Sylius 2.1 et plus, le plugin officiel Admin MCP Server fournit ces outils, et le plugin Ask AI ajoute un panneau de discussion dans l'admin. Les deux sont encore jeunes. L'essentiel est de décider ce que l'agent a le droit de lire et de faire, avant de lui poser la première question.
Je suis développeur Sylius et Symfony indépendant, et j'intègre des agents IA dans des boutiques en ligne. Les commerçants que j'accompagne connaissent leur boutique par cœur, mais pas forcément les filtres de l'administration. Voici ce qui existe, ce que je recommande, et où sont les pièges. La page agents IA pour Sylius donne la vue d'ensemble.
Quelles questions veut-on poser à son administration ?
Les questions du quotidien sont simples à formuler et pénibles à obtenir. Combien de commandes payées n'ont pas encore été expédiées ? Quels produits du rayon chaussures n'ont plus de stock dans aucune taille ? Ce client a-t-il déjà retourné un article ? Combien de fois le code de la newsletter a-t-il servi cette semaine ? Quelle part du chiffre vient du canal belge ?
Dans l'administration, chaque réponse demande d'ouvrir le bon écran, de combiner deux ou trois filtres, parfois d'exporter un fichier pour finir le calcul dans un tableur. Ce temps-là, multiplié par plusieurs questions par jour, est celui que je décris dans l'article sur le temps perdu dans le back-office. Une interface en langage naturel ne remplace pas l'administration : elle évite les détours pour les questions ponctuelles.
Quelles solutions existent pour Sylius ?
Trois approches, qui ne demandent ni le même effort ni les mêmes précautions.
| Approche | Ce qu'elle fait | Ce qu'il faut savoir |
|---|---|---|
| Admin MCP Server (officiel) | Expose l'API d'administration comme outils pour un client IA : Claude Desktop, Claude Code, Cursor | Sylius 2.1 ou plus, version 0.2.0, OAuth réservé aux administrateurs avec ROLE_API_ACCESS, télémétrie imposée |
| Ask AI (officiel) | Panneau de discussion dans l'admin, qui s'appuie sur Admin MCP | Sylius 2.2, version 0.1.0 « proof of concept », licence BUSL 1.1, worker Messenger obligatoire |
| Agent sur mesure | Outils de lecture écrits pour vos questions, dans votre code | Plus de travail au départ, mais un périmètre exact et testé |
Le plugin Admin MCP Server annonce 171 outils répartis en 34 groupes de ressources : produits, commandes, clients, promotions, livraison et d'autres. Chaque groupe peut être désactivé, et c'est la première chose que je fais : un agent qui sert à répondre à des questions sur les ventes n'a aucune raison d'accéder aux groupes qui servent à autre chose. Le détail de ce serveur est dans l'article sur le serveur MCP de Sylius.
Le plugin Ask AI a une qualité rare : pendant une conversation, il n'envoie aucune écriture à l'API. Chaque modification devient une action proposée que l'administrateur approuve ou rejette, et les outils de suppression et de remboursement ne sont jamais exposés. Son README le qualifie pourtant de preuve de concept. Je l'évalue en détail dans l'article sur Ask AI.
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.
Que lit l'agent, et avec quels droits ?
C'est la question qui compte le plus. Avec Admin MCP, l'agent agit avec les droits de l'administrateur qui l'a autorisé. Si cet administrateur peut tout voir, l'agent peut tout lire, y compris les adresses et les historiques de tous les clients. Je crée donc un compte dédié, avec le minimum nécessaire, et je désactive les groupes d'outils inutiles. C'est l'application directe des accès par rôle : la limite est posée dans la configuration, pas dans une phrase du prompt.
Deuxième point : où partent les données. Quand vous posez une question dans Claude Desktop branché sur votre admin, les résultats lus sont transmis au fournisseur du modèle pour qu'il rédige la réponse. Ce n'est pas un problème en soi, mais c'est un choix à faire en connaissance de cause, notamment pour les données clients. Je détaille ce point dans l'article sur le trajet des données.
Troisième point : la fiabilité des réponses. Un modèle peut mal choisir un filtre, confondre deux états de commande ou s'arrêter à la première page de résultats. Sur un agent sur mesure, j'écris des outils étroits, qui font eux-mêmes le comptage et renvoient un chiffre déjà calculé, et je fais citer à l'agent l'outil utilisé. Vous savez ainsi d'où vient la réponse.
Ce que l'agent ne fait jamais seul
Un agent d'interrogation est un agent de lecture. Il ne change ni un prix, ni un stock, ni l'état d'une commande, et il n'écrit à aucun client. Si vous lui demandez de le faire, il répond qu'il n'en a pas le moyen et vous donne le lien vers l'écran concerné. Le jour où une écriture se justifie, elle passe par une validation humaine explicite, sur le modèle des actions proposées d'Ask AI, et elle est tracée.
Les garde-fous complètent ce cadre : une question qui demanderait l'export de toute la base clients est refusée, et un volume de lectures anormal déclenche une alerte.
Par quoi commencer sur votre boutique ?
Je commence par recueillir les vingt questions que vous posez réellement à votre administration. Elles disent quels outils écrire ou activer, et elles deviennent les cas de test : chaque réponse de l'agent est comparée à la bonne réponse calculée à la main. Si votre boutique est sous Sylius 2.2 ou plus, tester Ask AI sur une copie de la boutique est un bon moyen de voir l'usage en vrai. Si elle est sous Sylius 1, la migration vers Sylius 2 ouvre l'accès à ces briques officielles.
Quand les questions reviennent chaque jour, un rapport envoyé automatiquement est souvent plus utile qu'une conversation : c'est le sujet de l'article sur le rapport quotidien.
Pour choisir la bonne approche sur votre boutique, je propose un diagnostic IA offert : je vous rappelle sous 24 heures ouvrées, je regarde votre version de Sylius et vos questions, et je vous propose une solution qui rentre dans votre budget.
