1-skills.md
Skills
Un skill est une recette reutilisable qui apprend a l’assistant IA comment traiter une question ou une tache recurrente dans votre environnement. Vous l’ecrivez une fois au lieu que chaque utilisateur la reexplique.
Les skills sont geres par les administrateurs d’environnement et profitent a tout l’environnement.
Quand un skill est utile
L’assistant sait deja explorer votre graphe. Un skill vaut la peine quand votre facon de repondre est propre a votre environnement :
- Une question recurrente qui demande toujours les memes etapes
- Un rapport ou une comparaison que votre equipe redemande regulierement
- Une regle sur les objets ou relations a utiliser
- Un vocabulaire d’equipe absent tel quel des donnees
Comment ils sont utilises
A chaque tour, l’assistant ne voit que les noms et descriptions des skills disponibles. Si une description correspond a la question, il charge ce skill et le suit. Les fichiers de reference ne sont lus qu’au besoin.
La description decide de tout — c’est la seule chose que l’assistant voit pour choisir de charger le skill.
Les utilisateurs peuvent aussi forcer un skill en saisissant /nom-du-skill.
Rediger la description
Repondez a « quand faut-il l’utiliser ? », avec les formulations que vos utilisateurs saisiraient reellement :
Bon — « A utiliser quand l’utilisateur compare deux structures et veut les differences. Declencheurs : “comparer A et B”, “qu’est-ce qui a change entre”. »
Trop vague — « Gere les comparaisons. » → ne se charge jamais
Trop large — « Pour toute question sur les donnees. » → se charge partout
Les declencheurs sont des exemples, pas une liste figee : la correspondance se fait sur le sens, dans toutes les langues prises en charge.
Rediger le corps
- Des etapes a l’imperatif, dans l’ordre
- Des placeholders generiques, pas d’identifiants figes
- Preciser le resultat attendu — tableau, graphique, colonnes cles
- Dire ce qu’il ne faut pas faire
- Deplacer les longs exemples dans des fichiers de reference
Champs
| Champ | Signification |
|---|---|
| Nom | Identifiant court, aussi la commande /nom. Unique par environnement. |
| Description | Quand l’utiliser |
| Version | Informative |
| Actif | Si l’assistant peut le voir |
| Fichiers de reference | Pieces jointes optionnelles, lues a la demande |
Chaque skill appartient a un seul environnement et ne circule jamais vers un autre.
Activer et tester
Un nouveau skill est inactif. Les administrateurs voient les brouillons marques (draft) ; les utilisateurs ne les voient pas du tout.
- Verifiez qu’il est liste et actif
- Dans une nouvelle conversation, forcez-le avec
/nom-du-skill - Dans une autre nouvelle conversation, posez une question naturelle censee le declencher — c’est ce qui valide votre description
Une conversation neuve par test : une fois charge, un skill reste actif toute la conversation. Les modifications s’appliquent au tour suivant.
Bon a savoir
- Le renommage n’est pas pris en charge — creez le nouveau nom, supprimez l’ancien
- Les fichiers de reference sont du texte, remplaces par chemin exact ; les anciens chemins ne sont pas supprimes automatiquement
- Les skills integres a la plateforme sont en lecture seule
- Supprimer un skill supprime ses fichiers de reference
- Deux skills aux descriptions qui se recouvrent se concurrencent — preferez un skill clair