Développer des compétences pour Microsoft 365 Copilot Chat

Les compétences dans Microsoft 365 Copilot Chat sont généralement disponibles. Une compétence regroupe des instructions spécifiques aux tâches, des critères de qualité et des fichiers ou scripts de prise en charge facultatifs afin que les utilisateurs n’aient pas besoin de répéter le même flux de travail dans chaque conversation.

Vous pouvez créer une compétence à utiliser directement dans Copilot Chat sans créer d’agent déclaratif. Les utilisateurs peuvent sélectionner explicitement une compétence installée ou laisser Copilot la sélectionner automatiquement lorsqu’elle est pertinente. Les utilisateurs contrôlent l’appel automatique pour chaque compétence.

Important

Chez les clients qui utilisent Cloisonnement de l’information Microsoft Purview (IB), les compétences ne sont pas prises en charge dans Copilot Chat. Cette restriction s’applique aux compétences personnelles et aux compétences distribuées dans le cadre d’un plug-in.

Choisir l’étendue de la compétence

Target Chemin de création et de distribution
Une compétence personnelle utilisée directement dans Copilot Chat Créez un fichier autonome SKILL.md ou un fichier ZIP de compétence. Les utilisateurs peuvent également créer et modifier des compétences personnelles avec Copilot Chat.
Une compétence distribuée dans le cadre d’un plugin Utilisez les outils de développement Work IQ pour créer un package d’application Microsoft 365, puis utilisez une méthode de partage ou de publication prise en charge.

Créer une compétence personnelle

Conseil

Si vous envisagez de packager votre compétence sous forme de plugin, suivez plutôt les étapes de la section Packager une compétence dans un plugin . Les outils de développement Work IQ automatisent la plupart des étapes de cette section.

Chaque compétence nécessite un fichier nommé SKILL.md. Ajoutez des ressources et des scripts facultatifs uniquement lorsque la tâche en a besoin.

