Partager via

Configurer une compétence à utiliser dans les assistants Copilot Studio

Copilot Studio vous permet de développer votre assistant avec des compétences. Si vous avez déjà créé et déployé des assistants dans votre organisation (à l’aide de Microsoft 365 Agents SDK ou autres outils pro-code) pour des scénarios spécifiques, vous pouvez convertir ces bots en compétence et enregistrer cette compétence dans un assistant Copilot Studio.

Note

Pour ajouter une compétence depuis l’application Copilot Studio dans Microsoft Teams, vous devez avoir un abonnement autonome Microsoft Copilot Studio.

Cet article est destiné aux administrateurs système ou aux professionnels de l’informatique qui connaissent bien les compétences .

Une fois que vous avez inscrit une compétence auprès d’un assistant Copilot Studio, vous pouvez déclencher en toute transparence des actions de compétence dans la conversation.

Prérequis

Important

Les assistants Copilot Studio prennent uniquement en charge les compétences créées à l’aide de Bot Framework SDK hérité version 4.12.0+ et Microsoft 365 Agents SDK v1.0.0+. De nouvelles compétences doivent être créées à l’aide de Microsoft 365 Agents SDK.

Pour configurer une fonctionnalité, vous devez configurer l’enregistrement d’application associé dans Microsoft Entra ID pour que votre fonctionnalité soit en configuration monolocataire.

Quand utiliser des flux d’assistant et des compétences

Le tableau suivant vous aide à déterminer quand utiliser les flux d’assistant ou les compétences pour une conversation.

Facteur Quand utiliser des flux d’assistant Dans quel cas utiliser des compétences
Personnage Les créateurs d’assistant peuvent créer des flux réutilisables à intégrer dans n’importe quelle conversation de l’assistant. Les développeurs peuvent créer, déployer et héberger des compétences personnalisées dans leur propre environnement.
Type de conversation Utilisez des flux pour les opérations simples à un seul tour. Par exemple, passer une commande ou obtenir le statut de la commande. Utilisez des compétences pour les opérations complexes à plusieurs tours. Par exemple, planifier une réunion ou réserver un vol.
Réponse Utilisez des flux pour émettre une réponse de l’assistant. Par exemple, afficher un message personnalisé ou des images en ligne. Utilisez les compétences pour émettre n’importe quelle réponse de l’agent prise en charge. Par exemple, afficher une carte adaptative ou envoyer des réponses aléatoires.
Actions Utilisez des flux pour déclencher des actions à un seul tour côté serveur. Par exemple, appeler une API HTTP ou déclencher un connecteur personnalisé. Utilisez des compétences pour déclencher des événements et des actions côté serveur et côté client. Par exemple, accédez à une page après la réponse de l’agent.

Configurer une compétence

Tout d’abord, utilisez Copilot Studio pour créer un assistant et créer et déployer une compétence avec des outils pro-code dans votre organisation. Reportez-vous à ces exemples :

Avant d’enregistrer la compétence, fournissez l’ID de l’agent à votre développeur de compétences pour autoriser l’agent à appeler des actions dans la compétence. En savoir plus sur la liste d’autorisation des compétences. Vous pouvez obtenir l’ID de votre agent à partir de la fenêtre Ajouter une compétence.

Pour ajouter une compétence à votre agent :

  1. Accédez à votre assistant.

  2. Sélectionnez Paramètres>Compétences pour accéder à la page des compétences.

  3. Sélectionnez Ajouter une compétence.

  4. Copiez votre identifiant d’assistant. Vous devez fournir l’identifiant d’assistant à votre développeur de compétences.

  5. Saisissez l’URL du manifeste de compétence. Le manifeste d’une compétence contient les informations dont votre assistant a besoin pour déclencher des actions au sein d’une compétence.

  6. Sélectionnez Suivant pour démarrer le processus de validation. Une fois la validation réussie, votre compétence est ajoutée à votre assistant. Vous pouvez maintenant utiliser cette compétence dans vos rubriques.

Considérations relatives à la conformité

Pour protéger la confidentialité des utilisateurs, nous exigeons que les compétences soient enregistrées en tant qu’application dans le locataire de l’utilisateur Microsoft Entra ID connecté.

Résoudre les erreurs lors de l’enregistrement des compétences

Une série de vérifications de validation est effectuée par rapport à l’URL. Ces vérifications garantissent la conformité, la gouvernance et la facilité d’utilisation de la compétence ajoutée à votre agent. Vous devez corriger ces erreurs avant d’enregistrer une compétence.

Message d’erreur Résolution des problèmes/atténuation
Nous avons rencontré des problèmes lors de l’obtention du manifeste de compétence.
(MANIFEST_FETCH_FAILED)		 Essayez d’ouvrir l’URL de votre manifeste dans un navigateur Web. Si l’URL affiche la page dans les 10 secondes, réenregistrez votre compétence.
Le manifeste est incompatible.
(MANIFEST_MALFORMED)		 (a) Vérifiez si le manifeste est un fichier JSON valide.
(b) Vérifiez si le manifeste contient les propriétés requises
Par exemple, (name, msaAppId, endpoint unique, activities/id, activities/descriptionactivities/type (seul event ou message est pris en charge)).
Vos points de terminaisons présentent une discordance.
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Vérifiez si le point de terminaison de votre compétence correspond au Publisher domain de votre inscription d’application Microsoft Entra ID (préféré) ou au champ Home page URL. En savoir plus sur la configuration de la page d’accueil des points de terminaison.
Pour ajouter une compétence, elle doit d’abord être enregistrée
(APPID_NOT_IN_TENANT)		 Vérifiez si l’ID d’application de votre compétence est enregistré dans le client Microsoft Entra ID de votre organisation.
Le lien n’est pas valide ; le lien doit commencer par https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Modifiez le lien pour ajouter une URL sécurisée.
Le manifeste est trop volumineux ;
(MANIFEST_TOO_LARGE)		 Vérifiez la taille du manifeste. Elle doit être inférieure ou égale à 500 Ko.
Cette compétence a déjà été ajoutée à votre agent.
(MANIFEST_ALREADY_IMPORTED)		 Supprimez la compétence et réessayez de l’enregistrer à nouveau.
La compétence est limitée à 100 actions.
(LIMITS_TOO_MANY_ACTIONS)		 Trop d’actions de compétence sont définies dans le manifeste de compétence. Supprimez des actions et réessayez.
Les actions sont limitées à 25 entrées.
(LIMITS_TOO_MANY_INPUTS)		 Il y a trop de paramètres d’entrée des actions de compétence. Supprimez des paramètres et réessayez.
Les actions sont limitées à 25 sorties.
(LIMITS_TOO_MANY_OUTPUTS)		 Il y a trop de paramètres de sortie des actions de compétence. Supprimez des paramètres et réessayez.
Votre agent peut avoir un maximum de 100 compétences.
(LIMITS_TOO_MANY_SKILLS)		 Trop de compétences ont été ajoutées à un assistant. Supprimez une compétence existante et réessayez.
Il semble qu’un problème soit survenu.
(AADERROR_OTHER)		 Une erreur transitoire s’est produite lors de la validation de votre compétence. Réessayez.
Un problème s’est produit lors de la vérification de votre compétence.
(ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)		 Vérifiez si le point de terminaison de votre compétence est en ligne et répond aux messages. Vérifiez également que l’enregistrement d’application de la compétence à locataire unique a été déployée sur le même locataire.
Cette compétence n’a pas inclus votre agent à la liste d’autorisation
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Vérifiez si votre assistant a été ajouté à la liste d’autorisation de compétence.
  • Last updated on