Déboguer votre bot conversationnel IA à l’aide de l’outil de test d’application Teams

Article
Developer (Avancé)
7 minutes avant achèvement

Démarrez le développement d’applications Microsoft Teams avec votre application de bot conversationnel IA Teams et déboguez avec l’outil de test d’application Teams (outil de test). L’outil de test permet de déboguer facilement des applications basées sur un bot. 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.

Vous pouvez discuter avec votre bot et afficher les messages et les cartes adaptatives tels qu’ils apparaissent dans Teams. Vous pouvez également simuler une activité dans l’outil de test à l’aide de déclencheurs d’activité.

Remarque

L’outil de test d’application Teams est disponible uniquement dans teams Toolkit v5.4.0.
L’outil de test d’application Teams est pris en charge uniquement pour les clients de bureau et web.

Ce guide pas à pas vous aide à créer un bot de conversation ia à l’aide de Teams Toolkit et à déboguer avec l’outil de test. Une fois ce guide terminé, vous verrez la sortie suivante, dans laquelle l’utilisateur peut accéder au bot de conversation IA et l’utiliser :

Configuration requise

6 minutes restantes

Veillez à installer les outils suivants pour générer et déployer vos applications.

Installer	Pour l’utilisation...
Visual Studio Code ou Visual Studio	Environnements de build JavaScript, TypeScript ou C#. Utilisez la dernière version.
Toolkit Teams	Extension Microsoft Visual Studio Code qui crée une structure de projet pour votre application. Utilisez Teams Toolkit v5.4.0. Pour plus d’informations, consultez Installer teams Toolkit.
Node.js	Environnement runtime JavaScript principal. Pour plus d’informations, consultez Node.js table de compatibilité des versions pour le type de projet.
OpenAI ou Azure OpenAI	Commencez par créer votre clé API OpenAI pour utiliser le GPT d’OpenAI. Si vous souhaitez héberger votre application ou accéder à des ressources dans Azure, vous devez créer un service Azure OpenAI.
Microsoft Edge (recommandé) ou Google Chrome	Un navigateur avec des outils de développement.

Créer un espace de travail de projet pour votre application de bot de conversation IA

5 minutes restantes

Nous allons créer votre application de bot de conversation IA.

La fonctionnalité de bot d’une application Teams crée un chatbot ou un bot conversationnel. Il communique avec un service web, ce qui facilite l’utilisation de ses services. Le bot peut exécuter des tâches simples et automatisées telles que la fourniture d’un service client. Vous pouvez obtenir des prévisions météorologiques, effectuer des réservations ou tout autre service proposé à l’aide d’un bot conversationnel.

Capture d’écran montrant l’application avec trois fonctionnalités. Bot est mis en surbrillance.

Comme vous avez déjà préparé la création de ces applications, vous pouvez configurer un nouveau projet Teams pour créer l’application de bot de conversation IA. Dans ce tutoriel, vous allez apprendre à :

Créez votre espace de travail de projet de bot.
Découvrez le code source de l’application bot.

Créer votre espace de travail de projet de bot

Si les conditions préalables sont en place, commençons !

Ouvrez Visual Studio Code.
Sélectionnez l’icône Teams Toolkit dans la barre d’activité de Visual Studio Code.
Sélectionnez Créer une application.
Sélectionnez Bot.
Sélectionnez AI Chat Bot. Si vous avez besoin d’une autre fonctionnalité pour votre bot, sélectionnez l’option requise.
Sélectionnez JavaScript.
Sélectionnez Dossier par défaut.

Pour modifier l’emplacement par défaut, procédez comme suit :
1. Sélectionnez Parcourir.
2. Sélectionnez l’emplacement de l’espace de travail du projet.
3. Sélectionnez Sélectionner un dossier.
4. Entrez un nom approprié pour votre application, puis sélectionnez la touche Entrée .
  
  Une boîte de dialogue s’affiche, dans laquelle vous devez choisir oui ou non pour approuver les auteurs des fichiers dans ce dossier.
  
  Vous avez maintenant créé votre espace de travail de projet de bot de conversation IA.

Découvrez le code source de l’application bot

Une fois la génération de modèles automatique terminée, explorez les répertoires et fichiers de projet dans la section EXPLORATEUR de Visual Studio Code.

Capture d’écran montrant l’exemple de dossier de bot Teams Toolkit Structure.