release-notes/
|-- SKILL.md
|-- references/
|   `-- release-note-format.md
`-- scripts/
    `-- format_release_notes.py

Commencez par SKILL.md une page liminaire YAML contenant un nom et une description. Pour les compétences de plug-in WIQD, le nom doit correspondre exactement au dossier contenant. Utilisez des caractères alphanumériques minuscules et des traits d’union de 1 à 64, sans trait d’union de début, de fin ou consécutif. La description peut contenir de 1 à 1 024 caractères et doit identifier les demandes qui activent la compétence.

Par exemple :

---
name: release-notes
description: Draft release notes or a changelog from a supplied list of changes, grouped into Features, Fixes, and Other.
---

# Release notes

Use this skill when the user asks for release notes or a changelog.

1. Use the change list supplied by the user. If it is missing, ask for it.
2. Group the changes into Features, Fixes, and Other.
3. Use references/release-note-format.md for the output structure.
4. Preserve issue and pull request links from the supplied input.
5. Don't invent changes, links, version numbers, or release dates.
6. Return the draft and identify any missing information.

Inclure chaque fichier la référence des instructions. Par exemple, si vous ajoutez un script de mise en forme, expliquez quand l’exécuter, quelles entrées il accepte et comment gérer les échecs. Conservez les informations d’identification, les jetons et les secrets en dehors de la compétence.

Instructions de conception

Garder la compétence concentrée

  • Donnez à la compétence une tâche définie, avec des entrées, des sorties et des limites claires.
  • Incluez dans la description les expressions que les utilisateurs sont susceptibles d’utiliser pour ce travail.
  • Conservez SKILL.md moins de 20 000 caractères comme recommandation de création. Déplacez des documents de référence détaillés dans des dossiers de soutien et expliquez quand les lire.
  • Conservez le répertoire superficiel et n’incluez que les fichiers nécessaires à la tâche. Confirmez le nombre de fichiers, la profondeur de répertoire et les limites de taille de package pour chaque hôte cible.

Ajouter des ressources et des scripts pris en charge

Utilisez les types de fichiers pris en charge par le runtime de la compétence de conversation :

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

Les compétences de conversation et les compétences attachées à un agent ont des chemins de chargement distincts. N’appliquez pas les limites d’Agent Builder et d’Agents Toolkit à un téléchargement personnel de la compétence de conversation.

Respecter la limite du script Runtime

Scripts de compétences :

  • Impossible d’accéder à Internet ou au réseau au moment de l’exécution.
  • Impossible d’installer des packages au moment de l’exécution.
  • Peut utiliser uniquement les packages déjà disponibles dans le runtime.
  • Impossible d’effectuer des appels réseau authentifiés.

Lorsqu’une tâche nécessite des données ou des actions externes, faites en sorte que Copilot appelle un connecteur activé ou une autre fonctionnalité externe prise en charge. Ne placez pas les appels réseau dans un script de compétences comme substitut.

Pour un plug-in qui inclut un connecteur MCP à distance, utilisez la configuration du agentConnectors manifeste de l’application. Dans les instructions de compétence, expliquez quand et pourquoi Copilot doit utiliser le connecteur. La configuration de la connexion et les autorisations utilisateur restent distinctes des instructions de compétence.

Compte pour la protection des données

Les fichiers de compétences de conversation chargés sont stockés dans des conteneurs SharePoint Embedded à l’échelle du client. Les étiquettes de confidentialité sont conservées et les stratégies d’étiquette sont honorées. Les autorisations définies par l’utilisateur et le chiffrement à double clé ne sont pas pris en charge.

Comparez les instructions, les ressources, les scripts, l’accès aux données et les résultats par rapport aux exigences de votre organisation. Utilisez les données, la confidentialité et la sécurité du Plan pour la solution globale.

Charger la compétence

Pour un téléchargement direct de compétence, fournissez SKILL.md seul ou un ZIP avec SKILL.md à la racine et tous les fichiers de prise en charge en dessous. N’incluez pas un répertoire englobant supplémentaire ci-dessus SKILL.md dans le ZIP.

  1. Dans Copilot Chat, sélectionnez Agents>,plus d’agents. Sélectionnez la liste déroulante à côté d’Ajouter, puis sélectionnez Télécharger une compétence.

    Capture d’écran de l’emplacement du bouton Télécharger la compétence dans Copilot Chat

  2. Ajoutez votre fichier SKILL.md ou ZIP et sélectionnez Télécharger.

Empaqueter une compétence dans un plug-in

Work IQ Dev Tools fournit un flux de travail pro-code pour la création, la validation, la mise en service, l’empaquetage et le partage d’un plug-in basé sur les compétences.

  1. Suivez les prérequis d’installation et d’authentification WIQD dans Créer un plug-in.

  2. Créez un projet de plug-in et ajoutez une compétence :

    wiqd plugin create --name release-notes-plugin
    Set-Location release-notes-plugin
    wiqd plugin add skill --name "Release Notes"
    
  3. Modifiez le fichier généré appPackage/skills/release-notes/SKILL.mdet ajoutez toutes les ressources ou scripts référencés, en suivant les instructions de conception.

  4. Suivez le workflow WIQD pour configurer l’environnement prévu, empaqueter le plug-in et valider le code zip créé réellement. La validation à la source seule n’inspecte pas le contenu des compétences ou ne prouve pas le comportement d’exécution.

  5. Publiez ou partagez le plug-in et mettez-le à la disposition des utilisateurs prévus.

Remarque

Le manifeste de l’application Microsoft 365 enregistre les compétences au niveau du plug-in par le biais agentSkillsde . Un agent déclaratif fait référence à ses compétences agent_skills définies par l’agent dans le manifeste de l’agent déclaratif. Ne modifiez pas ces propriétés ou ne supposez pas que le fait de déclarer une compétence sur une surface l’enregistre sur l’autre.

Pour connaître les règles de format, les détails du manifeste et les contraintes spécifiques à l’hôte, consultez la référence de création de plug-in WIQD. Une compétence destinée à la fois au Chat et au Cowork doit répondre aux exigences des deux hôtes.

Détection et appel de tests

Testez la compétence installée dans chaque expérience Microsoft 365 que vous souhaitez prendre en charge :

  1. Vérifiez qu’un utilisateur prévu peut trouver et sélectionner la compétence.
  2. Sélectionnez explicitement la compétence, fournissez une entrée représentative et vérifiez sa sortie et ses fichiers de prise en charge.
  3. Activez l’appel automatique et utilisez une demande qui correspond à la description de la compétence. Vérifiez que Copilot sélectionne la compétence prévue.
  4. Désactivez l’appel automatique et vérifiez que la compétence n’est pas sélectionnée automatiquement. La sélection explicite est un cas d’utilisation distinct.
  5. Testez les entrées manquantes, les demandes ambiguës, les outils indisponibles et les échecs de script. Assurez-vous que la réponse identifie le problème plutôt que de renvoyer silencieusement un résultat incomplet.
  6. Si le plug-in inclut d’autres fonctionnalités, testez-les ensemble. Vérifiez que le connecteur ou l’outil MCP prévu est effectivement appelé.
  7. Si vous prenez en charge Chat et Cowork, vérifiez la découverte, l’installation et l’exécution dans les deux. Ne déduisez pas la disponibilité ou la prise en charge de la modification d’un produit à partir d’un test réussi dans un autre.

La publication, le déploiement, le partage et l’installation sont des étapes distinctes. Vérifiez l’expérience installée pour le public prévu plutôt que de traiter un chargement de package réussi comme une preuve que la compétence est détectable.