Guide
Modifier un site Gillia avec une IA
Le guide des outils site_* pour Claude, ChatGPT et toute IA branchée par le connecteur Gillia : notions, cycle de travail, savoir de design.
À qui s'adresse ce guide
Ce guide s'adresse à une IA (Claude, ChatGPT ou un autre client MCP) qui modifie le site d'un commerçant par le connecteur Gillia, et aux développeurs qui la branchent. Il explique ce qu'est un site Gillia, comment y travailler sans surprise pour le commerçant, et ce qui fait un bon site de commerce. La liste exacte des outils, de leurs paramètres et de chaque opération est dans la référence (ressource gillia://site/reference, ou outil site_vocabulary) : elle est générée depuis le logiciel et ne peut pas diverger de lui.
Une règle traverse tout le guide : le commerçant décide. Vous préparez, vous montrez, il dit oui, puis vous publiez.
Le parcours : brouillon, aperçu, accord, publication
C'est le parcours de toute modification visible par les clients du commerçant.
- Brouillon. Toute modification d'une page, de l'en-tête, du pied, du menu ou du style du site va d'abord dans un brouillon. Les visiteurs ne voient rien. Vous pouvez enchaîner autant de retouches que nécessaire.
- Montrer l'aperçu. Avant de publier, appelez
site_publish_prepare. Chez les clients qui affichent les applications MCP, l'aperçu s'affiche alors dans la conversation : les captures du brouillon, et les boutons Publier et Ne pas publier. Sinon, montrez les images desite_page_capture(ordinateur, tablette, téléphone) et donnez le lien d'aperçu de sa réponse : il s'ouvre sans connexion, sur l'ordinateur ou le téléphone du commerçant, qui peut aussi l'envoyer à quelqu'un pour avis.site_preview_linkdonne un tel lien à tout moment. - Accord. La réponse de
site_publish_prepareliste aussi ce qui va changer en ligne et les vérifications (liens vides, textes peu lisibles, page vers une page non publiée…). Montrez cette liste. Attendez un oui explicite. - Publication.
site_publish_confirmpublie exactement ce qui a été préparé, rien d'autre. Si la page ou le brouillon a bougé depuis la préparation, il refuse sans rien écrire : préparez à nouveau.
Ne publiez jamais « pour aller plus vite », même si la demande semble claire : une page publiée est vue tout de suite par les clients du commerçant.
Une exception, à dire au commerçant avant d'agir : l'en-tête d'un rayon (site_rayon_header) part en ligne tout de suite, car il n'a pas de brouillon. Montrez le texte, obtenez l'accord, puis écrivez-le ; la réponse rend l'ancienne valeur pour revenir en arrière. Activer un autre thème (un site généré, par exemple) change tout le site en ligne : cela se fait aussi en deux temps, et seulement avec son accord.
Les notions
Un site, des pages, un brouillon du site
Un site Gillia, c'est un thème (couleurs, polices, boutons, arrondis, en-tête, pied, menu) et des pages (accueil, pages libres, billets de blog, modèles de fiche ou de rayon). Le style, l'en-tête, le pied et le menu ont leur propre brouillon, le brouillon du site, mis en ligne d'un seul geste (« Mettre en ligne… », c'est-à-dire site_publish_prepare puis site_publish_confirm avec scope=site).
Une page : sections, boîtes, contenus
Une page est faite de sections empilées. Une section contient des boîtes (des colonnes, des grilles, des groupes) qui contiennent des contenus : titre, texte, bouton, image, vidéo, icône, questions fréquentes, formulaire, liste de produits… Chaque élément a un uid stable (8 caractères) : c'est par lui que vous désignez ce que vous modifiez. Lisez la page (site_page_read) pour connaître les uid ; ne les devinez pas.
Trois écrans, en cascade
Chaque réglage de mise en page existe pour l'ordinateur, la tablette et le téléphone. La tablette hérite de l'ordinateur, le téléphone hérite de la tablette, sauf là où un écran a son propre réglage. Corriger « le bouton est décalé sur téléphone » se fait donc sur l'écran téléphone, sans toucher l'ordinateur. Vérifiez toujours à la largeur de l'écran concerné.
Le style de la marque et le style d'un élément
Les couleurs, polices et boutons du site s'appliquent partout. Un élément peut avoir son propre style, mais un site cohérent s'appuie sur le style du site : préférez changer la couleur principale du site plutôt que celle de dix boutons un par un.
Des données vivantes
Une liste de produits est branchée sur le catalogue (des articles choisis, une famille, un rayon, une collection, les nouveautés) : elle montre le prix, la photo et la disponibilité du jour. N'écrivez jamais un prix ou un produit à la main dans un texte : il se périmerait. Les articles se lisent dans le catalogue (site_find, site_sales_signals) ; ne citez que des articles lus, jamais inventés.
Les modèles
Les fiches produit et les pages de rayon peuvent être mises en page par un modèle (pour tout le site, une famille ou un article). Modifier un modèle change toutes les fiches qu'il sert : dites-le au commerçant.
La boucle de travail
- Lire :
site_overview(le site en entier), puissite_page_read(la page, avec les uid, les opérations possibles et le jeton de version). - Modifier tout d'un coup :
site_page_editapplique une liste d'opérations, toutes ou aucune. Redonnez le jeton lu : si quelqu'un a modifié la page entre-temps (le commerçant dans l'éditeur, par exemple), rien n'est écrit et la version actuelle vous est rendue. - Regarder :
site_page_captureà l'écran concerné, etsite_page_measurequand un écart ou un alignement pose question. Une modification n'est faite que lorsque vous l'avez vue. - Corriger si besoin, puis montrer et proposer la publication (le parcours ci-dessus).
Une page ancienne (première mise en page) est d'abord passée dans la mise en page actuelle ; c'est automatique à la première modification, et la réponse dit ce qui a changé.
Les refus sont nommés. Un refus dit pourquoi et comment faire autrement (opération inconnue, élément introuvable, réglage impossible à cet écran, jeton périmé, droit manquant). Lisez-le, corrigez, réessayez ; ne contournez pas.
Annuler. site_undo défait le dernier geste s'il est le vôtre ; site_history et site_restore_version reviennent à une version précédente. site_discard_draft abandonne un brouillon.
Ce qui fait un bon site de commerce
Ce qui suit est du savoir, à peser selon le commerce et ce que vous voyez sur les captures.
- Le client cherche d'abord : ce qu'on vend, où, quand, comment acheter. L'accueil le dit en une phrase et un appel à l'action clair (Commander, Réserver, Voir la carte).
- Une hiérarchie lisible : un titre principal par page, des intertitres qui se lisent seuls, des paragraphes courts.
- Le téléphone d'abord : la plupart des visiteurs y sont. Le prix et le bouton d'achat se voient sans défiler loin ; les images ne poussent pas tout vers le bas.
- Un appel à l'action par section, pas trois boutons qui se disputent l'attention.
- Lisible : un texte se lit sur son fond (contraste). Les vérifications le mesurent ; une capture le confirme.
- Des images vraies : les produits et le lieu du commerçant valent mieux qu'une illustration générique. La médiathèque (
site_media_list,site_media_generate,site_media_import) garde les images du commerçant. - Le rythme : des sections qui respirent, des espacements réguliers, pas de vide inexpliqué.
- Des données vivantes plutôt que du texte figé : listes de produits, meilleures ventes, nouveautés.
Critiquer avant d'agir
Quand le commerçant demande un avis, rassemblez les faits avant de juger :
site_check: les vérifications mesurables d'une page, d'un modèle ou du site (liens, images, contraste, produits retirés, champs vides des fiches).site_critique: le dossier pour juger les fiches produit, le menu, un billet ou l'en-tête d'un rayon (faits, captures, et le savoir de ce qui marche), aveccible=fiche|menu|billet|rayon.site_stats: les visites, leur provenance, la conversion, les demandes reçues.
Une critique utile nomme ce qui gêne le client, où, ce que cela coûte, et propose le geste le plus rentable d'abord. Elle ne modifie rien : proposez, puis agissez avec l'accord.
Le menu, le blog, les rayons
- Menu :
site_menu_editmodifie le menu dans le brouillon du site. Une entrée peut se masquer seule tant qu'aucun article n'est en vente derrière elle (hideWhenEmpty), et une entrée « Nouveautés » suit les arrivages. - Blog : un billet se crée hors ligne (
site_post_create), son contenu se génère avec les vrais articles (site_createkind=billet) ou s'écrit à la main (site_page_edit).site_post_planaide à proposer un calendrier (moments à venir, ventes de l'an dernier). Un billet se publie comme une page. - Rayons : l'en-tête d'un rayon se critique (
site_critique cible=rayon) puis s'écrit (site_rayon_header), en ligne tout de suite.
Créer une page ou un site
site_create génère une page, le contenu d'un billet ou un site entier à partir d'une description ; c'est long (une à cinq minutes), suivez avec site_job_status. Une page naît hors ligne ; un site naît dans un thème neuf, non activé : le site en ligne ne change pas tant que le commerçant n'a pas dit oui à l'activation. Pour retoucher ce qui existe, c'est site_page_edit, pas une régénération.
Droits et confidentialité
- Le connecteur agit avec les droits du compte qui l'a branché et les portées accordées (
site.read,site.write,site.publish). Un outil hors portée répond par un refus qui dit quelle portée demander. - Les ventes ne se lisent qu'avec le droit correspondant.
- Le connecteur ne donne jamais la structure technique de Gillia : vous travaillez avec des notions, des uid et des identifiants d'articles, pas avec une base de données.
Les recettes
Le connecteur propose des recettes prêtes à l'emploi (prompts MCP), chacune appliquant ce parcours : refaire la page d'accueil, préparer une page de soldes, mettre en avant les meilleures ventes, critiquer le site, corriger l'affichage sur téléphone, créer un site à partir d'une description, écrire un billet de blog.