Debug an SDK-first bot

APPLIES TO: SDK v4

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.

For new bot building, consider using Microsoft Copilot Studio and read about choosing the right copilot solution.

For more information, see The future of bot building.

Prerequisites

• Download and install the Bot Framework Emulator.
• Download and install Visual Studio Code or Visual Studio.

C#

Set C# 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:

1. Launch Visual Studio Code and open your bot project folder.

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

   

3. From the menu bar, select Run, then Start Debugging. Your bot will start running in debugging mode from the Terminal in Visual Studio Code.

4. Start the Bot Framework Emulator and connect to your bot as described in how to Debug with the Bot Framework Emulator.

5. 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:

1. Navigate to your bot folder and open the .sln file. This will open the solution in Visual Studio.

2. From the menu bar, select Build and select Build Solution.

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

   

4. From the menu, select Debug, then Start Debugging. At this point, the bot is running locally.

5. Start the Bot Framework Emulator and connect to your bot as described in the section above.

6. From the Emulator, send your bot a message, such as "Hi". Execution will stop at the line where you place the breakpoint.

   

JavaScript

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:

1. Launch Visual Studio Code and open your bot project folder.

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

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

   

4. Start the Bot Framework Emulator and connect to your bot as described in the Debug with the Bot Framework Emulator article.

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

   

Java

Set Java 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. See also Create a bot with the Bot Framework SDK for Java.

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

2. Launch Visual Studio Code and open your bot project folder.

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

   

4. Select the EchoBot.java file and add a breakpoint to a desired location.

5. From the menu bar, select Run and then select Start Debugging.

6. Select Java if prompted to debug the currently selected file.

7. Start the Bot Framework Emulator and connect to your bot as described in the Debug with the Bot Framework Emulator article.

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

   

For more information, see Running and debugging Java.

Python

Set Python 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. See also Create a bot with the Bot Framework SDK for Python.

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

2. Launch Visual Studio Code and open your bot project folder.

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

   

4. Select the app.py file.

5. From the menu bar, select Debug and then select Start Debugging.

6. Select Python File to debug the currently selected file.

7. Start the Bot Framework Emulator and connect to your bot as described in the Debug with the Bot Framework Emulator article.

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

   

For more information, see Debug your Python code.

Additional resources

• Troubleshoot bot configuration issues and the other troubleshooting articles in that section.
• Debug with the Emulator.

Next steps

Debug your bot using transcript files.