Utiliser un chatbot classique comme compétence dans un bot Bot Framework

Note

Cet article contient des informations applicables uniquement aux Copilot Studio chatbots classiques. Cette fonctionnalité n’est pas disponible dans la nouvelle Copilot Studio expérience.

Lorsque vous utilisez un chatbot classique comme compétence avec un Bot Framework bot, le Bot Framework bot détermine si quelque chose que dit l’utilisateur correspond aux phrases suivre du chatbot classique. S’il y a correspondance, le Bot Framework bot transmet la conversation au chatbot classique. Le chatbot classique extrait toutes les entités et déclenche la correspondance rubrique.

Vous pouvez également passer une variable à un Copilot Studio compétence rubrique comme entrée depuis Bot Framework Composer et utiliser les sorties qu’il renvoie.

Important

Vous devez disposer d’une licence d’essai ou complète pour utiliser les chatbots classiques comme compétences. Copilot Studio Cette fonctionnalité n’est pas disponible avec la licence Teams Copilot Studio .

Pour configurer votre chatbot classique en tant que compétence :

1. Ajoutez le Bot Framework bot à la liste autorisée du chatbot classique.

2. Téléchargez le manifeste compétence pour le chatbot classique.

3. Utilisez le manifeste compétence téléchargé dans Bot Framework Composer pour créer une connexion entre les bots.

4. Utilisez l’émulateur pour confirmer que le bot fonctionne comme un compétence Bot Framework .

Conditions préalables

• Comprendre le fonctionnement des compétences Bot Framework.
• Comprendre comment utiliser Bot Framework Composer.
• Comprendre comment utiliser les compétences dans Bot Framework Composer.
• Obtenir l’ID d’application de votre bot Bot Framework.

Ajoutez votre Bot Framework bot à la liste d’autorisation de votre chatbot classique

Ajoutez l’ID d’application du bot à la liste blanche du chatbot classique que vous souhaitez utiliser comme compétence. Bot Framework. Les bots doivent être dans le même locataire.

1. Dans Bot Framework Composer, ouvrez le bot qui utilisera la compétence. Sélectionnez Configurer, puis Ressources de développement. Copiez l’ID dans ID d’application Microsoft.

2. Dans Copilot Studio, ouvrez le chatbot classique que vous souhaitez utiliser comme compétence.

3. Dans le menu de navigation, accédez à Paramètres et sélectionnez Sécurité. Sélectionnez ensuite Liste d’autorisation.

4. Sélectionnez Ajouter un appelant autorisé.

5. Collez l’ID d’application de votre bot Bot Framework et sélectionnez Suivant.

   Avertissement

   Un chatbot classique ne peut pas agir comme un compétence pour d’autres chatbots classiques. Si vous essayez d’ajouter un ID d’application qui appartient à un bot Power Virtual Agent à la liste d’autorisation, vous obtiendrez une erreur. Vous ne pouvez ajouter un ID d’application qu’à un bot Bot Framework.

   Copilot Studio valide l’ID d’application du bot et confirme qu’il appartient à un bot du même locataire. Bot Framework

6. (Facultatif) Ajoutez un Nom d’affichage pour le bot que vous avez ajouté à la liste d’autorisation.

7. Sélectionnez Enregistrer.

Le bot Bot Framework est affiché par son nom complet si vous en avez saisi un, ou par son ID d’application si vous n’avez pas saisi de nom complet. Pour le supprimer ou le modifier à tout moment, sélectionnez l’icône à droite du nom complet ou de l’ID d’application du bot.

Note

Les bots Bot Framework ajoutés à la liste d’autorisation ne sont pas exportés dans le cadre du contenu du bot.

Téléchargez le manifeste du chatbot classique compétence pour votre chatbot classique

Bot Framework les bots peuvent utiliser un Copilot Studio manifeste compétence pour configurer une connexion au chatbot classique qui a produit le manifeste.

Tous les chatbots classiques ont des manifestes compétence. Ce sont des fichiers JSON qui incluent le nom, l’interface et les phrases de déclenchement d’une compétence.

Un Bot Framework bot peut utiliser un manifeste compétence pour savoir quand #glsr_cfigieciz le chatbot classique (par exemple, en réponse à quelque chose qu’un utilisateur lui dit).

Copilot Studio Les manifestes compétence version 2.2 du Bot Framework schéma du manifeste compétence et se composent des fichiers intents.lu et manifest.json .

Un Bot Framework bot peut décider qu’un chatbot classique doit gérer la demande de l’utilisateur, en fonction des données du manifeste. Il transmet au chatbot classique tout ce que l’utilisateur a dit. Ensuite, le chatbot classique fait correspondre ce que l’utilisateur a dit à un Copilot Studio rubrique, extrait toutes entités nécessaires au remplissage des créneaux et déclenche le Copilot Studio rubrique.

Copilot Studio Les manifestes compétence sont automatiquement générés et mis à jour. Un chatbot classique possède deux manifestes compétence :

