Dynamics 365 Business Central: debugging agent sessions.

In the latest AL Language extension for the 2026 release wave 1 release (runtime 17.0) Microsoft introduced the possibility to debug agent sessions from Visual Studio Code.

With this 17.x release it’s possible to attach to agent sessions and debug the AL code they are executing. To do so, the new client type Agent has been introduced along with two new launch configurations to attach to an agent session on a cloud sandbox or your own server.

To debug an agent session in a cloud sandbox, you can use the following configuration (passing the security ID of your agent configuration):

To debug an agent session in your on-premise environment, you can use the following configuration:

With these configirations the snapshot debugging will stop at the next agent session identified by the specified user security id. You can also use the sessionId parameter to connect to the specific agent session. In this way you can inspect what an agent is doing in your application (because also AI sometimes must be monitored ).

You will learn more about agents in Dynamics 365 Business Central in the next weeks. In the meanwhile, I refresh you with this:

Original Post https://demiliani.com/2025/10/21/dynamics-365-business-central-debugging-agent-sessions/