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.
Si vous avez une tâche renouvelable et une expérience Microsoft cible, utilisez cet article pour décider de créer une compétence ou d’adapter le contenu existant. Ensuite, choisissez les étapes de création du produit. Vous êtes en Build ou en réutilisation. Votre résultat est une implémentation de compétences avec ses dépendances et ses preuves de test, prête à être intégrée avant le test Package &.
Réutiliser ou étendre une compétence
Pour les agents déclaratifs, Agent Builder et Agents Toolkit ne prennent pas en charge la réutilisation entre les agents. Suivre la matrice de support dans Compétences en agents déclaratifs ; Ne présumez pas qu’une compétence attachée à un agent peut être partagée avec un autre.
Avant de créer une compétence :
- Passer en revue les compétences approuvées qui effectuent déjà le travail requis.
- Vérifiez que l’agent cible ou l’expérience Microsoft prend en charge le format et les fonctionnalités des compétences.
- Passez en revue ses instructions, ressources, scripts, outils et accès aux données.
- Vérifiez les limites de réutilisation documentées de l’expérience cible avant d’adapter le contenu de compétences existant.
- Confirmez les attentes en matière de propriété, de contrôle de version, de partage, de prise en charge et de mise à jour.
- Testez la compétence avec des entrées représentatives et des sorties attendues.
Créez une nouvelle compétence lorsqu’aucune compétence approuvée existante ne répond à l’exigence ou que l’expérience cible ne prend pas en charge la réutilisation.
Choisir le chemin d’implémentation
Commencez avec les outils de développement Work IQ pour le développement professionnel. Choisissez l’itinéraire de votre expérience cible et le type de projet ; Un format partagé SKILL.md n’établit pas la réutilisation entre agents ou l’éligibilité à la publication.
| Approche de développement | Artefact et étendue de la compétence | Commencer par |
|---|---|---|
| Outils de développement Work IQ | Un dossier de compétences de niveau supérieur dans un plug-in autonome ou une compétence ajoutée à un projet d’agent déclaratif existant. Il s’agit d’itinéraires de création distincts. | Créez un plug-in avec les outils de développement Work IQ et les détails de l’itinéraire ci-dessous |
| Création de compétences Copilot Chat et distribution de plug-ins | Suivez les instructions de création et de distribution spécifiques au produit. | Développer des compétences pour le Copilot Chat |
| Générateur d’agent | Un zip de compétence complet chargé sur un agent déclaratif, ou une compétence créée à partir d’une description dans Agent Builder. | Ajouter des compétences avec Agent Builder |
| Microsoft 365 Agents Toolkit | Répertoire de compétences ajouté à un projet d’agent déclaratif existant, pas un code postal de compétences autonome. | Ajouter des compétences avec Agents Toolkit |
| Copilot Cowork | Dossiers de compétences enregistrés dans un package d’application Microsoft 365. Utilisez les exigences et les limites du package Cowork. | Générer des plugins pour Copilot Cowork |
Faire correspondre l’artefact à sa voie de publication
Suivez les instructions de publication applicables à votre artefact :
- Plug-in WIQD autonome :partagez avec les utilisateurs sélectionnés ou envoyez-le au catalogue de votre organisation. Le partage n’est pas la publication d’un catalogue.
- Package Copilot Cowork : suivez Publier sur votre client.
- Agent déclaratif avec des compétences : Suivez Publier votre agent pour l’envoi sur la Place de marché Microsoft.
La prise en charge d’un artefact n’établit pas l’éligibilité à la publication pour chaque package de plug-in. La publication ne termine pas la configuration de l’accès, du consentement ou de la connexion de l’utilisateur.
GitHub Copilot peut vous aider avec des instructions de compétence, des scripts de prise en charge, des ressources, des tests et des modifications de référentiel. L’expérience cible et l’outil de création déterminent le format et le temps d’exécution de la compétence pris en charge.
Outils de développement Work IQ
WIQD propose deux voies différentes de création de compétences.
-
wiqd plugin add skillAjoute une compétence de haut niveau à un projet de plug-in autonome. Le plug-in peut être de compétence uniquement ou combiner la compétence avec des agents pris en charge ou des connecteurs MCP distants. Confirmez séparément le support du produit cible. -
wiqd agent add skillAjoute une compétence à un projet d’agent déclaratif existant. Cet itinéraire utilise l’indicateur deagent-skillsfonctionnalité, qui est désactivé par défaut.
Les deux voies créent une capacité basée sur la base, mais elles fonctionnent sur des SKILL.mdtypes de projets différents. Dans le format du plug-in WIQD, le nom de la compétence doit correspondre au nom de son dossier et sa description doit inclure les expressions qui l’activent. Voir Qu’est-ce qu’un plug-in ? et la référence de création du plug-in.
La validation de code source WIQD (wiqd plugin validate --mode source) n’inspecte pas le contenu des compétences. Après l’empaquetage, exécutez wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" avec le chemin ZIP réel. La validation de package charge une copie capturée de ce code zip vers le service de validation Microsoft 365 et peut nécessiter une authentification. Examiner les résultats retournés ; Une réussite n’établit pas le comportement d’exécution. Voir Validation et MVL.
Mettre en œuvre la compétence
Effectuez les travaux applicables :
- Définissez le travail, les entrées, les sorties attendues, les limites et les critères de réussite.
- Créez ou importez les instructions de compétence.
- Ajoutez les ressources et les scripts de prise en charge requis.
- Configurez n’importe quel outil requis, serveur MCP distant, API, identité, autorisation ou dépendance de données.
- Confirmez les types de fichiers, les types de script, le comportement du bac à sable, le stockage et les exigences de confidentialité pris en charge.
- Testez les scénarios attendus, ambigus, non pris en charge et d’échec.
- Enregistrez la version de la compétence, le propriétaire, les dépendances, les limitations connues et le processus de support.
Pour les compétences utilisées directement dans Copilot Chat, consultez Créer des compétences pour Copilot Chat. Pour connaître la prise en charge actuelle et les contraintes d’exécution dans les agents déclaratifs, consultez Compétences dans les agents déclaratifs. Pour Copilot Cowork, voir Limites des fichiers associés. Appliquer les exigences de chaque hôte cible lorsque vous distribuez une compétence à plusieurs expériences.
Confirmer que la compétence est opérationnelle
La compétence est prête pour l’intégration lorsque :
- L’agent ou l’expérience cible peut le charger et l’utiliser.
- Ses instructions exécutent le travail défini de manière cohérente.
- Les ressources, scripts, outils et données nécessaires sont disponibles.
- Les autorisations et les dépendances externes fonctionnent dans l’environnement de développement ou de test.
- Les opérations non prises en charge ou ayant échoué produisent un comportement compréhensible.
- La propriété, le contrôle de version, les limitations et les preuves de test sont enregistrés.
Continuez avec tous les autres éléments du plan. Lorsqu’ils sont terminés, intégrez et testez vos composants, puis passez à Package & test pour créer le package du plugin.