Claude Commerce Agents : créer un agent e-commerce IA
Claude Commerce Agents est un blueprint open-source qu’Anthropic a publié le 2 septembre 2026 sous licence Apache-2.0 pour construire deux agents e-commerce sur Claude : un agent shopping côté client et un agent marchand côté staff. Concrètement, vous clonez un dépôt qui contient déjà le code, les garde-fous et quatre exemples verticaux, puis vous l’adaptez à votre catalogue.
Ce n’est ni un produit fermé ni une place de marché : c’est un kit de départ que vous hébergez et modifiez. Selon Anthropic, les partenaires qui l’ont testé en conditions réelles, dont Shopify et Priceline, rapportent des paniers jusqu’à 35 % plus volumineux et des acheteurs 60 % plus susceptibles de finaliser leur achat. J’ai passé le blueprint au crible pour comprendre ce qu’il fait, ce qu’il ne fait pas, et comment le mettre en place.
Qu’est-ce que Claude Commerce Agents
Claude Commerce Agents est un dépôt de référence (anthropics/commerce-agents) qui montre comment assembler des agents de commerce avec Claude. La logique d’Anthropic n’est pas de vendre un agent tout fait, mais de fournir l’architecture pour que chaque e-commerçant construise le sien.
Le principe directeur du blueprint tient en une formule que je trouve remarquablement claire : l’argent, les écritures en base et les identifiants sont verrouillés dans le code — le modèle propose, le harnais applique. Autrement dit, Claude suggère une action, mais c’est du code déterministe, pas le modèle, qui décide d’exécuter ou non les opérations sensibles.
Le dépôt tourne en local avec Python 3.11+, Node 22 et une clé ANTHROPIC_API_KEY. Il embarque deux agents de référence, quatre verticales, un harnais de sécurité, une suite d’évaluation et un plugin pour Claude Code.
Un blueprint, pas un produit
La distinction est importante pour un décideur e-commerce. Un produit SaaS impose son modèle de données et sa tarification ; un blueprint open-source vous laisse la propriété du code et de l’architecture.
Vous êtes libre de modifier les prompts, les outils, les garde-fous et l’interface. Cette approche rejoint celle de Claude Managed Agents, l’infrastructure d’exécution d’agents d’Anthropic sur laquelle le blueprint peut d’ailleurs s’appuyer.
Deux agents sur les memes bibliotheques : le shopping construit le panier puis passe la main, le marchand attend toujours une validation humaine.
Les deux agents de référence
Le blueprint fournit deux agents complémentaires : l’un tourné vers le client, l’autre vers le personnel du magasin. Ils partagent les mêmes bibliothèques mais répondent à des besoins opposés.
L’agent shopping (côté client)
L’agent shopping opère dans votre application ou votre site web et accompagne l’acheteur de la découverte au panier. Ses capacités couvrent l’essentiel du parcours d’achat conversationnel :
- recherche dans le catalogue et assemblage de plusieurs articles ;
- personnalisation selon les préférences du client ;
- affichage et comparaison des produits directement dans la conversation ;
- construction du panier puis hand-off vers le checkout du marchand ;
- service client (suivi de commande, retours, politiques de remboursement).
Le point d’arrêt est net : l’agent construit le panier, puis passe la main. Il ne traite pas le paiement.
L’agent marchand (côté staff)
L’agent marchand assiste les équipes du magasin dans la gestion quotidienne. Il agit comme un analyste et un assistant de rédaction, jamais comme un exécutant autonome sur les données sensibles :
- analyse des performances de vente ;
- suivi des stocks et alertes ;
- recommandations de prix et de promotions ;
- rédaction de campagnes marketing.
Chaque modification qui touche la boutique en production est mise en attente pour validation humaine. Le modèle rédige une fiche produit ou propose une baisse de prix, mais un humain valide avant que le changement ne devienne visible.
Les quatre exemples verticaux
Le dépôt inclut quatre verticales exécutables qui démontrent les deux agents sur les mêmes bibliothèques. Elles servent de points de départ concrets plutôt que de simples démos théoriques.
| Verticale | Cas d’usage type | Agent shopping | Agent marchand |
|---|---|---|---|
| Retail | Boutique de produits physiques | Recherche catalogue, comparaison, panier | Fiches produit, prix, stock |
| Voyage | Réservation de séjours | Assemblage vol + hôtel, préférences | Analyse taux de conversion, tarifs |
| Télécom | Forfaits et appareils | Comparaison de forfaits, upsell encadré | Campagnes, ajustement d’offres |
| Divertissement | Billetterie et streaming | Recommandation d’événements, panier | Analyse d’audience, promotions |
Chaque verticale illustre comment un même socle technique s’adapte à des catalogues et des parcours différents. Pour un e-commerçant français, la verticale retail est le point d’entrée le plus direct.
Sécurité, évaluation et validation humaine
La sécurité n’est pas une option ajoutée après coup : elle est structurellement inscrite dans le harnais. C’est probablement l’aspect le plus intéressant du blueprint pour un usage en production.
Le harnais de sécurité
Les garde-fous contraignent l’agent aux données du catalogue : les prix et les produits proposés proviennent des sources officielles, pas d’une invention du modèle. Le blueprint évite également les schémas d’upsell manipulateurs, un point sensible pour la conformité et la réputation.
La règle selon laquelle le modèle propose et le harnais applique signifie que l’argent, les écritures en base et les identifiants sont gérés par du code, hors de portée directe du modèle. Cette séparation limite l’impact d’une éventuelle injection de prompt, un sujet que je détaille dans le guide de sécurité de Claude Code en entreprise.
Les patterns d’évaluation
Le blueprint embarque une suite d’évaluation pour tester le comportement des agents avant mise en production. Anthropic rapporte un enseignement d’architecture issu de ses déploiements : « un agent unique doté de skills a battu à la fois le design en un seul gros prompt et le design en sous-agents sur la qualité, souvent à un coût et une latence inférieurs ».
Cette leçon oriente le blueprint vers une architecture d’agent unique enrichie de skills, plutôt qu’une multiplication de sous-agents. Le résultat vise une meilleure qualité pour un coût maîtrisé.
Déploiement et outil de build
Un même agent est défini une seule fois, puis peut s’exécuter sur trois runtimes Claude : l’API Messages, le Claude Agent SDK ou Claude Managed Agents (bêta). Cette définition unique (prompts, skills, contrats d’outils et gates) évite de réécrire l’agent selon l’environnement cible.
Une seule definition d’agent s’execute sur 3 runtimes Claude et se deploie sur 4 clouds, sans verrouillage fournisseur.
Les options de déploiement
Le blueprint se déploie sur quatre plateformes, ce qui couvre les principaux clouds d’entreprise :
| Plateforme | Fournisseur | Intérêt principal |
|---|---|---|
| Claude API | Anthropic | Accès direct, mise en route rapide |
| Amazon Bedrock | AWS | Facturation et IAM AWS |
| Microsoft Foundry | Microsoft | Écosystème Azure |
| Google Cloud Vertex AI | Intégration GCP |
Cette portabilité multi-cloud est un argument fort pour éviter le verrouillage fournisseur, un critère de plus en plus regardé par les directions techniques.
Le plugin builder pour Claude Code
Le dépôt fournit un plugin marketplace pour Claude Code, nommé commerce-builder, qui accélère la création d’agents. Deux commandes structurent le travail :
/scaffold-commerce-agentgénère la structure d’un nouvel agent shopping ou marchand ;/review-commerce-agentaudite un agent existant.
Si vous découvrez l’outil, le guide complet de Claude Code explique l’installation et les commandes de base avant de vous lancer dans le scaffolding commerce.
Deux resultats cles rapportes par Anthropic : +35 % sur la taille du panier et +60 % de finalisation d’achat.
Résultats mesurés et écosystème partenaire
Les chiffres avancés par Anthropic proviennent de partenaires ayant déployé le blueprint en conditions réelles. Deux résultats ressortent, mesurés chez des acteurs comme Shopify et Priceline.
- Paniers jusqu’à 35 % plus volumineux grâce à l’assemblage multi-articles et aux recommandations personnalisées.
- Acheteurs 60 % plus susceptibles de finaliser leur achat, l’agent réduisant les frictions du parcours.
L’écosystème dépasse ces deux enseignes. Accenture, Mastercard et Visa intègrent le blueprint à leurs plateformes, chacun sur son maillon : intégration et conseil pour Accenture, rails de paiement pour Mastercard et Visa. Shopify a d’ailleurs publié son propre dépôt d’implémentation (Shopify/claude-for-commerce-examples) avec un agent storefront et un agent marchand connectés à son Admin API.
Pourquoi Anthropic ne gère ni paiement ni checkout
Anthropic a délibérément laissé de côté trois couches : le traitement du paiement, le système de checkout et la régie publicitaire. Ce choix de périmètre est structurant pour comprendre le positionnement du blueprint.
La logique est celle de la couche d’intelligence, pas du portefeuille. Le paiement reste l’affaire de Visa, Mastercard et des prestataires de paiement ; le checkout, celle de la plateforme e-commerce du marchand. Anthropic apporte l’agent conversationnel qui recommande et assemble, puis s’efface au moment de la transaction.
Ce partage des rôles évite à Anthropic d’entrer en concurrence frontale avec ses propres partenaires paiement, et rassure les marchands qui gardent le contrôle de leur tunnel de conversion. À mon avis, c’est aussi un choix pragmatique : les couches paiement sont saturées de contraintes réglementaires (PCI-DSS, DSP2 en Europe) qu’Anthropic n’a aucun intérêt à absorber.
Mon avis sur Claude Commerce Agents
Claude Commerce Agents convient aux e-commerçants et aux équipes de développement qui veulent un agent maison sans repartir de zéro. Le blueprint résout la partie la plus délicate — l’architecture de sécurité et la séparation entre proposition du modèle et exécution par le code — tout en laissant la personnalisation ouverte.
Pour une TPE ou une PME sans équipe technique, le chantier reste conséquent : cloner un dépôt Python/Node et l’adapter à son catalogue demande des compétences de développement. Dans ce cas, je regarderais d’abord Claude for Small Business et les connecteurs prêts à l’emploi avant de me lancer dans un agent sur mesure.
L’essentiel à retenir : Anthropic livre le cerveau du commerce agentique en open-source, gouverné et portable multi-cloud, mais laisse volontairement le portefeuille et le checkout aux acteurs existants. Pour tester, commencez par le plugin commerce-builder sur une verticale, puis mesurez sur un périmètre restreint avant de généraliser.