Compétences

Une compétence (skill) est un savoir-faire réutilisable que vous mettez à disposition d'un agent IA : une procédure écrite, les fichiers de référence qui l'accompagnent, des gabarits, et si nécessaire des scripts de traitement.

Là où une base de connaissances apporte de la documentation à l'agent, une compétence lui apporte une méthode : quoi faire, dans quel ordre, avec quels outils.

Le principe : l'agent ne lit que ce dont il a besoin

Une compétence se dévoile en trois temps, ce qui permet d'en attacher plusieurs à un même agent sans saturer sa fenêtre de contexte :

1. Au démarrage, l'agent ne voit que le nom et la description de chaque compétence disponible. C'est peu de texte, et cela suffit pour qu'il décide laquelle est pertinente.
2. S'il juge la compétence utile, il lit ses instructions complètes (le fichier SKILL.md).
3. Si les instructions le renvoient vers une référence, un gabarit ou un script, il ne les charge qu'à ce moment-là.

C'est pourquoi la description compte autant que les instructions : c'est le seul élément sur lequel l'agent s'appuie pour décider d'activer la compétence. Écrivez-la en répondant à la question « quand faut-il utiliser ceci ? » plutôt que « qu'est-ce que c'est ? ».

astuce

« Vérifie les clauses de responsabilité et de résiliation d'un contrat commercial » est une bonne description. « Compétence contrats » n'en est pas une : l'agent ne saura pas quand s'en servir.

Créer une compétence

Depuis l'onglet Manager → Compétences :

1. Cliquez sur Nouvelle compétence.
2. Donnez-lui un identifiant en minuscules avec des tirets (analyse-contrats). Il sert aussi de nom de dossier à l'export.
3. Rédigez la description.
4. Choisissez l'espace de stockage — nécessaire pour joindre des fichiers. S'il n'y en a aucun, demandez à votre administrateur d'en créer un (Admin → Compétences).

La fiche de la compétence s'ouvre sur quatre onglets.

Instructions

C'est le cœur de la compétence : le fichier SKILL.md. Il commence par un bloc de métadonnées encadré par ---, suivi des instructions en Markdown.

---
name: analyse-contrats
description: Vérifie les clauses de responsabilité et de résiliation d'un contrat commercial.
---

# analyse-contrats

## Vue d'ensemble

Cette compétence contrôle la présence et la conformité des clauses obligatoires
dans un contrat commercial.

## Instructions

1. Repérer la section « Responsabilité ». Vérifier qu'un plafond chiffré est indiqué.
2. Repérer la section « Résiliation ». Vérifier qu'un préavis est mentionné.
3. Comparer les seuils trouvés à ceux de `references/seuils.md`.

Un bandeau sous l'éditeur vous indique en direct si le format est valide et combien de tokens la compétence représente. Au-delà de 5000 tokens, elle commence à peser lourd dans le contexte de l'agent : mieux vaut alors déplacer le détail dans un fichier de référence, que l'agent ne chargera qu'au besoin.

Le bouton Aperçu bascule entre l'éditeur et le rendu.

L'assistant de rédaction

Si vous préférez décrire votre besoin en langage naturel, cliquez sur Assistant de rédaction, expliquez ce que la compétence doit faire, et l'IA vous propose un SKILL.md conforme.

La proposition est insérée dans l'éditeur mais jamais enregistrée automatiquement : relisez-la, corrigez-la, puis enregistrez. Le coût de cette génération apparaît dans Coûts IA comme n'importe quel appel de modèle.

Fichiers

Trois familles, qui correspondent aux trois dossiers d'une compétence :

Dossier	Contenu	Formats
Scripts	Code exécuté dans un environnement isolé	.py, .sh
Références	Documentation lue à la demande par l'agent	.md, .txt
Ressources	Gabarits et données utilisés par la compétence	documents, tableurs, images…

Les fichiers restent à un seul niveau de profondeur (references/seuils.md, pas references/2026/seuils.md) : l'agent les atteint ainsi en une seule lecture.

Référencez-les explicitement dans vos instructions — l'agent ne les ouvrira que si vous lui indiquez quand le faire.

Essai

Cet onglet exécute un script comme le ferait l'agent, avec les arguments et l'entrée standard de votre choix, et affiche son code de sortie, sa sortie standard et ses erreurs. C'est le même chemin d'exécution que pendant un job : ce que vous testez ici est exactement ce que l'agent obtiendra.

Paramètres

• Compétence active — une compétence inactive reste connectable dans l'éditeur mais n'est jamais transmise à l'agent.
• Autoriser l'exécution de scripts — désactivé par défaut. Sans cette option, l'agent peut lire vos scripts mais jamais les exécuter.

Les scripts et leur cloisonnement

Un script d'une compétence ne s'exécute pas sur le serveur applicatif. Il tourne dans un conteneur dédié, volontairement dépourvu de tout ce qui pourrait être utile à un attaquant :

• aucun accès réseau — ni Internet, ni la base de données, ni le stockage ;
• aucun identifiant — le conteneur ne connaît aucun mot de passe ni clé d'API ;
• système de fichiers en lecture seule, avec un espace de travail temporaire détruit après chaque exécution ;
• limites strictes de mémoire, de processeur, de nombre de processus et de durée : un script qui boucle est interrompu.

Un script n'a donc accès qu'à ce que vous lui transmettez : son propre code, les ressources de sa compétence, ses arguments et son entrée standard.

La double validation

Par sécurité, un script fraîchement téléversé est inerte. Il doit être approuvé par un administrateur avant de pouvoir s'exécuter : celui qui écrit le code n'est pas celui qui autorise son exécution. Le badge « En attente d'approbation » vous indique où en est chaque script.

Un administrateur peut désactiver cette double validation (Admin → Compétences), mais c'est déconseillé : tout script téléversé deviendrait alors immédiatement exécutable.

Connecter une compétence à un agent

Dans l'éditeur de pipeline, via le nœud Compétence :

1. Faites glisser un nœud Compétence depuis la bibliothèque (catégorie Analyse IA).
2. Sélectionnez la compétence dans le panneau de droite.
3. Reliez sa sortie à la patte compétences d'un nœud Agent ou Superviseur — la patte rose, sous le nœud.

Vous pouvez connecter plusieurs compétences à un même agent, et la même compétence à plusieurs agents. Une compétence reliée à un superviseur est partagée par tous ses sous-agents.

Le nœud Compétence ne fait pas partie du flux du document : il ne reçoit rien et ne transforme rien, il déclare simplement ce que l'agent a le droit de mobiliser.

Exporter une compétence

Le bouton Exporter (.zip) produit le dossier complet au format standard Agent Skills. L'archive est directement réutilisable dans un autre environnement compatible, et constitue une sauvegarde lisible de votre travail.