Debugowanie bota pierwszego zestawu SDK

DOTYCZY: ZESTAW SDK w wersji 4

W tym artykule opisano sposób debugowania bota przy użyciu środowiska IDE, takiego jak Visual Studio lub Visual Studio Code, oraz Bot Framework Emulator. Użyj tych metod, aby debugować bota lokalnie. W tym artykule użyto bota echa, takiego jak bot utworzony w przewodniku Szybki start Tworzenie bota .

Uwaga

W tym artykule używamy emulatora platformy Bot Framework do wysyłania i odbierania komunikatów z bota podczas debugowania. Jeśli szukasz innych sposobów debugowania bota przy użyciu emulatora platformy Bot Framework, przeczytaj artykuł Debugowanie za pomocą bot framework emulatora .

Uwaga

Zestawy SDK języka JavaScript, C# i Python platformy Bot Framework będą nadal obsługiwane, jednak zestaw SDK języka Java jest wycofywany z ostatecznym długoterminowym wsparciem kończącym się w listopadzie 2023 r.

Istniejące boty utworzone za pomocą zestawu JAVA SDK będą nadal działać.

W przypadku tworzenia nowych botów rozważ użycie programu Microsoft Copilot Studio i przeczytaj o wyborze odpowiedniego rozwiązania copilot.

Aby uzyskać więcej informacji, zobacz Przyszłość tworzenia botów.

Wymagania wstępne

• Pobierz i zainstaluj program Bot Framework Emulator.
• Pobierz i zainstaluj program Visual Studio Code lub Visual Studio.

C#

Ustawianie punktów przerwania języka C# w programie Visual Studio Code

W programie Visual Studio Code można ustawić punkty przerwania i uruchomić bota w trybie debugowania, aby przejść przez kolejne etapy kodu. Aby ustawić punkty przerwania w programie Visual Studio Code, wykonaj następujące czynności:

1. Uruchom program Visual Studio Code i otwórz folder projektu bota.

2. Ustaw punkty przerwania zgodnie z potrzebami. Aby ustawić punkt przerwania, umieść wskaźnik myszy na kolumnie po lewej stronie numerów wierszy. Zostanie wyświetlona mała czerwona kropka. Wybranie kropki spowoduje ustawienie punktu przerwania. Ponowne wybranie kropki spowoduje usunięcie punktu przerwania.

   

3. Na pasku menu wybierz pozycję Uruchom, a następnie uruchom debugowanie. Bot zacznie działać w trybie debugowania z poziomu terminalu w programie Visual Studio Code.

4. Uruchom program Bot Framework Emulator i połącz się z botem zgodnie z opisem w temacie Debugowanie za pomocą emulatora bot framework.

5. Z poziomu emulatora wyślij do bota komunikat (na przykład wyślij komunikat "Cześć"). Wykonanie zostanie zatrzymane w wierszu, w którym umieszczono punkt przerwania.

   

Ustawianie punktów przerwania języka C# w programie Visual Studio

W programie Visual Studio można ustawić punkty przerwania i uruchomić bota w trybie debugowania, aby przejść przez kod. Aby ustawić punkty przerwania w programie Visual Studio, wykonaj następujące czynności:

1. Przejdź do folderu bota i otwórz plik .sln. Spowoduje to otwarcie rozwiązania w programie Visual Studio.

2. Na pasku menu wybierz pozycję Kompiluj i wybierz pozycję Kompiluj rozwiązanie.

3. W Eksploratorze rozwiązań wybierz plik cs i ustaw punkty przerwania zgodnie z potrzebami. Ten plik definiuje podstawową logikę bota. Aby ustawić punkt przerwania, umieść wskaźnik myszy na kolumnie po lewej stronie numerów wierszy. Zostanie wyświetlona mała kropka. Wybranie kropki spowoduje ustawienie punktu przerwania. Ponowne wybranie kropki spowoduje usunięcie punktu przerwania.

   

4. Z menu wybierz pozycję Debuguj, a następnie rozpocznij debugowanie. W tym momencie bot jest uruchamiany lokalnie.

5. Uruchom aplikację Bot Framework Emulator i połącz się z botem zgodnie z opisem w powyższej sekcji.

6. Z poziomu emulatora wyślij do bota komunikat, taki jak "Cześć". Wykonanie zostanie zatrzymane w wierszu, w którym umieszczono punkt przerwania.

   

JavaScript

Ustawianie punktów przerwania języka JavaScript w programie Visual Studio Code

W programie Visual Studio Code można ustawić punkty przerwania i uruchomić bota w trybie debugowania, aby przejść przez kolejne etapy kodu. Aby ustawić punkty przerwania w programie Visual Studio Code, wykonaj następujące czynności:

1. Uruchom program Visual Studio Code i otwórz folder projektu bota.

