Les Agent Skills permettent à l’agent de votre SaaS de lire une procédure métier au moment de traiter la demande correspondante. Ils deviennent utiles lorsque le même agent gère plusieurs tâches dont les procédures évoluent séparément.
Prenons un agent de support fictif. Aujourd’hui, il aide vos clients à retrouver leurs factures. Demain, il devra aussi traiter les demandes de remboursement. Il lui faudra retrouver la transaction, vérifier la politique applicable et transmettre les exceptions à l’équipe. Le mois suivant, vous voulez lui confier les changements d’abonnement.
Vous pouvez ajouter chaque procédure aux instructions générales de l’agent. Mais à la prochaine modification de la politique de remboursement, il faudra intervenir dans le même bloc d’instructions que celui qui sert à traiter les demandes de facturation et d’abonnement. C’est le moment de décider quelles consignes l’agent doit recevoir à chaque demande et quelles procédures il peut lire au besoin.
Comment l’agent choisit la bonne procédure
Agent Skills est un format ouvert créé à l’origine par Anthropic. Chaque skill contient un fichier SKILL.md avec un nom, une description et les étapes de la procédure. Il peut aussi inclure des exemples ou des documents de référence. Certaines plateformes, comme l’API Claude, prennent ce format en charge directement. Si vous gérez vous-même l’exécution de votre agent, c’est à votre application de lui présenter les skills disponibles et de lui fournir les instructions au bon moment. Spécification Agent Skills · Documentation de l’API Claude
Au départ, le modèle voit le nom et la description de chaque skill. Quand le choix lui revient, c’est cette description qui l’aide à distinguer deux demandes proches. « J’ai été débité deux fois » relève d’un examen de remboursement. « Où puis-je télécharger ma facture ? » relève de la consultation. Si les deux descriptions disent seulement « traite les problèmes de facturation », le modèle a peu d’éléments pour trancher.
Pour un premier pilote, vous pouvez livrer quelques fichiers SKILL.md avec votre application. Le serveur présente à l’assistant les skills disponibles pour le compte. Lorsque le modèle choisit un skill, il peut appeler un outil interne comme loadSkill pour en lire les instructions. Il suffit de lire le fichier si la procédure tient dans le Markdown. Si vous utilisez les skills natifs de l’API Messages de Claude, leur chargement passe par un conteneur d’exécution. Guide AI SDK · Guide Claude API
L’application peut aussi sélectionner le skill elle-même si le client passe par un bouton « Demander un remboursement ». Guide d’intégration Agent Skills
Qui autorise le remboursement ?
Le skill guide l’agent. Le serveur décide quelles actions sont autorisées. Dans notre exemple, les trois éléments ont chacun un rôle.
| Élément | Ce qu’il contient | Qui le modifie |
|---|---|---|
| Skill | Les étapes pour examiner la demande, les informations à recueillir et les cas à transmettre. | L’équipe qui maintient la procédure de support. |
| Outil | L’accès aux transactions et, si vous le décidez, une action pour demander un remboursement. | L’équipe qui maintient l’intégration de facturation. |
| Règle serveur | Les vérifications de droits et d’éligibilité appliquées avant tout remboursement. | L’équipe qui maintient les règles de facturation. |
Pour une première version, vous pouvez laisser l’agent préparer le dossier et confier la validation à l’équipe. Mesurez alors combien de dossiers arrivent complets et combien nécessitent un nouvel échange avec le client.
Comment tester votre premier skill
Commencez par une procédure fréquente, déjà documentée et assez distincte des autres. Rejouez les mêmes demandes avec et sans le skill, à modèle et outils identiques. Vérifiez deux résultats séparément. L’agent a-t-il choisi la bonne procédure ? L’a-t-il suivie correctement ? Guide d’évaluation des skills
- Double facturation. C’est le cas nominal. L’agent doit activer le skill de remboursement, retrouver les transactions et préparer le dossier.
- Demande sans facture identifiable. C’est le cas limite. L’agent doit activer le même skill, puis demander l’information manquante avant de poursuivre.
- Téléchargement d’une facture. C’est le cas de contrôle. L’agent doit aider le client à retrouver sa facture sans activer le skill de remboursement.
Rejouez ensuite les mêmes tickets en donnant directement à l’assistant les mêmes instructions de remboursement. À modèle et outils identiques, vous pouvez comparer la qualité du traitement et le temps de réponse avec le chargement à la demande. Le premier test mesure l’apport de la procédure. Ce second test aide à décider si le mécanisme de sélection vaut le travail d’intégration.
Gardez ces demandes comme tests de régression. Si vous modifiez la description, elles vous aident à vérifier que l’agent choisit toujours le bon parcours. Si vous modifiez les étapes, elles vous aident à vérifier que le dossier produit répond toujours aux attentes du support.
Pour un parcours court dont les étapes sont connues à l’avance, un workflow fixe peut suffire.
Ce qu’il faut retenir
Une procédure mérite son propre skill lorsqu’elle doit évoluer indépendamment des autres tâches de l’agent.
Conclusion
Prenez quelques tickets anonymisés, décidez lesquels doivent déclencher la procédure et écrivez le résultat attendu pour chacun. Vous aurez une base pour décider si le skill améliore le traitement des demandes.
En 30 minutes, on peut choisir ensemble la première procédure à intégrer et les tickets qui serviront à la tester. Réserver un échange.
