Freigeben über


Debuggen im Teams-Desktopclient

Das Microsoft Teams-Toolkit unterstützt Sie beim Debuggen und Anzeigen einer Vorschau Ihrer Microsoft Teams-App im Desktopclient. Während des Debugvorgangs startet Teams 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 Teams-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...
  Teams 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 Teams Toolkit bei Ihrem Microsoft 365-Konto an.

  2. Wählen Sie in der VS Code-Aktivitätsleiste das Symbol Teams Toolkit und dann Neue App erstellen aus.

    Screenshot: Position des Links

  3. Wählen Sie Benutzerdefinierter Engine-Agent aus.

    Screenshot: Teams Toolkit-App-Vorlagen

  4. Wählen Sie Grundlegende KI-Chatbots aus.

    Screenshot: App-Funktionen, die Ihrer neuen App hinzugefügt werden sollen

  5. Wählen Sie JavaScript aus.

    Screenshot: Option zum Auswählen der Programmiersprache

  6. Wählen Sie OpenAI aus.

    Screenshot: LLM in Visual Studio Code

  7. Geben Sie den OpenAI-Dienstschlüssel ein.

    Screenshot: Eingabe des openai-Dienstschlüssels in Visual Studio Code

  8. Wählen Sie Standardordneraus.

    Screenshot: Auswahl des Standardspeicherorts

    Führen Sie die folgenden Schritte aus, um den Standardspeicherort zu ändern:

    1. Wählen Sie Durchsuchen aus.

      Screenshot: Option zum Durchsuchen und Auswählen des Standorts

    2. Wählen Sie den Speicherort für den Projektarbeitsbereich aus.

    3. Wählen Sie Ordner auswählen aus.

      Screenshot: Ordner, der ausgewählt werden soll

  9. Geben Sie einen geeigneten Namen für Ihre App ein, und drücken Sie dann die EINGABETASTE .

    Screenshot: Eingabe des App-Namens

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

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

    Screenshot: Desktopanmeldung

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

  12. Klicken Sie auf Hinzufügen.

    Screenshot: Schaltfläche

    Ein Chatfenster wird geöffnet.

  13. 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 teams Toolkit Erinnerungen zum Konto über VS Code-Benachrichtigungen.

    Screenshot: Nachfolgende Benachrichtigung zur Desktopanmeldung im Vergleich zum Code

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