Skip to content
Gillia Developers v1

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.

  1. 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.
  2. 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 de site_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_link donne un tel lien à tout moment.
  3. Accord. La réponse de site_publish_prepare liste 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.
  4. Publication. site_publish_confirm publie 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

  1. Lire : site_overview (le site en entier), puis site_page_read (la page, avec les uid, les opérations possibles et le jeton de version).
  2. Modifier tout d'un coup : site_page_edit applique 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.
  3. Regarder : site_page_capture à l'écran concerné, et site_page_measure quand un écart ou un alignement pose question. Une modification n'est faite que lorsque vous l'avez vue.
  4. 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), avec cible=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_edit modifie 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_create kind=billet) ou s'écrit à la main (site_page_edit). site_post_plan aide à 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.