Concepts fondamentaux
Le modèle mental de BoostEcom, de l’organisation à la boutique, des agents aux crédits.
Organisation et boutique
L’organisation est le compte : ses membres, son abonnement Stripe (un abonnement par organisation) et ses boutiques. C’est aussi la frontière de sécurité : chaque outil, qu’il soit appelé par @Atlas ou par un client MCP, lit l’organisation dans la session, jamais dans ce que le modèle propose.
Une boutique est une boutique Shopify connectée à une organisation. Le nombre de boutiques incluses dépend du plan ; les membres sont illimités sur les plans payants.
@Atlas et les spécialistes
@Atlas est l’orchestrateur, la voix avec laquelle l’opérateur parle. Il ne fait pas le travail de domaine lui-même : il choisit le spécialiste du tour, lui délègue la tâche avec un outil dédié (un par spécialiste), puis synthétise la réponse. Les cinq spécialistes ont chacun un domaine et un jeu d’outils restreint :
Un routage par mots-clés suggère le spécialiste ; c’est @Atlas qui décide, en appelant l’outil de délégation.
Autonomie
Chaque agent a un niveau d’autonomie, réglé par organisation :
| Niveau | Libellé | Ce que l’agent fait sans demander |
|---|---|---|
| 1 | Propose | Rien : il suggère, chaque appel d’outil attend une approbation. Niveau de départ de @Maya, @Marco, @Otis et @Sam. |
| 2 | Approved | Les actions sûres de sa liste blanche ; un appel risqué demande toujours l’approbation. Niveau de départ de @Atlas et @Faye. |
| 3 | Auto | Tout, sauf les opérations critiques (publier en direct, grosse dépense) ; le plafond de dépense reste appliqué. |
Une « entreprise autonome » de bout en bout est une cible de la feuille de route, pas un réglage proposé.
Le serveur MCP
Chaque boutique a son serveur MCP. Un client IA compatible s’y connecte et obtient des outils sur la boutique, à travers deux portes qui doivent toutes deux s’ouvrir :
- les scopes que l’utilisateur a approuvés pour ce client (par exemple
boostecom:catalog.read,boostecom:orders.read) ; - les scopes Shopify que l’application personnalisée de la boutique accorde réellement.
Le relais vers Shopify est en lecture seule par conception : les écritures passent par le dashboard et son flux d’approbation.
Enregistrement canonique et Store Graph
Une analyse approfondie construit l’enregistrement canonique d’une boutique, en couches : ce qui est observé (tenu pour vrai), ce qui est inféré (présenté comme une estimation), puis des projections filtrées par spécialiste. Le Store Graph relie une boutique à ses voisines : même propriétaire (identifiants d’analytics, de pixel ou d’e-mailing partagés), même réseau (thème et applications communs), clones probables (produits ou créations en commun).
Crédits et plans
Le travail de l’IA se paie en crédits, au solde de l’organisation :
- avant chaque réponse, son coût est estimé : si le solde ne le couvre pas, la requête est refusée avant de commencer ;
- pendant la réponse, elle s’arrête quand le solde est atteint ;
- les plans payants incluent des crédits chaque mois et un bonus quotidien, accordé chaque nuit aux organisations dont le propriétaire a été actif dans les dernières 24 heures.
| Plan | Identifiant | Pour qui |
|---|---|---|
| Free | free | Ouvrir un compte, obtenir une clé MCP et brancher une boutique sur son propre LLM. Ni crédit, ni chat. |
| Pro | pro | Premier palier payant, 3 boutiques incluses. |
| Max 5x | max_5x | Deuxième palier, 10 boutiques incluses. |
| Max 20x | max_20x | Troisième palier, 25 boutiques incluses. |
| Custom | custom | Sur mesure, boutiques non plafonnées. |
Les paliers diffèrent aussi par les crédits inclus, le bonus quotidien, les tâches IA et workflows simultanés et les allocations MCP. Les prix publics sont sur https://www.boostecom.app/pricing.
Skills
Un skill est un savoir-faire que @Atlas peut charger. Les skills marchands s’ouvrent selon le plan ; ils sont distincts des skills internes de la plateforme, et les deux bibliothèques ne se mélangent jamais.
Sources dans l’app : src/features/ai/agents/identity-registry.ts, src/features/ai/agents/agents/specialists.ts, src/features/ai/agents/agents/atlas-router.ts, src/features/ai/agents/autonomy.ts, src/lib/security/mcp-scopes.ts, src/types/billing-plans.ts, src/config/plans.ts.