Nom du dossier ou du fichier	Sommaire
`env/.env.testtool`	Fichier de configuration avec des variables d’environnement qui peuvent être validées dans Git.
`env/.env.testtool.user`	Fichier de configuration avec des variables d’environnement, y compris des informations d’identification, qui ne sont pas validées dans Git par défaut.
`appPackage`	Fichiers de modèle de manifeste d’application et icônes d’application (color.png et outline.png).
`appPackage/manifest.json`	Manifeste d’application pour l’exécution de l’application dans un environnement local et distant.
`src/app.js`	Gère les logiques métier du bot de conversation IA.
`teamsapp.yml`	Il s’agit du fichier projet main Teams Toolkit. Le fichier projet définit deux éléments principaux : Les propriétés et les définitions de configuration et de phase.
`teamsapp.local.yml`	Cela remplace par des `teamsapp.yml` actions qui activent l’exécution et le débogage locaux.
`teamsapp.testtool.yml`	Cela remplace par des actions qui activent l’exécution `teamsapp.yml` et le débogage locaux dans l’outil de test.

Créer et exécuter votre application de bot de conversation IA

4 minutes restantes

Après avoir configuré votre espace de travail de projet avec Teams Toolkit, générez votre projet de bot de conversation IA.

Créer une clé et un point de terminaison Open AI pour votre bot de conversation IA

Accédez au portail Azure.
Sélectionnez Créer une ressource et recherchez Azure Open AI.
Sélectionnez Azure Open AI , puis Créer.
Renseignez les informations requises et sélectionnez Suivant.
Sélectionnez Tous les réseaux, y compris Internet, peuvent accéder à cette ressource, puis sélectionnez Suivant.
Renseignez les informations requises et sélectionnez Suivant.
Sélectionnez Créer.

Vous avez créé une clé et un point de terminaison pour votre bot de conversation IA.

Remarque

Vous pouvez également obtenir la clé API OpenAI pour déboguer votre bot de conversation IA. Pour plus d’informations, consultez Configurer votre clé API.

Obtenir des clés et un point de terminaison Azure Open AI

Sélectionnez Accéder aux ressources.
Sélectionnez Clés et point de terminaison dans le volet gauche, puis copiez la CLÉ et le point de terminaison. Vous pouvez copier KEY 1 ou KEY 2.

Enregistrez la clé et le point de terminaison pour une utilisation ultérieure.
Sélectionnez Déploiements de modèles dans le volet gauche, puis Sélectionnez Gérer les déploiements.

La fenêtre Azure Open AI Studio s’affiche.
Sélectionnez Déploiements dans le volet gauche, puis + Créer de nouveaux déploiements.
Sélectionnez les détails suivants :
1. Sélectionnez gpt-35-turbo dans la liste déroulante Sélectionner un modèle .
  
  Remarque
  
  Seul le modèle gpt-35-turbo est pris en charge pour le bot de conversation IA.
2. Sélectionnez 0301 (par défaut) dans la liste déroulante Version du modèle .
3. Entrez Nom du déploiement , puis sélectionnez Créer.
Copiez et enregistrez le nom du déploiement pour une utilisation ultérieure.

Mettre à jour la clé et les points de terminaison Azure Open AI

Ouvrez votre projet dans Visual Studio Code.
Sous EXPLORATEUR, accédez au fichier env.env.testtool.user>.

Entrez votre SECRET_AZURE_OPENAI_API_KEY et SECRET_AZURE_OPENAI_ENDPOINT.

...
SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key>
SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>

Accédez au fichier deapp.jssrc>.
Commentez le OpenAI code et supprimez les marques de commentaire du Azure OpenAI code.

Entrez le nom de votre déploiement Azure Open AI dans azureDefaultDeployment.

...
// Use OpenAI
// apiKey: config.openAIKey,
// defaultModel: "gpt-3.5-turbo",

azureApiKey: config.azureOpenAIKey,
azureDefaultDeployment: "gpt-35-turbo",
azureEndpoint: config.azureOpenAIEndpoint,
...

Déboguer et exécuter votre application de bot de conversation ia

Dans le volet gauche, sélectionnez EXÉCUTER et DÉBOGUER (Ctrl+Maj+D), puis sélectionnez Déboguer dans l’outil de test (préversion) dans la liste déroulante.
L’outil de test ouvre votre bot de conversation IA dans une page web.

Déclencheurs d’activité

3 minutes restantes

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
Déclencheurs d’activité personnalisés

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` `onMembersAdded` `onTeamsMembersAddedEvent` `onTeamsChannelCreatedEvent`
	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.

Pour simuler une activité Ajouter un utilisateur , procédez comme suit :

Dans l’outil de test, accédez à Simuler une activité>Ajouter un utilisateur.

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

Le bot envoie la réponse suivante :

Déclencheurs d’activité personnalisés

Vous pouvez utiliser l’activité personnalisée pour personnaliser les déclencheurs d’activité, par exemple, reactionsAdded 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.

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

Ajoutez messageReaction pour personnaliser l’activité sous la type propriété :

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

Sélectionnez Envoyer l’activité.

Le bot envoie un onReactionsAdded gestionnaire en réponse.