Outil de test d’application Teams pour Visual Studio

  • Article

L’outil de test d’application Teams (outil de test) permet de déboguer facilement les applications basées sur un bot. Vous pouvez discuter avec votre bot et voir ses messages et cartes adaptatives tels qu’ils apparaissent dans Microsoft Teams. Vous n’avez pas besoin d’un compte de développeur Microsoft 365, d’un tunneling ou d’une inscription d’application et de bot Teams pour utiliser l’outil de test.

L’image suivante montre un exemple d’application affichant une réponse dans l’outil de test :

Capture d’écran montrant la carte adaptative de l’outil de test d’application Teams.

Voici les avantages de Test Tool :

  • Environnement de bac à sable : l’environnement de bac à sable de l’outil de test émule le comportement, l’apparence et l’expérience utilisateur de Teams.

  • Tunneling : un service de tunnel externe n’est pas nécessaire, car l’outil de test s’exécute sur un serveur local avec lequel votre bot peut communiquer.

  • Réduire les dépendances de compte : le locataire Microsoft 365 Développeur et les autorisations de chargement de l’application ne sont pas nécessaires pour déboguer le bot.

  • Itérations rapides de boucle interne : optimise le processus de modification de la conception de l’application et de la logique du bot sans avoir à redéployer le bot dans le cloud.

  • Données et activités fictives : l’outil de test facilite le test de scénarios complexes tels que l’envoi d’un message de bienvenue lorsqu’un nouveau membre rejoint le canal et l’utilisation de données fictives et de déclencheurs d’activité.

  • Fiable : l’outil de test est fiable, car la carte adaptative du bot utilise la même technologie de rendu que dans Teams.

  • Intégration avec des applications de bot Teams existantes : l’outil de test s’intègre facilement aux applications de bot Teams existantes créées avec le KIT de développement logiciel (SDK) Bot Framework.

  • Prise en charge de différentes étendues : l’outil de test prend en charge les tests dans les étendues de conversation personnelle, d’équipe et de groupe.

Prerequisites

Veillez à installer les outils suivants pour générer et déployer votre bot dans l’outil de test :

Installer Pour l’utilisation...
Node.js Environnement runtime JavaScript principal.
Visual Studio 2022
 Vous pouvez installer la version entreprise dans Visual Studio 2022 et installer les charges de travail de développement ASP.NET et web. Utilisez la version 17.9 ou ultérieure.

Expérience de l’outil de test dans Visual Studio

L’outil de test offre une expérience de débogage plus rapide pour les applications de bot par rapport au client Teams. L’outil de test prend en charge toutes les fonctionnalités de l’application de bot. Dans ce scénario, nous utilisons le bot de conversation IA comme exemple. Pour déboguer votre bot dans l’outil de test, procédez comme suit :

  1. Ouvrez Visual Studio.

  2. Sélectionnez Créer un projet.

    Capture d’écran montrant la sélection pour créer un projet.

  3. Dans la zone de recherche, entrez Microsoft Teams. Dans les résultats de la recherche, sélectionnez Application Microsoft Teams.

  4. Sélectionnez Suivant.

    Capture d’écran montrant la sélection de modèles pour créer un projet.

  5. Entrez Nom du projet , puis sélectionnez Créer.

    Capture d’écran montrant l’option permettant d’entrer le nom du projet.

  6. Sélectionnez AI Chat Bot>Create.

    Remarque

    Capture d’écran montrant la sélection de l’application Teams pour créer un projet.

    Une fenêtre GettingStarted s’affiche.

    Capture d’écran montrant la page prise en main de l’application dans Visual Studio.

  7. Le appsettings.TestTool.json fichier permet de configurer l’outil de test en mettant à jour quelques paramètres. Pour mettre à jour appsettings.TestTool.json le fichier, suivez les étapes OpenAI ou Azure OpenAI :

    • Mettez à jour OpenAI ApiKey dans le appsettings.TestTool.json fichier .

      Capture d’écran montrant la clé OpenAI mise à jour.

  8. Dans la liste déroulante débogage, sélectionnez Outil de test d’application Teams (navigateur).

    Capture d’écran montrant l’option permettant de sélectionner l’outil de test d’application Teams dans la liste déroulante.

    L’outil de test ouvre le bot dans une page web.

    Capture d’écran montrant le bot qui ouvre l’outil de test dans la page web.

Déclencheurs d’activité

Vous pouvez simuler une activité dans l’outil de test à l’aide de déclencheurs d’activité. Il existe deux types de déclencheurs d’activité :

Déclencheurs d’activité prédéfinis

L’outil de test fournit des déclencheurs d’activité prédéfinis pour tester les fonctionnalités de votre bot.

Catégorie Activité Handler
Déclencher l’activité de mise à jour de l’installation Installer le bot


Désinstaller le bot		 onInstallationUpdate
onInstallationUpdateAdded

onInstallationUpdate
onInstallationUpdateRemove
Déclencher l’activité de mise à jour de conversation Ajouter un utilisateur

