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

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.

    A screenshot of a C# breakpoint set in Visual Studio Code.

  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.

    A screenshot of a C# bot in Visual Studio Code, paused at a break point.

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.

    A screenshot of a C# breakpoint set in Visual Studio.

  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.

    A screenshot of a C# bot in Visual Studio, paused at a break point.

Additional resources

Next steps