Microsoft 365 Agents Playground pour Visual Studio

Microsoft 365 Agents Playground (anciennement Outil de test d’application Teams) permet de déboguer des applications basées sur des bots sans effort. Vous pouvez discuter avec votre robot et voir ses messages et ses cartes adaptatives au fur et à mesure qu’ils apparaissent dans Microsoft Teams. Vous n’avez pas besoin d’un compte de développeur Microsoft 365, de tunneling ou d’une inscription d’application et de bot Teams pour utiliser Agent Playground.

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

Voici les avantages d’Agents Playground :

• Environnement bac à sable : l’environnement 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 : les autorisations de client Microsoft 365 Developer et de chargement de l’application ne sont pas nécessaires pour déboguer le bot.

• Itérations rapides en boucle interne : optimisent 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 : Agent Playground permet de tester facilement des 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 : Agents Playground est fiable car la carte adaptative du bot utilise la même technologie de rendu que dans Teams.

• Intégration aux applications bot Teams existantes : Agents Playground s’intègre sans effort aux applications bot Teams existantes créées avec le SDK Bot Framework.

• Prise en charge de différentes étendues : Le terrain de jeu des agents prend en charge les tests dans les étendues de conversation personnelle, d’équipe et de groupe.

Configuration requise

Veillez à installer les outils suivants pour créer et déployer votre bot dans Agents Playground :

Expérience Agent Playground dans Visual Studio

Agents Playground offre une expérience de débogage plus rapide pour les applications 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 l’exemple de l’IA Chat du bot. 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 le 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’IA Chat’application 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).

   

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

Des déclencheurs d’activité prédéfinis sont disponibles dans le menu Simuler une activité d’Agent 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, accédez à l’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 se joignent à la conversation, comme décrit par l’activité Ajouter un utilisateur.

   

4. Dans Agent Playground, accédez à Mocker 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 l’adapter 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 MembersAdded, membersremoved, et reactionsremoved.

1. Dans Visual Studio Code, accédez à l’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 du terrain de jeu des agents et sélectionnez la dernière réponse dans le 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. Remplacer par le dernier 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 :

  • La saisie semi-automatique
  • mention de l’utilisateur
  • Vue de la scène
  • Carte adaptative pleine largeur

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

  • Mobile
  • Réunion

Voir aussi

• Vue d’ensemble de Microsoft 365 Agents Toolkit
• Créer des bots pour Teams
• Carte adaptative
• Bot Framework SDK