Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Conseil
Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.
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 un composant modulaire que vous ajoutez à un agent déclaratif pour empaqueter des instructions, des ressources et des scripts pour une tâche spécifique. Lors de la génération ou de la réutilisation, utilisez cet article lorsque le projet que vous avez choisi utilise déjà Microsoft 365 Agents Toolkit (ATK). Vous terminez avec une compétence inscrite dans l’agent, des instructions de tâche enregistrées et une version de test configurée.
Pour un nouveau projet de plug-in de développeur professionnel, commencez avec les outils de développement Work IQ et un environnement documenté. Conservez cette procédure Toolkit lorsque ses contrôles de projet correspondent à la route d’agent sélectionnée ; Ce n’est pas une exigence pour tous les plugins.
Pour découvrir ce que sont les compétences, pourquoi les utiliser, ainsi que la matrice de prise en charge complète, les types de fichiers pris en charge, le comportement du bac à sable et la gouvernance, consultez Compétences dans les agents déclaratifs.
Ce guide ajoute des compétences définies à l’échelle d’un agent. Pour distribuer une compétence à utiliser directement dans le Copilot Chat via un plug-in, consultez Créer des compétences pour le Copilot Chat.
Important
Ce guide suppose que vous avez terminé le tutoriel Créer des agents déclaratifs à l’aide de Microsoft 365 Agents Toolkit et du tutoriel JSON . L’ajout d’une compétence nécessite la version 1.9 du manifeste d’agent déclaratif. Si vous utilisez un agent créé avec une ancienne version d’Agents Toolkit, vous devrez peut-être mettre à jour la version de votre manifeste d’agent. Pour plus d’informations, consultez Référence du manifeste de l’agent déclaratif.
Configuration requise
Activer les compétences d’agent
La prise en charge des compétences des agents est contrôlée par la variable d’environnement TEAMSFX_AGENT_SKILLS . Définissez-la avant de lancer l’interface de ligne de commande ou le Visual Studio Code.
Windows (PowerShell) : pour conserver la variable entre les sessions, ajoutez-la à vos variables d’environnement utilisateur :
[System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")macOS ou Linux - Définissez la variable :
export TEAMSFX_AGENT_SKILLS=truePour conserver la variable, ajoutez la
exportligne à votre~/.bashrcprofil de shell ,~/.zshrcou équivalent.
Si vous avez défini la variable après avoir installé l’extension de Visual Studio Code, redémarrez complètement Visual Studio Code.
Vérifiez : Le processus de l’outil redémarré voit TEAMSFX_AGENT_SKILLS défini sur true. Un paramètre Windows de niveau utilisateur ne modifie pas un processus qui était déjà en cours d’exécution.
Ajouter une compétence à votre agent
Dans votre projet existant, ajoutez une compétence. Pour créer une compétence, fournissez un nom et une description :
atk add skill --name skill-name --description descriptionPour ajouter un dossier de compétences existant, utilisez l’option
--from:atk add skill --from PATH_TO_SKILLVérifiez : Le projet contient le répertoire de compétences et
SKILL.md, et le manifeste de l’agent déclaratif fait référence à cette compétence. Suivez la matrice de soutien ; Cette option d’importation n’établit pas la réutilisation entre les agents.Modifiez les compétences à l’aide des instructions de tâche, des ressources et des
SKILL.mdscripts pris en charge.Vérifiez : Le fichier enregistré conserve ses métadonnées requises et décrit la tâche, la sortie attendue et les limites.
Provisionnez l’agent déclaratif pour le rendre disponible dans votre environnement :
atk provision --env localVérifiez : L’approvisionnement réussit pour le locataire et l’environnement prévus. Testez la tâche de la compétence dans l’agent prévu ; La réussite de l’approvisionnement n’établit pas le comportement de l’exécution.
Limite
Dans Agents Toolkit, vous ajoutez une compétence en tant que répertoire (vous ne pouvez pas utiliser .zip), et le package complet de l’application est limité à 10 Mo. Vous pouvez ajouter jusqu’à huit compétences par agent, avec une profondeur de répertoire maximale de trois et jusqu’à 350 fichiers pour toutes les compétences. Pour la matrice de support complète, voir Compétences dans les agents déclaratifs.
Publier votre agent
Les éditeurs de logiciels indépendants (ISV) peuvent soumettre des agents déclaratifs qui incluent des compétences à Microsoft Marketplace. Utilisez les outils de développement Work IQ pour valider et générer le package soumettable à partir d’un projet d’agent déclaratif existant. Pour les packages de plug-in, wiqd publish pc vous pouvez créer l’offre Espace partenaires, remplir la liste des brouillons, charger le package et les images, soumettre pour certification avec une autorisation distincte et suivre le status. L’inscription et la vérification du compte Espace partenaires restent les étapes du portail, et Microsoft contrôle la certification et la publication.
Suivez Publier dans l’Espace partenaires avec WIQD pour les conditions préalables, la validation du package, la configuration du listes, l’envoi et le suivi du status. La soumission au portail reste une alternative ; consultez le guide de soumission de Microsoft Marketplace. Suivez la voie d’envoi confirmée de l’agent, et non un exemple de complément Office ou un type d’offre supposé pour les plug-ins composés.
Étape suivante
Entrez le package & testez avec Intégrer et tester vos composants. Lorsque l’agent est prêt à être distribué publiquement, continuez à publier via la Place de marché Microsoft.