Tester et déboguer avec Emulator

S'APPLIQUE À : SDK v4

Bot Framework Emulator est une application bureautique qui permet aux développeurs de bots de tester et déboguer leurs bots localement ou à distance. Emulator vous permet de converser avec le bot et d’inspecter les messages qu’il envoie et reçoit. Emulator affiche les messages tels qu’ils apparaîtraient dans une interface utilisateur de conversation Web, et journalise les requêtes et réponses JSON à mesure que vous échangez des messages avec le bot. Avant de déployer votre bot dans le Cloud, exécutez-le et testez-le localement à l’aide d’Emulator. Vous pouvez tester votre bot à l’aide d’Emulator, même si vous ne l’avez pas encore créé avec Azure AI Bot Service ou configuré pour s’exécuter sur des canaux.

Prérequis

• Installez Bot Framework Emulator

Exécuter un robot localement

Avant de connecter votre robot au Bot Framework Emulator, vous devez exécuter votre robot localement. Vous pouvez utiliser Visual Studio ou Visual Studio Code pour exécuter votre robot ou utiliser la ligne de commande. Pour exécuter un robot à l’aide de la ligne de commande, procédez comme suit :

À ce stade, votre robot s’exécute localement.

Se connecter à un bot s’exécutant sur un hôte local

Configuration des paramètres de proxy

Lorsque vous développez derrière un proxy d’entreprise, Emulator utilise les variables d’environnement HTTP_PROXY et HTTPS_PROXY configurées, qui spécifient respectivement l’itinéraire d’URL du proxy pour les requêtes HTTP et HTTPs.

Si vous vous connectez à un bot qui s’exécute sur localhost, Emulator tente d’abord d’acheminer via le proxy avant de vous connecter à localhost. En règle générale, le proxy bloque la connexion, sauf si vous spécifiez qu’elle doit être contournée pour localhost.

Pour contourner les paramètres HTTP_PROXY et HTTPS_PROXY et autoriser Emulator à se connecter à localhost, vous devez définir la variable d’environnement suivante sur votre ordinateur local :

NO_PROXY=localhost

Configurer Emulator pour l’authentification

Si un bot nécessite une authentification par le biais d’une boîte de dialogue de connexion, vous devez configurer Emulator comme indiqué ci-dessous.

Utilisation d’un code de vérification de connexion

1. Démarrez Emulator.
2. Dans Emulator, sélectionnez Paramètres (icône d’engrenage) dans le volet gauche.
3. Activez Utiliser un code de vérification de connexion pour OAuthCards.
4. Cliquez sur Enregistrer.

Lorsque vous sélectionnez le bouton de connexion affiché par le bot, un code de validation est généré. Vous saisirez le code dans la zone de conversation d’entrée du bot pour établir l’authentification. Vous pouvez ensuite effectuer les opérations autorisées.

Sinon, vous pouvez effectuer les étapes décrites ci-dessous.

Utilisation de jetons d’authentification

1. Démarrez Emulator.
2. Dans Emulator, sélectionnez Paramètres (icône d’engrenage) dans le volet gauche.
3. Activez Utiliser les jetons d’authentification version 1.0.
4. Cliquez sur Enregistrer.

Lorsque vous sélectionnez le bouton de connexion affiché par le bot, vous êtes invité à entrer vos informations d’identification. Un jeton d’authentification est généré. Vous pouvez ensuite effectuer les opérations autorisées.

Pour vous connecter à un bot s’exécutant localement, sélectionnez Ouvrir le bot. Ajoutez le numéro de port que vous avez copié précédemment dans l’URL suivante et collez l’URL mise à jour dans la barre d’URL du robot :

http://localhost:<port number>/api/messages

Si votre bot s’exécute avec les informations d’identification de compte Microsoft (MSA), entrez également ces informations d’identification.

Utiliser les informations d’identification du bot

Lorsque vous ouvrez le bot, définissez l’ID d’application Microsoft et le mot de passe d’application Microsoft si votre bot s’exécute avec des informations d’identification. Si vous avez créé votre bot avec Azure AI Bot Service, les informations d’identification sont disponibles sur l’App Service du bot, sous la section Paramètres -> Configuration. Si vous ne connaissez pas les valeurs, vous pouvez les supprimer du fichier de configuration du bot exécuté localement, puis exécuter le bot dans Emulator. Si le bot n’est pas en cours d’exécution avec ces paramètres, vous n’avez pas besoin d’exécuter Emulator avec les paramètres.

