Ajouter des compétences à votre agent déclaratif dans Agent Builder

Une compétence est un composant modulaire et réutilisable que vous ajoutez à un agent déclaratif pour l’aider à effectuer une tâche empaquetée spécifique. Une compétence est un répertoire qui contient un fichier requis SKILL.md avec des instructions, ainsi que des fichiers de ressources et des scripts facultatifs. Cet article explique comment ajouter une compétence à un agent créé dans Agent Builder, soit en décrivant la compétence en langage naturel, soit en téléchargeant un package de compétences.

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.

Pour une compétence personnelle utilisée directement dans le Copilot Chat sans agent, consultez Créer des compétences pour le Copilot Chat. Les étapes de chargement et les limites décrites dans cet article s’appliquent à Agent Builder, et non aux téléchargements de Chat personnel.

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.

Configuration requise

  • Un abonnement Microsoft 365 éligible qui donne accès à Microsoft 365 Copilot Chat. Une licence de module complémentaire Microsoft 365 Copilot n’est pas requise. Certaines fonctionnalités d’agent nécessitent une licence Microsoft 365 Copilot ou le paiement à l’utilisation. Pour plus d’informations, consultez Fonctionnalités des agents et modèles de licence.

Remarque

Dans Agent Builder, vous pouvez ajouter jusqu’à huit compétences par agent, et chaque package de compétences est un fichier compressé .zip de 50 Mo maximum. Pour la matrice de prise en charge complète et les limites, voir Compétences dans les agents déclaratifs.

Créer une compétence à partir d’une description

Vous pouvez demander à Agent Builder de créer une compétence réutilisable à partir d’une description en langage naturel.

  1. Dans la conversation Copilot, sélectionnez Agents & Compétences, puis sélectionnez Nouvel agent.

  2. Sélectionnez la zone de texte Message Agent Builder et demandez à Agent Builder de créer un workflow réutilisable.

    Create an agent that helps my team write release notes. Add a reusable skill that always follows the same steps:
    
    1. Takes a list of merged changes (a pasted list or an uploaded  .csv  of PR titles).
    2. Groups them into Features, Fixes, and Other.
    3. Runs a script to format them into a clean Markdown changelog with a version heading and today's date.
    
    Package this as a skill with clear instructions and the formatting script so the output looks the same every time.
    

    Capture d’écran de l’invite du générateur d’agent pour créer un agent

  3. Sous l’onglet Configurer , vérifiez qu’une compétence a été créée.

    Capture d’écran de l’onglet Configurer dans le générateur d’agent montrant une compétence attachée

  4. Sélectionnez la compétence pour examiner ses détails.

    Capture d’écran des détails de la compétence nouvellement ajoutée

Si la compétence n’est pas ajoutée, vous pouvez explicitement ajouter des compétences en téléchargeant un package de compétences.

Télécharger un package de compétences

Pour ajouter un package de compétences, commencez par créer le package, puis téléchargez-le dans Agent Builder.

Créer votre package de compétences

Avant d’ajouter une compétence dans Agent Builder, empaquetez-la sous la forme d’un .zip fichier contenant :

  • Un fichier obligatoire SKILL.md .
  • Nom et description de la compétence dans la SKILL.md page liminaire YAML.
  • Fichiers de ressources facultatifs pris en charge.
  • Scripts facultatifs pris en charge et dossiers de prise en charge.
  • Instructions de compétence de moins de 20 000 caractères.

Votre package ressemble à la structure de répertoire suivante :

my-skill.zip
|-- SKILL.md              # required
|-- <resource files>      # optional
`-- <scripts or folders>  # optional

Pour connaître les types de fichiers et de scripts pris en charge, consultez Types de fichiers et de scripts pris en charge.

Important

Téléchargez le package complet .zip . Ne chargez SKILL.md pas tout seul.

Télécharger votre package de compétences

  1. Ouvrez ou créez un agent déclaratif dans Agent Builder.

  2. Sous l’onglet Configurer , développez Compétences, puis sélectionnez Ajouter.

    Capture d’écran du bouton Ajouter dans la section Compétences du volet de configuration d’Agent Builder

  3. Téléchargez le package de compétences complet .zip .

  4. Passez en revue le nom de la compétence, la description, les instructions et les fichiers inclus.

  5. Sous l’onglet Essayer , essayez une invite qui doit utiliser la compétence.