2. Na pasku menu wybierz pozycję Debuguj , a następnie wybierz pozycję Rozpocznij debugowanie. Jeśli zostanie wyświetlony monit o wybranie aparatu środowiska uruchomieniowego do uruchomienia kodu, wybierz pozycję Node.js. W tym momencie bot jest uruchamiany lokalnie.

3. Wybierz plik js i ustaw punkty przerwania zgodnie z potrzebami. Aby ustawić punkt przerwania, umieść wskaźnik myszy na kolumnie po lewej stronie numerów wierszy. Zostanie wyświetlona mała czerwona kropka. Wybranie kropki spowoduje ustawienie punktu przerwania. Ponowne wybranie kropki spowoduje usunięcie punktu przerwania.

   

4. Uruchom program Bot Framework Emulator i połącz się z botem zgodnie z opisem w artykule Debugowanie za pomocą programu Bot Framework Emulator .

5. Z poziomu emulatora wyślij do bota komunikat (na przykład wyślij komunikat "Cześć"). Wykonanie zostanie zatrzymane w wierszu, w którym umieszczono punkt przerwania.

   

Java

Ustawianie punktów przerwania języka Java w programie Visual Studio Code

W programie Visual Studio Code można ustawić punkty przerwania i uruchomić bota w trybie debugowania, aby przejść przez kolejne etapy kodu. Zobacz też Tworzenie bota przy użyciu zestawu Bot Framework SDK dla języka Java.

1. Zainstaluj pakiet rozszerzenia Java w programie Visual Studio Code, jeśli jeszcze tego nie zrobiono. To rozszerzenie zapewnia zaawansowaną obsługę języka Java w programie Visual Studio Code, w tym debugowanie.

2. Uruchom program Visual Studio Code i otwórz folder projektu bota.

3. Ustaw punkty przerwania zgodnie z potrzebami. Aby ustawić punkt przerwania, umieść wskaźnik myszy na kolumnie po lewej stronie numerów wierszy. Zostanie wyświetlona mała czerwona kropka. Wybranie kropki spowoduje ustawienie punktu przerwania. Ponowne wybranie kropki spowoduje usunięcie punktu przerwania.

   

4. EchoBot.java Wybierz plik i dodaj punkt przerwania do żądanej lokalizacji.

5. Na pasku menu wybierz pozycję Uruchom , a następnie wybierz pozycję Rozpocznij debugowanie.

6. Wybierz pozycję Java , jeśli zostanie wyświetlony monit o debugowanie aktualnie wybranego pliku.

7. Uruchom program Bot Framework Emulator i połącz się z botem zgodnie z opisem w artykule Debugowanie za pomocą programu Bot Framework Emulator .

8. Z poziomu emulatora wyślij do bota komunikat (na przykład wyślij komunikat "Cześć"). Wykonanie zostanie zatrzymane w wierszu, w którym umieszczono punkt przerwania.

   

Aby uzyskać więcej informacji, zobacz Uruchamianie i debugowanie języka Java.

Python

Ustawianie punktów przerwania języka Python w programie Visual Studio Code

W programie Visual Studio Code można ustawić punkty przerwania i uruchomić bota w trybie debugowania, aby przejść przez kolejne etapy kodu. Zobacz też Tworzenie bota przy użyciu zestawu Bot Framework SDK dla języka Python.

1. Zainstaluj rozszerzenie języka Python w programie Visual Studio Code, jeśli jeszcze tego nie zrobiono. To rozszerzenie zapewnia zaawansowaną obsługę języka Python w programie Visual Studio Code, w tym debugowanie.

2. Uruchom program Visual Studio Code i otwórz folder projektu bota.

3. Ustaw punkty przerwania zgodnie z potrzebami. Aby ustawić punkt przerwania, umieść wskaźnik myszy na kolumnie po lewej stronie numerów wierszy. Zostanie wyświetlona mała czerwona kropka. Wybranie kropki spowoduje ustawienie punktu przerwania. Ponowne wybranie kropki spowoduje usunięcie punktu przerwania.

   

4. app.py Wybierz plik.

5. Na pasku menu wybierz pozycję Debuguj , a następnie wybierz pozycję Rozpocznij debugowanie.

6. Wybierz pozycję Plik języka Python, aby debugować aktualnie wybrany plik.

7. Uruchom program Bot Framework Emulator i połącz się z botem zgodnie z opisem w artykule Debugowanie za pomocą programu Bot Framework Emulator .

8. Z poziomu emulatora wyślij do bota komunikat (na przykład wyślij komunikat "Cześć"). Wykonanie zostanie zatrzymane w wierszu, w którym umieszczono punkt przerwania.

   

Aby uzyskać więcej informacji, zobacz Debugowanie kodu w języku Python.

Dodatkowe zasoby

• Rozwiąż problemy z konfiguracją bota i inne artykuły dotyczące rozwiązywania problemów w tej sekcji.
• Debugowanie za pomocą emulatora.

Następne kroki

Debugowanie bota przy użyciu plików transkrypcji.