• Manifeste de test : permet au Bot Framework bot d’accéder à la version de test de votre chatbot classique. Utilisez le manifeste de test pour valider les modifications apportées à votre compétence avant de la publier.

  • Le manifeste de test est immédiatement disponible pour chaque chatbot classique nouvellement créé.
  • Il est automatiquement mis à jour pour refléter les modifications à chaque fois que vous enregistrez votre chatbot classique.

• Manifeste publié : permet au Bot Framework bot d’accéder à la version publiée de votre chatbot classique.

  • Le manifeste publié n’est disponible que pour les chatbots classiques qui ont été publiés au moins une fois.
  • Il est automatiquement mis à jour pour refléter les modifications chaque fois que vous publiez votre agent .

Note

Le manifeste publié n’est pas disponible pour les chatbots classiques qui n’ont jamais été publiés.

Pour générer le manifeste publié de votre bot, publiez votre chatbot classique.

Les deux manifestes de compétence se trouvent dans le volet Gérer la liste d’autorisations.

Les manifestes de compétences sont également affichés sur la page Détails du copilote. Dans le menu de navigation, sélectionnez Paramètres, puis Détails. La page Détails affiche d’autres métadonnées telles que ID d’environnement, ID du locataire et ID d’application du bot.

Pour télécharger un manifeste, sélectionnez-le. Il est téléchargé sous forme de fichier .zip intitulé _<nom du bot>manifest pour le manifeste publié, ou <nom du bot>test__manifest pour le manifeste de test.

Note

Le manifeste compétence n’inclut pas les rubriques système et les boîtes de dialogue Composer qui sont ajoutées à un chatbot classique. Seules les rubriques créées par les auteurs du copilote et les déclencheurs d’intention Composer ajoutés par les auteurs au bot sont incluses.

Connecter à un Copilot Studio compétence dans Composer

Utilisez Copilot Studio les manifestes compétence pour créer une connexion compétence dans votre Bot Framework bot dans Composer.

1. Dans un projet Bot Framework Composer, sélectionnez + Ajouter, puis Se connecter à une compétence.

2. Accédez à une archive manifeste .zip et Sélectionner, puis cliquez sur Sélectionner Copilot Studio Suivant .

3. Sélectionner les sujets, ou intentions, de votre chatbot classique que vous souhaitez ajouter à votre Bot Framework bot, puis Sélectionner Suivant.

4. Révisez et modifiez les phrases Gâchette pour votre chatbot classique, puis Sélectionner Suivant.

5. Veillez à ce que Utiliser Orchestrator pour les projets multi-bots est sélectionné, puis sélectionnez Continuer.

6. Vérifiez que le compétence est correctement ajouté à votre bot et qu’un nouveau Gâchette avec le nom de votre chatbot classique apparaît dans le projet dans Composer. Copilot Studio Bot Framework

Localiser la rubrique dans le manifeste des compétences

Utilisez un événement pour Gâchette un Copilot Studio rubrique dans le compétence. Pour appeler un sujet spécifique depuis Composer, reportez-vous au sujet par le nom de l’événement associé dans le manifeste de compétence.

1. Sélectionnez l’action Connecter à une compétence.

2. Sous Nom de la boîte de dialogue de compétence, sélectionnez Afficher le manifeste des compétences.

3. Recherchez des activités dans le manifeste. Cette propriété contient des propriétés imbriquées qui représentent les sujets disponibles dans votre chatbot classique.

4. Recherchez la rubrique que vous voulez appeler et recherchez sa propriété name. Lorsque le Copilot Studio compétence reçoit un événement avec ce nom, il déclenche le rubrique.

   Dans cet exemple, le nom de l’activité événementielle est dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Appelez le Copilot Studio compétence rubrique

Au lieu de vous fier à ce qu’un utilisateur dit à Gâchette a Copilot Studio compétence rubrique,, vous pouvez l’appeler directement. Vous ne pouvez appeler directement que les sujets répertoriés dans le manifeste compétence. Copilot Studio

1. Dans le canevas de création de Composer, sélectionnez Ajouter, puis sélectionnez Accéder aux ressources externes, puis sélectionnez Se connecter à une compétence.

2. Dans la liste Nom de la boîte de dialogue compétence , Sélectionner votre chatbot classique.

3. Recherchez le nom de l’activité événementielle pour le chatbot classique rubrique que vous souhaitez appeler. Copiez la valeur, en omettant les guillemets, et enregistrez-la pour l’utiliser dans les étapes suivantes.

4. Sélectionnez Fermer.

5. Dans la section Activité, sélectionnez Afficher le code.

6. Tapez ou collez le code suivant. Remplacez TOPIC_ACTIVITY_NAME par le nom de l’activité d’événement de votre sujet. Assurez-vous qu’il n’y a pas de guillemets dans la propriété name.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

Transmettez une variable d’entrée à un Copilot Studio compétence rubrique

Bot Framework Le compositeur peut transmettre une variable à un Copilot Studio compétence rubrique comme entrée. Pour savoir comment créer des rubriques qui acceptent des variables d’entrée, consultez Travailler avec des variables Copilot Studio . ...

