Skills et Rules
Connecter le MCP à un agent LLM permet à l'agent d'appeler directement l'API de WEEGLOO. Mais pouvoir appeler une API et l'utiliser exactement de la manière prévue par WEEGLOO sont deux choses différentes. Par exemple, savoir dans quelles situations utiliser la CMA et dans lesquelles utiliser la CDA, comment concevoir les champs d'un Content Type, ou quelles permissions rattacher à un Delivery Access Token pour qu'il soit sûr : la seule façon d'appeler l'API ne suffit pas à le savoir.
Les Skills et les Rules sont deux formes de consignes qui comblent cet écart. Les Skills sont des guides qui expliquent comment bien accomplir une tâche précise, et les Rules sont les règles à respecter tout au long du travail. L'outil d'installation (npx weegloo@latest) peut installer les deux en même temps que la connexion MCP.
Différence entre les Skills et les Rules
Les deux sont des informations données à l'agent, mais leurs rôles diffèrent.
Les Skills sont des guides qui décrivent, sous forme d'étapes et de modèles, comment accomplir une tâche précise. Il y en a une par tâche, et l'agent lit et suit la Skill correspondante au moment où il commence cette tâche. Par exemple, la conception d'un Content Type, le choix de la structure d'un service ou l'émission d'un Delivery Access Token ont chacun leur Skill. L'agent suit ainsi une méthode éprouvée plutôt que de deviner.
Les Rules sont les règles à respecter en permanence, quel que soit le type de tâche. Ce sont par exemple l'adresse de base de l'API de WEEGLOO, la façon de récupérer une liste de ressources page par page, ou le fait de devoir envoyer l'information de version lors de la modification d'une ressource. L'agent applique ces règles en arrière-plan tout au long du travail.
En résumé, les Skills sont des consignes par tâche du type « pour cette tâche, on procède ainsi », et les Rules sont des règles communes du type « quelle que soit la tâche, on respecte ceci ».
Installer
Les Skills et les Rules sont installés par l'outil d'installation MCP. Il suffit d'exécuter la commande suivante dans le terminal.
npx weegloo@latestÀ l'exécution, l'outil demande successivement l'environnement (agent) à connecter et le Personal Access Token, puis installe les Skills et les Rules dans cet environnement en même temps que le serveur MCP. Le processus d'installation et la configuration propre à chaque environnement sont traités dans Se connecter.
Avec @latest, c'est toujours la dernière version qui est installée. La façon de se remettre à jour après une première installation est traitée dans Rester à jour.
Rester à jour
Les Skills et les Rules ne s'installent pas une fois pour toutes. Chaque fois qu'une fonctionnalité apparaît dans WEEGLOO ou qu'une méthode recommandée change, ces consignes sont mises à jour en conséquence. Ce qui est installé sur votre ordinateur, en revanche, est une copie prise au moment de l'installation : ce contenu reste figé.
Quand l'installation vieillit, deux choses se produisent. Les Skills et les Rules ajoutés depuis n'existent pas du tout dans votre installation, et l'agent ignore donc comment traiter ces fonctionnalités. Et si le contenu d'un élément déjà présent a changé, l'agent suit les anciennes consignes telles quelles. Dans les deux cas, l'agent travaille à partir du WEEGLOO du moment de l'installation, et non du WEEGLOO actuel. C'est là que se joue la qualité de ce que produit l'agent : mieux vaut donc garder les Skills et les Rules à jour.
Ce qu'il faut garder à jour, ce sont les Skills et les Rules installés sur votre ordinateur. Le serveur MCP, lui, n'a rien à mettre à jour.
Quand une nouvelle version paraît, l'agent vous en informe. Au début d'un travail lié à WEEGLOO, il vérifie la version installée et n'affiche rien si elle est à jour. Ce n'est que lorsqu'il y a quelque chose à mettre à jour qu'il affiche un message comme le suivant, accompagné de la commande à exécuter.
Cette mise à jour ne s'exécute pas automatiquement. Comme elle réécrit les fichiers installés, elle n'est lancée qu'après votre confirmation. Lorsque le message s'affiche, mieux vaut ne pas remettre à plus tard et exécuter la commande sur-le-champ. Il suffit d'exécuter dans le terminal la commande affichée dans le message.
--agent et --location reçoivent l'environnement et l'emplacement choisis lors de l'installation : la commande varie donc selon votre installation. En reprenant telle quelle la commande affichée dans le message, vous obtenez les bonnes valeurs.
Au lieu de saisir la commande vous-même, vous pouvez aussi demander à l'agent « mets weegloo à jour ». L'agent connaît déjà la commande à exécuter, vous n'avez donc pas à chercher laquelle utiliser.
Ce qu'une mise à jour conserve et ce qu'elle remplace
Une mise à jour ne recommence pas l'installation depuis le début. Elle conserve les choix faits lors de la première installation et n'actualise que le contenu.
- La sélection de Skills et de Rules faite à l'installation est conservée telle quelle. Si vous n'en aviez installé qu'une partie, cela reste ainsi.
- Les Skills et les Rules ajoutés depuis la dernière installation sont installés automatiquement. Les éléments que vous aviez volontairement exclus restent exclus.
- Les éléments supprimés du dépôt sont également retirés de votre ordinateur.
- Vous restez sur la version choisie à l'installation.
- La configuration du serveur MCP n'est pas touchée. Un Personal Access Token n'est donc pas nécessaire pour la mise à jour.
Si vous avez supprimé à la main un fichier de Skill ou de Rule installé, la mise à jour le réinstalle. Pour retirer un élément, ne supprimez pas le fichier : relancez la commande d'installation et décochez-le dans l'écran de sélection.
Le contenu mis à jour s'applique à partir d'une nouvelle conversation. L'agent lit les Skills et les Rules au début de la conversation ; une conversation en cours continue donc d'utiliser le contenu précédent.
Les consulter directement
Les Skills et les Rules se trouvent dans un dépôt public. Pour ouvrir vous-même ce qui est installé, ou pour voir quelles consignes existent pour quelles tâches, reportez-vous au dépôt.
Les Skills et les Rules se trouvent sous plugins/weegloo/ dans le dépôt, respectivement dans les dossiers skills/ et rules/.
- Dossier des Skills : plugins/weegloo/skills
- Dossier des Rules : plugins/weegloo/rules
Même pour une intégration manuelle sans l'outil d'installation, il suffit de reprendre tels quels les fichiers du chemin latest ci-dessus.
Étapes suivantes
- Se connecter : présente comment installer le serveur MCP, les Skills et les Rules pour chaque environnement (agent).
- MCP : présente comment se compose le serveur MCP, ainsi que les groupes de serveurs et le serveur de téléversement de fichiers.