Freigeben über


Debuggen im Teams-Desktopclient

Microsoft 365 Agents Toolkit (früher als Teams Toolkit bezeichnet) hilft Ihnen beim Debuggen und Anzeigen einer Vorschau Ihrer Microsoft Teams-App im Desktopclient. Während des Debugvorgangs startet Agents Toolkit automatisch App-Dienste, öffnet Debugger und lädt die Teams-App hoch. Nach dem Debuggen können Sie eine Vorschau Ihrer Teams-App im Teams-Desktopclient anzeigen.

Im Folgenden sind die Vorteile des Teams-Desktopclients aufgeführt:

  • Verbessert die Leistung.
  • Reduziert die Zeit auf F5.
  • Verbessert die Abdeckung von Debugzielen.

Funktionen des Teams-Desktopclients

Der Teams-Desktopclient enthält Debugfunktionen in den folgenden App-Vorlagen, die vom Agents Toolkit gerüstet wurden:

  • Bot.
  • Agent.
  • Benutzerdefinierter Engine-Agent.
  • Nachrichtenerweiterung.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihrer App im Teams-Desktopclient installieren:

  Installieren Zum Benutzen...
  Microsoft 365 Agents Toolkit Eine Microsoft Visual Studio Code-Erweiterung, die ein Projektgerüst für Ihre App erstellt. Verwenden Sie die neueste Vorabversion.
  Node.js Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter node.js Versionskompatibilitätstabelle für den Projekttyp.
  Visual Studio Code Build-Umgebungen für JavaScript, TypeScript oder SharePoint Framework (SPFx). Verwenden Sie die neueste Version.
  Microsoft 365-Entwicklerkonto Zugriff auf das Teams-Konto mit den entsprechenden Berechtigungen zum Installieren einer App.

Debuggen im Teams-Desktopclient

So debuggen Sie Ihre benutzerdefinierte Engine-Agent-App im Teams-Desktopclient

  1. Öffnen Sie Visual Studio Code (VS Code), und melden Sie sich über das Agents Toolkit bei Ihrem Microsoft 365-Konto an.

  2. Öffnen Sie Ihren Teams-Agent oder Ihr App-Projekt.

    Weitere Informationen zum Erstellen eines neuen Agents oder einer app finden Sie unter Erstellen Ihres ersten Agents oder Ihrer appsin Teams.

  3. Wählen Sie im linken Bereich Ausführen und Debuggen (Ctrl+Shift+D) und dann in der Dropdownliste Debuggen in Teams (Desktop) aus.

    Screenshot: Option zum Auswählen von

  4. Stellen Sie sicher, dass Ihre Teams-Desktopanmeldung mit Ihrem Microsoft 365-Konto übereinstimmt, das im Agents Toolkit verwendet wird, und wählen Sie dann Weiter aus.

    Screenshot: Desktopanmeldung

    Der Teams-Desktopclient fordert an, Ihre App hinzuzufügen.

  5. Klicken Sie auf Hinzufügen.

    Screenshot: Schaltfläche

    Ein Chatfenster wird geöffnet.

  6. Senden Sie im Bereich zum Verfassen von Nachrichten eine Nachricht, um den Bot aufzurufen.

    Screenshot: App, die dem Teams-Desktopclient hinzugefügt wurde

    Hinweis

    Die Benachrichtigung auf Systemebene für den Kontoabgleich wird nur einmal pro Projekt angezeigt. In nachfolgenden Debugsitzungen sendet das Agents Toolkit Erinnerungen zum Konto über VS Code-Benachrichtigungen.

    Screenshot: Nachfolgende Benachrichtigung zur Desktopanmeldung im Vergleich zum Code

  7. Sie können Haltepunkte hinzufügen und Ihre Änderungen hot reload laden . Im folgenden Beispiel wird der Haltepunkt mit dem roten Punkt neben der Zeilennummer hervorgehoben.

    Screenshot: Beispiel für die Haltepunkte in der App

    Screenshot: Beispiel nach hot reload einer App

Sie können ihre benutzerdefinierte Engine-Agent-App weiterhin im Teams-Desktopclient debuggen.

Siehe auch