Lecture de compétences (ReadSkillTool)
Présentation
L'outil de lecture de compétences permet à un agent de consulter les instructions détaillées contenues dans les compétences qui lui sont assignées. Une compétence est un document en Markdown qui décrit une procédure, un savoir-faire ou un ensemble de règles que l'agent doit suivre pour accomplir un type de tâche précis.
Cet outil est invisible dans l'interface : il est injecté automatiquement dès qu'un agent possède au moins une compétence assignée. L'utilisateur n'a pas besoin de l'activer manuellement.
Fonctionnement
Injection automatique
Lorsqu'un agent démarre un flux de travail et qu'il possède des compétences assignées, l'outil est ajouté silencieusement à sa liste d'outils. Le prompt système de l'agent est enrichi d'une section listant les compétences disponibles, avec pour chacune son nom.
Référence dans les prompts
Les prompts peuvent contenir des références à des compétences via la syntaxe {{skill:nom}}. Lors de l'exécution, cette référence est automatiquement remplacée par une instruction demandant au modèle de lire la compétence avant de poursuivre. Le modèle appelle alors l'outil pour récupérer le contenu complet.
Opérations disponibles
Lister
Affiche toutes les compétences accessibles à l'agent : nom, description et catégorie. Seules les compétences assignées à l'agent et activées sont retournées.
Lire
Récupère le contenu complet d'une compétence par son nom. L'agent ne peut lire que les compétences qui lui sont assignées — toute tentative de lecture d'une compétence non assignée est refusée.
Catégories de compétences
Les compétences sont organisées en cinq catégories :
- Système — Règles et procédures internes de l'application
- Code — Conventions de développement, patterns et bonnes pratiques
- Flux de travail — Procédures étape par étape pour des tâches complexes
- Analyse — Méthodes d'analyse, de diagnostic ou d'évaluation
- Personnalisée — Toute compétence ne relevant pas des catégories précédentes
Contrôle d'accès
Chaque agent ne peut consulter que les compétences figurant dans sa liste d'assignation, configurée dans ses paramètres. Ce cloisonnement garantit que chaque agent n'accède qu'aux instructions pertinentes pour son rôle.
Les compétences désactivées sont traitées comme inexistantes : elles n'apparaissent ni dans la liste ni dans les résultats de lecture.
Limites
- Nom : 128 caractères, uniquement lettres, chiffres, tirets et tirets bas
- Description : 500 caractères maximum
- Contenu : 50 000 caractères maximum (format Markdown)
Fonctionnement
L'outil est injecté automatiquement et s'intègre au cycle prompt-exécution de l'agent.
Injection automatique
L'outil est ajouté silencieusement dès que l'agent possède au moins une compétence assignée. Le prompt système liste les compétences disponibles.
Référence dans les prompts
La syntaxe {{skill:nom}} dans un prompt est remplacée par une instruction de lecture automatique lors de l'exécution.
{{skill:code-review}}
Opérations
L'outil expose deux opérations simples pour découvrir et consulter les compétences.
Nom, description et catégorie de chaque compétence assignée et activée
Contenu Markdown complet d'une compétence par son nom
Catégories
Les compétences sont organisées en cinq catégories pour faciliter leur classification.
Contrôle d'accès
Chaque agent n'accède qu'aux compétences qui lui sont explicitement assignées.