Ajouter un robot

Ajouter un canal		 onMembersAdded

onTeamsMembersAddedEvent

onTeamsChannelRenamedEvent
Supprimer l’utilisateur


Supprimer le bot


Supprimer un canal

Supprimer l’équipe		 onMembersRemoved
onTeamsMembersRemovedEvent

onMembersRemoved
onTeamsMembersRemovedEvent

onTeamsChannelDeletedEvent

onTeamsTeamDeletedEvent
Renommer le canal

Renommer l’équipe		 onTeamsChannelRenamedEvent

onTeamsTeamRenamedEvent

Remarque

Tous les types d’activités ne sont pas disponibles dans toutes les étendues. Par exemple, vous ne pouvez pas ajouter ou supprimer un canal dans une conversation personnelle ou une conversation de groupe.

Les déclencheurs d’activité prédéfinis sont disponibles dans le menu Simuler une activité de l’outil de test. Dans ce scénario, nous utilisons l’exemple Ajouter un déclencheur d’activité utilisateur. Pour simuler une activité Ajouter un utilisateur , procédez comme suit :

  1. Dans Visual Studio Code, accédez à Explorateur de solutions.

  2. Sélectionnez le fichier Program.cs .

  3. Dans le fichier Program.cs , sous builder.Services.AddTransient<IBot>(sp => ajoutez le code suivant :

    app.OnConversationUpdate("membersAdded", async (context, state, cancellationToken) =>
{
   await context.SendActivityAsync($"new member added", cancellationToken: cancellationToken);
});

    Le OnConversationUpdate gestionnaire reconnaît les membres qui rejoignent la conversation comme décrit par l’activité Ajouter un utilisateur.

    Capture d’écran montrant le code ajouté à program.cs fichier pour l’activité fictive prédéfinie ajouter un utilisateur.

  4. Dans l’outil de test, accédez à Simuler une activité et sélectionnez Ajouter un utilisateur.

    Capture d’écran montrant l’option Ajouter un utilisateur sous simuler une activité.

    Une boîte de dialogue contextuelle s’affiche pour afficher un aperçu du gestionnaire d’activités.

  5. Sélectionnez Envoyer l’activité.

    Capture d’écran montrant l’option d’envoi d’une activité pour l’ajout d’un utilisateur d’activité fictive prédéfini.

    Le bot envoie une réponse.

    Capture d’écran montrant la réponse de l’utilisateur d’ajout d’une activité fictive prédéfinie.

Déclencheurs d’activité personnalisés

Vous pouvez utiliser l’activité personnalisée pour personnaliser le déclencheur reactionsAddedd’activité , afin de répondre aux exigences de votre application bot. L’outil de test remplit automatiquement les propriétés requises de l’activité. Vous pouvez également modifier le type d’activité et ajouter d’autres propriétés telles que , MembersAddedmembersremovedet reactionsremoved.

  1. Dans Visual Studio Code, accédez à Explorateur de solutions.

  2. Sélectionnez le fichier Program.cs .

  3. Dans le fichier Program.cs , sous builder.Services.AddTransient<IBot>(sp => ajoutez le code suivant :

    app.OnMessageReactionsAdded(async (context, state, cancellationToken) =>
{
   await context.SendActivityAsync($"reaction added.", cancellationToken: cancellationToken);
});

    Le OnMessageReactionsAdded gestionnaire identifie la réaction à ajouter à l’aide de la ReplyToId propriété de la conversation précédente.

    Capture d’écran montrant le code ajouté à program.cs fichier pour la personnalisation de l’activité fictive.

  4. Accédez à la page web de l’outil de test et sélectionnez la dernière réponse dans le panneau de journal pour copier replyToId.

    Capture d’écran montrant la sélection de replyToID à copier pour la personnalisation sur une activité fictive.

  5. Sélectionnez Simuler une activité>Activité personnalisée.

    Capture d’écran montrant la liste des options sous simuler une activité.

  6. Pour personnaliser l’activité, ajoutez messageReaction sous la type propriété .

  7. Remplacez par la dernière version replyToId.

    {
  "type": "messageReaction",
  "reactionsAdded": [
    {
      "type": "like"
    }
  ],
  "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
}

  8. Sélectionnez Envoyer l’activité.

    Capture d’écran montrant l’option d’envoi de l’activité après la personnalisation sur une activité fictive.

    Le bot envoie un onReactionsAdded gestionnaire en réponse.

    Capture d’écran montrant la réponse d’une activité fictive personnalisée.

Limitations

  • Les fonctionnalités de bot activées via le manifeste de l’application ne sont pas disponibles, car l’outil de test ne les traite pas.

  • L’outil de test ne prend pas en charge tous les types de cartes, à l’exception des cartes adaptatives.

  • L’outil de test ne prend pas en charge les fonctionnalités de carte adaptative suivantes :

  • L’outil de test ne prend pas en charge les expériences suivantes :

    • Mobile
    • Réunion

Voir aussi