This article describes how to debug your bot using an IDE, such as Visual Studio or Visual Studio Code, and the Bot Framework Emulator. Use these methods to debug a bot locally. This article uses an echo bot, such as the one created in the Create a bot quickstart.
Note
In this article, we use the Bot Framework Emulator to send and receive messages from the bot during debugging. If you're looking for other ways to debug your bot using the Bot Framework Emulator, please read the Debug with the Bot Framework Emulator article.
Note
The Bot Framework JavaScript, C#, and Python SDKs will continue to be supported, however, the Java SDK is being retired with final long-term support ending in November 2023.
Existing bots built with the Java SDK will continue to function.
In Visual Studio Code, you can set breakpoints and run the bot in debug mode to step through your code. To set breakpoints in Visual Studio Code, do the following:
Launch Visual Studio Code and open your bot project folder.
Set breakpoints as necessary. To set a breakpoint, hover your mouse over the column to the left of the line numbers. A small red dot will appear. If you select the dot, the breakpoint is set. If you select the dot again, the breakpoint is removed.
From the menu bar, select Run, then Start Debugging. Your bot will start running in debugging mode from the Terminal in Visual Studio Code.
From the Emulator, send your bot a message (for example, send the message "Hi"). Execution will stop at the line where you place the breakpoint.
Set C# breakpoints in Visual Studio
In Visual Studio, you can set breakpoints and run the bot in debug mode to step through your code. To set breakpoints in Visual Studio, do the following:
Navigate to your bot folder and open the .sln file. This will open the solution in Visual Studio.
From the menu bar, select Build and select Build Solution.
In the Solution Explorer, select the .cs file and set breakpoints as necessary. This file defines your main bot logic. To set a breakpoint, hover your mouse over the column to the left of the line numbers. A small dot will appear. If you select the dot, the breakpoint is set. If you select the dot again, the breakpoint is removed.
From the menu, select Debug, then Start Debugging. At this point, the bot is running locally.
Start the Bot Framework Emulator and connect to your bot as described in the section above.
From the Emulator, send your bot a message, such as "Hi". Execution will stop at the line where you place the breakpoint.
Set JavaScript breakpoints in Visual Studio Code
In Visual Studio Code, you can set breakpoints and run the bot in debug mode to step through your code. To set breakpoints in Visual Studio Code, do the following:
Launch Visual Studio Code and open your bot project folder.
From the menu bar, select Debug and then select Start Debugging. If you're prompted to select a runtime engine to run your code, select Node.js. At this point, the bot is running locally.
Select the .js file and set breakpoints as necessary. To set a breakpoint, hover your mouse over the column to the left of the line numbers. A small red dot will appear. If you select the dot, the breakpoint is set. If you select the dot again, the breakpoint is removed.
Install the Java Extension Pack in Visual Studio Code, if you haven't already done so. This extension provides rich support for Java in Visual Studio Code, including debugging.
Launch Visual Studio Code and open your bot project folder.
Set breakpoints as necessary. To set a breakpoint, hover your mouse over the column to the left of the line numbers. A small red dot will appear. If you select the dot, the breakpoint is set. If you select the dot again, the breakpoint is removed.
Select the EchoBot.java file and add a breakpoint to a desired location.
From the menu bar, select Run and then select Start Debugging.
Select Java if prompted to debug the currently selected file.
Install the Python extension in Visual Studio Code, if you haven't already done so. This extension provides rich support for Python in Visual Studio Code, including debugging.
Launch Visual Studio Code and open your bot project folder.
Set breakpoints as necessary. To set a breakpoint, hover your mouse over the column to the left of the line numbers. A small red dot will appear. If you select the dot, the breakpoint is set. If you select the dot again, the breakpoint is removed.
Select the app.py file.
From the menu bar, select Debug and then select Start Debugging.
Select Python File to debug the currently selected file.