Partager via

Implémenter une compétence à utiliser dans Copilot Studio

  • Article

S'APPLIQUE À : SDK v4

Une compétence est un bot qui peut être utilisé par un autre bot. De cette façon, vous pouvez créer un bot accessible à l’utilisateur unique et l’étendre avec une ou plusieurs compétences. Consultez la section Présentation des compétences pour plus d’informations sur les compétences en général, et la section Implémenter une compétence pour apprendre à les créer. Les modèles d’Assistant virtuel contiennent également un ensemble de compétences prédéfinies que vous pouvez personnaliser et déployer au lieu d’en créer un à partir de zéro.

Si vous vous attendez à ce que votre compétence soit consommée à partir d’un copilote Copilot Studio , il existe d’autres restrictions sur votre compétence dont vous devez tenir compte.

Restrictions du manifeste

Copilot Studio place des restrictions sur ce que vous pouvez déclarer dans votre manifeste de compétence.

  • Vous ne pouvez déclarer que 100 actions ou moins.
  • Chaque action est limitée à au moins 25 entrées ou sorties.
  • Vous ne pouvez pas utiliser le type de tableau pour les entrées ou les sorties.

Restriction de même locataire

Pour garantir la conformité et la gouvernance adéquate des compétences personnalisées inscrites pour une utilisation dans Copilot Studio, votre bot de compétences doit être une application inscrite dans l’ID Microsoft Entra. Lors de l’ajout d’une compétence, nous validons si l’ID d’application de la compétence se trouve dans le locataire de l’utilisateur connecté et que le point de terminaison de compétences correspond à l’application Home Page URLinscrite.

Avant de pouvoir inscrire votre bot en tant que compétence dans Copilot Studio, vous devez vous assurer que pour le bot, la page d’accueil de l’Portail Azure est définie sur l’URL du manifeste de compétence du bot.

Validation effectuée lors de l’inscription d’une compétence

Lorsqu’un utilisateur final tente de se connecter à votre compétence à partir de son copilote, il doit d’abord importer la compétence dans Copilot Studio. Votre compétence passe par une série de vérifications de validation. Une défaillance de l’une de ces vérifications peut entraîner un message d’erreur, comme décrit dans ce tableau.

Étape de validation Code d'erreur Message d’erreur Description ou atténuation des risques
L'URL du manifeste est valide URL_MALFORMED, URL_NOT_HTTPS Le lien n’est pas valide ; le lien doit commencer par https:// Réenter le lien en tant qu’URL sécurisée.
Le manifeste peut être récupéré MANIFEST_FETCH_FAILED Nous avons rencontré des problèmes lors de l’obtention du manifeste de compétence. Vérifiez que votre URL de manifeste est un lien vers votre manifeste. Essayez d'ouvrir votre URL de manifeste dans un navigateur web. Si l’URL affiche la page dans les 10 secondes, réenregistrez votre compétence.
Le manifeste est lisible MANIFEST_TOO_LARGE Le manifeste est trop volumineux. Votre manifeste doit être de 500 Ko ou moins.
Le manifeste est lisible MANIFEST_MALFORMED Le manifeste est incompatible. Vérifiez si le manifeste est un fichier JSON valide. Vérifiez si le manifeste contient les propriétés requises, comme name, msaAppId etc. Pour plus d'informations, consultez Restrictions du manifeste.
La compétence n'est pas encore inscrite MANIFEST_ALREADY_IMPORTED Cette compétence a déjà été ajoutée à votre bot. Supprimez la compétence et enregistrez-la à nouveau.
Le point de terminaison de manifeste et les domaines de page d'accueil correspondent MANIFEST_ENDPOINT_ORIGIN_MISMATCH Il existe une incohérence dans les points de terminaison de votre compétence. Le domaine de l'URL de la page d'accueil de l'application Microsoft Entra ID et le domaine de l'URL du manifeste doivent correspondre. Voir Restriction de même locataire
La compétence est hébergée dans le locataire de l'utilisateur connecté APPID_NOT_IN_TENANT Pour ajouter une compétence, vous devez d’abord l’inscrire. Un administrateur doit inscrire la compétence dans l’organisation de l’utilisateur connecté.
Les actions sont limitées LIMITS_TOO_MANY_ACTIONS La compétence est limitée à 100 actions. Trop d’actions de compétence sont définies dans le manifeste de compétence. Supprimez des actions et réessayez.
Les paramètres d'entrée d'action sont limités LIMITS_TOO_MANY_INPUTS Les actions sont limitées à 25 entrées. Il y a trop de paramètres d’entrée des actions de compétence. Supprimez des paramètres et réessayez.
Les paramètres de sortie d'action sont limités LIMITS_TOO_MANY_OUTPUTS Les actions sont limitées à 25 sorties. Il y a trop de paramètres de sortie des actions de compétence. Supprimez un paramètre et réessayez.
Le nombre de compétences est limité LIMITS_TOO_MANY_SKILLS Votre bot ne peut pas contenir plus de 25 caractères. Trop de compétences ont été ajoutées à un bot. Supprimez une compétence existante et réessayez.
Jeton de sécurité valide AADERROR_OTHER Un problème est survenu. Il peut y avoir une erreur temporaire pour acquérir un jeton de sécurité pour déclencher la compétence. Réessayez d'importer la compétence.
La compétence est saine ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Un problème s’est produit lors de la vérification de votre compétence. Copilot Studio a reçu une réponse inconnue lors de l’envoi d’une EndOfConversation activité à votre compétence. Vérifiez que votre compétence est en cours d’exécution et répond correctement.
La compétence est autorisée ENDPOINT_HEALTHCHECK_UNAUTHORIZED Cette compétence n’a pas listé votre bot. Vérifiez si votre bot est dans la liste verte de la compétence. Pour plus d’informations, consultez copilot Studio comment configurer une compétence.