Lors de la création d’une application de fournisseur d’identité Azure AD, gardez à l’esprit les points suivants :

• Quand le type de comptes pris en charge est défini sur un locataire unique, si vous utilisez un abonnement personnel au lieu d’un compte Microsoft, Emulator émet le message d’erreur : L’ID ou le mot de passe du bot de l’application Microsoft est incorrect.
• Dans ce cas, les types de comptes pris en charge doivent être définis sur Comptes dans un répertoire d’entreprise (tout répertoire Microsoft Entra ID - Multilocataire) et comptes Microsoft personnels (par exemple, Xbox).

Pour plus d’informations, consultez Créer une application de fournisseur d’identité Microsoft Entra ID et Inscrire une nouvelle application à l’aide du portail Azure.

Afficher les activités de message détaillées avec l’inspecteur

Envoyez un message à votre robot et ce dernier doit répondre. Vous pouvez sélectionnez la bulle du message dans la fenêtre de conversation et inspecter l’activité JSON brute à l’aide de la fonctionnalité INSPECTOR à droite de la fenêtre. Lorsque cette option est sélectionnée, la bulle de message devient jaune et l’objet JSON d’activité s’affiche à gauche de la fenêtre de conversation. Les informations JSON incluent des métadonnées clés, dont l’ID de canal, le type d’activité, l’ID de conversation, le SMS, l’URL du point de terminaison, etc. Vous pouvez inspecter les activités envoyées par l’utilisateur, ainsi que les activités avec lesquelles le bot répond.

Inspecter des services

Avec Emulator, vous pouvez également inspecter les réponses JSON à partir de LUIS et QnA Maker. À l’aide d’un robot avec un service de langage connecté, vous pouvez sélectionner trace dans la fenêtre LOG (JOURNAL) en bas à droite. Ce nouvel outil offre également des fonctionnalités pour mettre à jour vos services de langage directement à partir d’Emulator.

Avec un service LUIS connecté, le lien de trace spécifie Trace LUIS. En suivant ce lien, la réponse brute de votre service LUIS s’affiche. Elle inclut des intentions, des entités avec leurs scores spécifiés. Vous pouvez réattribuer des intentions pour vos énoncés utilisateur.

Avec un service QnA Maker connecté, le journal d’activité affiche la trace QnA. Lorsqu’il est sélectionné, vous pouvez voir un aperçu de la paire question-réponse associée à cette activité, ainsi qu’un score de confiance. À partir de là, vous pouvez ajouter une autre formulation de question pour une réponse.

Connexion à Azure

Vous pouvez utiliser Emulator pour vous connecter à votre compte Azure. Cela vous est utile pour ajouter et gérer les services dont votre bot dépend. Pour vous connecter :

1. Sélectionnez Fichier, puis Se connecter avec Azure.

   

2. Dans l’écran de Bienvenue, sélectionnez Se connecter avec votre compte Azure. Vous pouvez éventuellement indiquer à Emulator de maintenir votre connexion lors du redémarrage du programme d’émulation.

   

Désactivation de la collecte des données

Si vous ne voulez plus autoriser Emulator à collecter des données d’utilisation, vous pouvez facilement désactiver la collecte de données en effectuant les étapes suivantes :

1. Dans Emulator, sélectionnez Paramètres (icône d’engrenage) dans le volet gauche.

   

2. Décochez la case Aidez-nous à améliorer Emulator en nous autorisant à collecter des données d’utilisation sous la section Collecte des données.

3. Cliquez sur Enregistrer.

Si vous changez d’avis, vous pouvez réactiver la collecte de données ultérieurement.

Ressources supplémentaires

Bot Framework Emulator est open source. Vous pouvez contribuer au développement en envoyant des bogues et des suggestions.

Pour des informations de dépannage, consultez Résoudre les problèmes généraux ainsi que les autres articles de résolution des problèmes de cette section.

Étape suivante

Utilisez l’intergiciel d’inspection pour déboguer un robot connecté à un canal.