Si un Copilot Studio rubrique pouvant recevoir une variable d’entrée est répertorié dans votre manifeste compétence, vous pouvez lui transmettre une variable Composer.

1. Dans le canevas de création de Composer, sélectionnez Ajouter, puis sélectionnez Accéder aux ressources externes, puis sélectionnez Se connecter à une compétence.

2. Dans la liste Nom de la boîte de dialogue compétence , Sélectionner votre chatbot classique.

3. Recherchez le nom de l’activité événementielle pour le chatbot classique rubrique que vous souhaitez appeler. Copiez la valeur, en omettant les guillemets, et enregistrez-la pour l’utiliser dans les étapes suivantes.

4. Recherchez la propriété value du sujet. La propriété value contient une propriété $ref. Copiez la valeur (sans guillemets) et enregistrez-la pour l’utiliser à l’étape suivante.

   Avertissement

   Si un Copilot Studio rubrique n’a pas d’entrées, il n’aura pas de propriété value .

5. Recherchez la propriété definitions, puis recherchez une propriété imbriquée qui correspond à la valeur $ref que vous avez trouvée à l’étape précédente. Notez les noms et les types des entrées de Copilot Studio rubrique. Vous les utiliserez dans les étapes suivantes.

6. Sélectionnez Fermer.

7. Sous la section Activité, sélectionnez Afficher le code.

8. Tapez ou collez le code suivant. Remplacez ces valeurs :

   1. Remplacez TOPIC_ACTIVITY_NAME par le nom de l’activité d’événement de votre sujet.
   2. Remplacez PVA_INPUT_VARIABLE par une variable d’entrée de votre sujet.
   3. Remplacez COMPOSER_INPUT_VARIABLE par une variable Composer qui fournira une valeur.

   [Activity
       Type = event
       Name = TOPIC_ACTIVITY_NAME
       Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
   ]
   

   Dans cet exemple, la variable Composer dialog.storeLocation fournit une valeur à la variable d’entrée pva_StoreLocation dans le chatbot classique rubrique dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Recevoir une variable de sortie d’un Copilot Studio compétence rubrique

Il est possible de recevoir des sorties d’un Copilot Studio compétence rubrique dans Composer. Pour savoir comment créer des Copilot Studio rubriques qui renvoient des sorties, consultez Travailler avec des variables.

1. Dans le canevas de création de Composer, sélectionnez Ajouter, puis sélectionnez Accéder aux ressources externes, puis sélectionnez Se connecter à une compétence.

2. Dans la liste Nom de la boîte de dialogue compétence , Sélectionner votre chatbot classique.

3. Recherchez le nom de l’activité événementielle de votre chatbot classique rubrique que vous souhaitez appeler. Copiez la valeur, en omettant les guillemets, et enregistrez-la pour l’utiliser dans les étapes suivantes.

4. Recherchez la propriété resultValue du sujet. La propriété resultValue contiendra une propriété $ref. Copiez la valeur (sans guillemets) et enregistrez-la pour l’utiliser à l’étape suivante.

   Avertissement

   Si un Copilot Studio rubrique n’a pas de sorties, il n’aura pas de propriété resultValue .

5. Recherchez la propriété definitions, puis recherchez une propriété imbriquée qui correspond à la valeur $ref que vous avez trouvée à l’étape précédente. Notez les noms et les types des variables de sortie de Copilot Studio rubrique. Vous les utiliserez dans les étapes suivantes.

   Dans cet exemple, Copilot Studio rubrique renvoie deux sorties de type String, pva_State et pva_Item.

6. Sélectionnez Fermer.

7. Dans la section Activité, sélectionnez Afficher le code.

8. Tapez ou collez le code suivant. Remplacez TOPIC_ACTIVITY_NAME par le nom de l’activité d’événement de votre sujet. Assurez-vous qu’il n’y a pas de guillemets dans la propriété name.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

9. Sous la zone de code, définissez Property sur une variable Composer pour recevoir et stocker les valeurs de sortie de Copilot Studio compétence rubrique.

10. Dans le canevas de création de Composer, sélectionnez Ajouter, puis sélectionnez Gérer les propriétés, puis sélectionnez Définir les propriétés.

11. Définissez Propriété sur la valeur Composer qui doit stocker la valeur extraite. Définissez ensuite Valeur sur la variable Composer dans laquelle vous avez stocké les sorties de sujet.

    Dans cet exemple, les valeurs de sortie de dialog.skillResult.pvaState et dialog.skillResult.pvaItem sont extraites dans de nouvelles variables Composer dialog.State et dialog.Item.

Testez votre chatbot classique en tant que compétence avec un Bot Framework bot

Utilisez l’émulateur pour tester que votre bot appelle correctement un chatbot classique en tant que compétence. Bot Framework Bot Framework

Important

Votre Bot Framework bot doit être ajouté à la liste blanche du chatbot classique pour que la connexion compétence fonctionne.

En savoir plus

• Vue d’ensemble des compétences
• Manifeste de compétence
• Documentation Bot Framework Composer
• Compétences dans Composer
• Se connecter à une compétence distante dans Composer
• Tester une compétence dans l’émulateur