Microsoft 365 Agents Playground pour Visual Studio

Microsoft 365 Agents Playground (précédemment appelé Outil de test d’application Teams) permet de déboguer facilement des applications basées sur des bots. 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 Agents Playground.

L’image suivante montre un exemple d’application affichant une réponse dans Agents Playground :

Voici les avantages d’Agents Playground :

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

• Tunneling : un service de tunnel externe n’est pas nécessaire, car Agents Playground 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 : Agents Playground 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 : Agent Playground est fiable, car la carte adaptative du bot utilise la même technologie de rendu que dans Teams.

• Intégration avec les applications de bot Teams existantes : Agents Playground 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 : Agent Playground prend en charge les tests dans les étendues de conversation personnelle, d’équipe et de groupe.

Configuration requise

Veillez à installer les outils suivants pour générer et déployer votre bot dans Agents Playground :

Expérience Agents Playground dans Visual Studio

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

1. Ouvrez Visual Studio.

2. Sélectionnez 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.

   

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

   

6. Sélectionnez AI Chat Bot>Create.

   Remarque

   • OpenAI ou Azure OpenAI sont les prérequis pour déboguer l’application AI Chat Bot .

   

   Une fenêtre GettingStarted s’affiche.

   

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

   • OpenAI
   • Azure OpenAI

   Mettez à jour OpenAI ApiKey dans le appsettings.Playground.json fichier .

   

8. Dans la liste déroulante de débogage, sélectionnez Microsoft 365 Agents Playground (navigateur).

   

   Agents Playground ouvre le bot dans une page web.

   

Déclencheurs d’activité

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

• Déclencheurs d’activité prédéfinis
• Déclencheurs d’activité personnalisés

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

Agents Playground fournit des déclencheurs d’activité prédéfinis pour tester les fonctionnalités de votre bot.

Les déclencheurs d’activité prédéfinis sont disponibles dans le menu Simuler une activité dans Agents Playground. 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, allez à 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.

   

4. Dans Agents Playground, accédez à Simuler une activité et sélectionnez Ajouter un utilisateur.

   

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

5. Sélectionnez Envoyer l’activité.

   

   Le bot envoie une réponse.

   

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. Agents Playground 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, allez à 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.

   

4. Accédez à la page web Agents Playground et sélectionnez la dernière réponse à partir du panneau de journal pour copier replyToId.

   

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

   

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é.

   

   Le bot envoie un onReactionsAdded gestionnaire en réponse.

   

Limitations

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

• Agents Playground ne prend pas en charge tous les types de cartes à l’exception des cartes adaptatives.

• Agents Playground ne prend pas en charge les fonctionnalités de carte adaptative suivantes :

  • Typeahead
  • Mention de l’utilisateur
  • Stageview
  • Carte adaptative pleine largeur

• Agents Playground ne prend pas en charge les expériences suivantes :

  • Mobile
  • Réunion

Voir aussi

• Vue d’ensemble du kit de ressources Microsoft 365 Agents
• Créer des bots pour Teams
• Carte adaptative
• Kit de développement logiciel (SDK) Bot Framework