Partager via


Déboguer dans le client de bureau Teams

Microsoft 365 Agents Toolkit (anciennement appelé Teams Toolkit) vous permet de déboguer et d’afficher un aperçu de votre application Microsoft Teams dans le client de bureau. Pendant le processus de débogage, Agents Toolkit démarre automatiquement les services d’application, ouvre les débogueurs et charge l’application Teams. Vous pouvez afficher un aperçu de votre application Teams dans le client de bureau Teams après le débogage.

Voici les avantages du client de bureau Teams :

  • Améliore les performances.
  • Réduit le délai d’attente jusqu’à F5.
  • Améliore la couverture des cibles de débogage.

Fonctionnalités du client de bureau Teams

Le client de bureau Teams intègre des fonctionnalités de débogage dans les modèles d’application suivants générés par agents Toolkit :

  • Bot.
  • Agent.
  • Agent de moteur personnalisé.
  • Extension de message.

Configuration requise

Veillez à installer les outils suivants pour générer et déployer votre application dans le client de bureau Teams :

  Installer Pour l’utilisation...
  Microsoft 365 Agents Toolkit Une extension Microsoft Visual Studio Code qui crée une structure de projet pour votre application. Utilisez la dernière version préliminaire.
  Node.js Environnement runtime JavaScript principal. Pour plus d’informations, consultez node.js table de compatibilité des versions pour le type de projet.
  Visual Studio Code Environnements de build JavaScript, TypeScript ou SharePoint Framework (SPFx). Utilisez la dernière version.
  Compte de développeur Microsoft 365 Accès au compte Teams avec les autorisations appropriées pour installer une application.

Déboguer dans le client de bureau Teams

Pour déboguer votre application d’agent de moteur personnalisé dans le client de bureau Teams

  1. Ouvrez Visual Studio Code (VS Code) et connectez-vous à votre compte Microsoft 365 via agents Toolkit.

  2. Ouvrez votre projet d’application ou d’agent Teams.

    Pour en savoir plus sur la création d’un agent ou d’une application, consultez Créer votre ou vos premièresapplications dans Teams.

  3. Dans le volet gauche, sélectionnez Exécuter et déboguer (Ctrl+Shift+D), puis sélectionnez Déboguer dans Teams (Bureau) dans la liste déroulante.

    Capture d’écran montrant l’option de sélection de débogage dans Teams (Bureau).

  4. Vérifiez que votre connexion de bureau Teams correspond à votre compte Microsoft 365 utilisé dans agents Toolkit, puis sélectionnez Continuer.

    Capture d’écran montrant la connexion du bureau.

    Le client de bureau Teams demande à ajouter votre application.

  5. Sélectionnez Ajouter.

    Capture d’écran montrant le bouton Ajouter pour ajouter l’application au client de bureau Teams.

    Une fenêtre de conversation s’ouvre.

  6. À partir de la zone de composition de message, envoyez un message pour appeler le bot.

    Capture d’écran montrant l’application ajoutée au client de bureau Teams.

    Remarque

    La notification au niveau du système pour la correspondance de compte n’apparaît qu’une seule fois par projet. Dans les sessions de débogage suivantes, Agents Toolkit envoie des rappels sur le compte via des notifications VS Code.

    Capture d’écran montrant la notification de connexion de bureau suivante dans vs code.

  7. Vous pouvez ajouter des points d’arrêt et recharger vos modifications à chaud . Dans l’exemple suivant, le point d’arrêt est mis en surbrillance avec le point rouge en regard du numéro de ligne.

    Capture d’écran montrant un exemple de points d’arrêt dans l’application.

    Capture d’écran montrant un exemple après le rechargement à chaud d’une application.

Vous pouvez continuer à déboguer votre application d’agent de moteur personnalisé dans le client de bureau Teams.

Voir aussi