Partager via

Implémenter une compétence à utiliser dans Power Virtual Agents

  • 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 seul bot orienté utilisateur 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 de l’assistant virtuel contiennent également un jeu de compétences prédéfinies que vous pouvez personnaliser et déployer au lieu de créer une compétence à partir de zéro.

Si vous pensez que votre compétence sera consommée à partir d'un bot Power Virtual Agents, des restrictions supplémentaires sont à prendre en compte.

Restrictions du manifeste

Power Virtual Agents impose certaines restrictions concernant les actions que vous pouvez déclarer dans votre manifeste de compétence.

  • Vous pouvez déclarer uniquement 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

Afin de garantir la conformité et une gouvernance adéquate des compétences personnalisées enregistrées pour être utilisées dans Power Virtual Agents, votre bot de compétences doit être une application enregistrée dans Microsoft Entra ID. Lors de l’ajout d’une compétence, nous vérifions si l’ID d’application de la compétence est le locataire de l’utilisateur connecté et que le point de terminaison de compétences correspond à l’URL Home Page URL de l’application inscrite.

Avant de pouvoir inscrire votre bot comme compétence dans Power Virtual Agents, vous devez vérifier que, pour le bot, la page d'accueil dans le portail Azure est définie sur l'URL du manifeste de compétence de ce 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 bot Power Virtual Agents, il doit d’abord importer la compétence dans Power Virtual Agents. Votre compétence passera par une série de contrôles de validation. Une défaillance de l’une de ces vérifications peut entraîner un message d’erreur, comme indiqué 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:// Entrez à nouveau 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 général 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 existe peut-être une erreur temporaire pour acquérir un jeton de sécurité et 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. Power Virtual Agents a reçu une réponse inconnue lors de l'envoi d'une activité EndOfConversation à 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 mis votre bot sur la liste d'autorisation. Vérifiez si votre bot a été ajouté à la liste d'autorisation de votre compétence. Pour plus d'informations, consultez comment Configurer une compétence avec Power Virtual Agents.