Compétences en agents déclaratifs

Cet article décrit les compétences attachées à un agent déclaratif. Pour créer une compétence à utiliser directement dans Microsoft 365 Copilot Chat sans créer d’agent, consultez Créer des compétences pour Copilot Chat. La matrice de prise en charge de cet article s’applique aux compétences définies par agent, et non à toutes les compétences ou packages de plug-in.

Important

Dans les locataires qui utilisent Cloisonnement de l’information Microsoft Purview (IB), les administrateurs peuvent déployer des agents déclaratifs avec des compétences, mais les utilisateurs finaux ne peuvent pas ajouter de compétences aux agents déclaratifs qu’ils créent.

Une compétence est une capacité modulaire que vous ajoutez à un agent déclaratif pour l’aider à accomplir une tâche spécifique de manière plus fiable et plus répétitive. Une compétence est un répertoire de fichiers qui contient un fichier requis SKILL.md , ainsi que des fichiers de ressources et des scripts facultatifs. Le SKILL.md fichier contient les instructions qui indiquent au modèle d’effectuer la tâche.

Les compétences sont une composante distincte d’un agent déclaratif. Dans les directives précédentes, le mot compétences faisait référence aux descriptions de tâches que vous écriviez en ligne dans les instructions d’un agent. Les compétences remplacent cette approche : au lieu d’écrire les détails de la tâche directement dans les instructions, vous les empaquetez en tant que composant distinct auquel l’agent fait référence. Pour obtenir des instructions sur la façon dont les instructions doivent référencer les compétences, voir Rédiger des instructions efficaces pour les agents déclaratifs.

Vous pouvez ajouter des compétences à un agent déclaratif à l’aide d’Agent Builder. Pour les scénarios pro-code pris en charge, les outils de développement Work IQ sont recommandés. Son wiqd agent add skill itinéraire nécessite l’indicateur de agent-skills fonctionnalité, qui est désactivé par défaut ; voir Choisir le chemin d’implémentation de la compétence. La procédure pas à pas basée sur la boîte à outils reste disponible pour les projets de boîte à outils existants.

Qu’est-ce qu’une compétence ?

Une compétence est un répertoire dont le contenu est le suivant :

  • Un fichier obligatoire SKILL.md qui contient :
    • Nom et description de la compétence dans la page liminaire YAML.
    • Instructions de compétence, qui doivent contenir moins de 20 000 caractères.
  • Fichiers de ressources facultatifs, tels que des modèles, des données de référence ou des définitions.
  • Scripts facultatifs et dossiers de prise en charge.

Par exemple, une équipe financière peut créer une compétence de révision trimestrielle de l’activité qui regroupe les instructions de production de la révision, les scripts qui transforment les données et génèrent des graphiques, ainsi que des ressources telles que des modèles financiers, des définitions d’indicateurs clés de performance clés et des modèles de diapositives de marque. L’agent utilise la compétence lorsqu’un utilisateur demande cette tâche.

Pourquoi utiliser les compétences dans les agents déclaratifs

Les compétences vous aident à créer des flux de travail d’agent plus fiables et plus reproductibles :

  • Utilisation optimisée du contexte et précision. Les compétences utilisent la divulgation progressive : le modèle charge les instructions et le contenu d’une compétence dans leur contexte uniquement lorsque la tâche les requiert. Le contexte de l’agent reste concentré même si sa bibliothèque de compétences s’enrichit. Fournir des scripts, plutôt que de s’appuyer sur du code généré par le modèle, apporte également plus de répétabilité à vos flux de travail.
  • Mettre à l’échelle les instructions sans perte de qualité. Vous pouvez décomposer des instructions complexes en compétences modulaires et réutilisables. Cette approche vous permet de fournir des instructions plus longues et plus spécifiques sans dégrader la qualité du suivi des instructions et sans atteindre la limite de 8 000 caractères des instructions d’agent déclaratives.
  • Empaquetez des ressources réutilisables. Vous pouvez empaqueter des instructions, des ressources et des scripts en tant que compétence et intégrer cette fonctionnalité dans votre agent déclaratif.
  • Prêt pour l’entreprise. Les scripts s’exécutent dans un bac à sable sécurisé, les étiquettes de confidentialité sur les fichiers de compétences sont conservées et honorées, et la gouvernance d’administration est disponible.

Matrice de prise en charge

Certaines limites diffèrent selon que vous ajoutez la compétence avec Agent Builder ou Agents Toolkit.

Le tableau suivant décrit ces deux chemins de création, et non les limites WIQD ou la couverture des fonctionnalités. Pour la voie pro-code recommandée, confirmez les exigences actuelles dans la documentation WIQD.

Élément Générateur d’agent Boîte à outils des agents
Nombre maximal de compétences par agent 8 8
Pack de compétences Compressé .zip, maximum 50 Mo Répertoire des compétences ; .zip n’est pas pris en charge
Taille maximale du fichier 25 Mo par fichier Aucune limite de niveau de compétence ; le package complet de l’application est limité à 10 Mo
Nombre maximal de fichiers par package 350 fichiers pour toutes les compétences 350 fichiers pour toutes les compétences
Créer une compétence à partir de téléchargements individuels Non pris en charge ; Chargez la version complète .zip Ajouter ou importer le répertoire de compétences complet
Hiérarchie de répertoire La profondeur de répertoire maximale est de 3 La profondeur de répertoire maximale est de 3
Réutilisation entre les agents Non pris en charge Non pris en charge

Types de fichiers et de scripts pris en charge

Une compétence peut inclure les types de fichiers suivants :

Catégorie Types de fichiers
Instructions et fichiers de ressources .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Scripts et fichiers binaires .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Bac à sable d’exécution de script

Les scripts de compétences s’exécutent dans un bac à sable sécurisé avec les limites suivantes :

Fonctionnalité Support
Accès Internet ou réseau à partir de scripts Non pris en charge. Le bac à sable ne dispose d’aucun accès réseau au moment de l’exécution.
Installation du package Non pris en charge. Une compétence ne peut pas installer de packages au moment de l’exécution.
Appels réseau authentifiés à partir de scripts Non pris en charge.
Packages préinstallés Une compétence peut utiliser des packages déjà présents dans le bac à sable. Ne dépendez pas d’un forfait à moins que sa disponibilité ne soit confirmée.
Connecteurs, plug-ins d’API et serveurs MCP L’agent peut utiliser des fonctionnalités activées via l’orchestrateur. Les scripts ne peuvent pas les appeler via le bac à sable.

Sensibilité et stockage

Élément Support
Étiquettes de confidentialité Le bac à sable conserve les étiquettes de confidentialité et respecte les stratégies d’étiquette. Il ne prend pas en charge les autorisations définies par l’utilisateur ni le chiffrement à double clé.
Stockage Le système stocke les fichiers de compétences chargés dans des conteneurs SharePoint Embedded à l’échelle du client.