Debuggen eines SDK-first Bots

GILT FÜR: SDK v4

Dieser Artikel beschreibt das Debuggen Ihres Bots mithilfe einer IDE wie Visual Studio oder Visual Studio Code und dem Bot Framework-Emulator. Verwenden Sie diese Methoden, um einen Bot lokal zu debuggen. In diesem Artikel wird ein Echo-Bot verwendet, z. B. der im Schnellstart zum Erstellen eines Bots erstellte Bot.

Hinweis

In diesem Artikel wird Bot Framework Emulator zum Senden und Empfangen von Nachrichten vom Bot während des Debuggens verwendet. Wenn Sie andere Methoden zum Debuggen Ihres Bots mit Bot Framework Emulator suchen, lesen Sie den Artikel Debuggen mit dem Emulator.

Hinweis

Die JavaScript-, C#- und Python-SDKs für Bot Framework werden weiterhin unterstützt, das Java-SDK wird jedoch eingestellt und der langfristige Support endet im November 2023. Es werden nur kritische Sicherheits- und Programmfehlerbehebungen innerhalb dieses Repositorys durchgeführt.

Bestehende Bots, die mit dem Java SDK erstellt wurden, werden weiterhin funktionieren.

Wenn Sie einen neuen Bot erstellen möchten, sollten Sie den Einsatz von Power Virtual Agents in Betracht ziehen und sich über die Auswahl der richtigen Chatbot-Lösung informieren.

Weitere Informationen finden Sie unter Die Zukunft des Bot-Design.

Voraussetzungen

• Laden Sie den Bot Framework-Emulator herunter, und installieren Sie ihn.
• Herunterladen und Installieren von Visual Studio Code oder Visual Studio.

C#

Festlegen von C#-Breakpoints in Visual Studio Code

In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Zum Festlegen von Breakpoints in Visual Studio Code führen Sie die folgenden Schritte aus:

1. Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.

2. Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.

   

3. Wählen Sie in der Menüleiste Ausführen und dann Debuggen beginnen starten. Die Ausführung Ihres Bots wird aus dem Terminal in Visual Studio Code im Debugmodus gestartet.

4. Starten Sie Bot Framework Emulator, und stellen Sie wie unter Debuggen mit dem Bot Framework-Emulator beschrieben eine Verbindung mit Ihrem Bot her.

5. Senden Sie Ihrem Bot über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.

   

Festlegen von C#-Breakpoints in Visual Studio

In Visual Studio (VS) können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Zum Festlegen von Breakpoints in Visual Studio führen Sie die folgenden Schritte aus:

1. Navigieren Sie zu Ihrem Botordner, und öffnen Sie die SLN-Datei. Damit wird die Projektmappe in Visual Studio geöffnet.

2. Wählen Sie in der Menüleiste Build und dann Build-Lösung aus.

3. Wählen Sie im Projektmappen-Explorer die Datei vom Typ .cs aus und legen Sie bei Bedarf Breakpoints fest. In dieser Datei ist die Hauptlogik des Bots definiert. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.

   

4. Wählen Sie im Menü Debuggen und dann Debuggen starten aus. Zu diesem Zeitpunkt wird der Bot lokal ausgeführt.

5. Starten Sie den Bot Framework-Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Abschnitt oben beschrieben ist.

6. Senden Sie im Emulator Ihrem Bot eine Nachricht, z. B. "Hallo". Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.

   

JavaScript

Festlegen von JavaScript-Breakpoints in Visual Studio Code

In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Zum Festlegen von Breakpoints in Visual Studio Code führen Sie die folgenden Schritte aus:

1. Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.

2. Wählen Sie im Menü Debuggen und dann Debuggen starten aus. Wenn Sie zum Auswählen eines Laufzeitmoduls für das Ausführen des Codes aufgefordert werden, wählen Sie Node.js aus. Zu diesem Zeitpunkt wird der Bot lokal ausgeführt.

3. Wählen Sie die Datei vom Typ .js aus und legen Sie bei Bedarf Breakpoints fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.

   

4. Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.

5. Senden Sie Ihrem Bot über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.

   

Java

Festlegen eines Java-Breakpoints in Visual Studio Code

In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Siehe auch Erstellen eines Bots mit dem Bot Framework SDK für Java.

1. Sofern nicht bereits geschehen, installieren Sie das Java-Erweiterungspack in Visual Studio Code. Diese Erweiterung bietet umfassende Unterstützung für Java in Visual Studio Code, einschließlich Debugging.

2. Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.

3. Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.

   

4. Wählen Sie die EchoBot.java Datei aus, und fügen Sie einen Breakpoint zu einem gewünschten Speicherort hinzu.

5. Wählen Sie im Menü Ausführen und dann Debuggen starten.

6. Wählen Sie Java, wenn Sie aufgefordert werden, die aktuell ausgewählte Datei zu debuggen.

7. Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.

8. Senden Sie Ihrem Bot über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.

   

Weitere Informationen finden Sie unter Ausführen und Debuggen von Java.

Python

Festlegen von Python-Breakpoints in Visual Studio Code

In Visual Studio Code können Sie Breakpoints festlegen und den Bot im Debugmodus ausführen, um den Code schrittweise zu durchlaufen. Siehe auch Erstellen eines Bots mit dem Bot Framework SDK für Python.

1. Installieren Sie die Python-Erweiterung in Visual Studio Code, wenn Sie dies nicht bereits getan haben. Diese Erweiterung bietet umfassende Unterstützung für Python in Visual Studio Code, einschließlich Debugging.

2. Starten Sie Visual Studio Code und öffnen Sie den Ordner mit Ihrem Botprojekt.

3. Legen Sie Haltepunkte nach Bedarf fest. In Visual Studio können Sie Breakpoints festlegen, indem Sie mit dem Mauszeiger auf die Spalte links neben den Zeilennummern zeigen. Ein kleiner roter Punkt wird angezeigt. Wenn Sie den Punkt auswählen, wird der Breakpoint festgelegt. Wenn Sie den Punkt erneut auswählen, wird der Breakpoint entfernt.

   

4. Wählen Sie die Datei app.py aus.

5. Wählen Sie im Menü Debuggen und dann Debuggen starten aus.

6. Wählen Sie Python-Datei aus, um die aktuell ausgewählte Datei zu debuggen.

7. Starten Sie Bot Framework Emulator, und stellen Sie eine Verbindung mit Ihrem Bot her, wie es im Artikel Debuggen mit dem Emulator beschrieben ist.

8. Senden Sie Ihrem Bot über den Emulator eine Nachricht (senden Sie beispielsweise die Nachricht „Hi“). Die Ausführung wird an der Zeile unterbrochen, an der Sie den Haltepunkt platziert haben.

   

Weitere Informationen finden Sie unter Debuggen von Python-Code.

Zusätzliche Ressourcen

• Problembehandlung von Bot-Konfigurationsproblemen und die anderen Artikel zur Problembehandlung in diesem Abschnitt
• Debuggen mit dem Emulator

Nächste Schritte

Debuggen Ihres Bots mit Transkriptdateien