Este artigo descreve como depurar seu bot usando um IDE, como o Visual Studio ou Visual Studio Code e o Bot Framework Emulator. Use esses métodos para depurar um bot localmente. Este artigo usa um bot de eco, como o criado no início rápido Criar um bot.
Observação
Neste artigo, usamos o Bot Framework Emulator para enviar e receber mensagens do bot durante a depuração. Se você estiver procurando outras maneiras de depurar o bot usando o Bot Framework Emulator, leia o artigo Depurar com o Bot Framework Emulator.
Observação
Os SDKs JavaScript, C# e Python do Bot Framework continuarão a ser compatíveis. No entanto, o SDK Java está sendo desativado, com o suporte final de longo prazo terminando em novembro de 2023.
Os bots existentes criados com o SDK para Java continuarão a funcionar.
Defina pontos de interrupção C# no Visual Studio Code
No Visual Studio Code, você pode definir pontos de interrupção e executar o bot no modo de depuração para percorrer seu código. Para definir pontos de interrupção no Visual Studio Code, faça o seguinte:
Inicie o Visual Studio Code e abra a pasta de projeto do bot.
Defina os pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números das linhas. Um pequeno ponto vermelho será exibido. Se você selecionar o ponto, o ponto de interrupção será definido. Se você selecionar o ponto novamente, o ponto de interrupção será removido.
Na barra de menus, selecione Executar e Iniciar a Depuração. O bot começará a ser executado no modo de depuração do Terminal no Visual Studio Code.
Do emulador, envie uma mensagem ao bot (por exemplo: envie a mensagem "Olá"). A execução será interrompida na linha onde você colocar o ponto de interrupção.
Defina pontos de interrupção C# no Visual Studio
No Visual Studio, você pode definir pontos de interrupção e executar o bot no modo de depuração para percorrer seu código. Para definir pontos de interrupção no Visual Studio, faça o seguinte:
Navegue até a pasta de bot e abra o arquivo .sln. Isso abrirá a solução no Visual Studio.
Na barra de menus, selecione Compilar e selecione Compilar Solução.
No Gerenciador de Soluções, selecione o arquivo .cs e defina os pontos de interrupção conforme necessário. Esse arquivo define sua lógica principal do bot. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números das linhas. Um pequeno ponto será exibido. Se você selecionar o ponto, o ponto de interrupção será definido. Se você selecionar o ponto novamente, o ponto de interrupção será removido.
No menu, selecione Depurar e Iniciar a Depuração. Neste ponto, o bot está em execução localmente.
Inicie o emulador de Bot Framework e conecte-se ao seu bot, conforme descrito na seção acima.
No emulador, envie ao bot uma mensagem, como "Oi". A execução será interrompida na linha onde você colocar o ponto de interrupção.
Definir pontos de interrupção JavaScript no Visual Studio Code
No Visual Studio Code, você pode definir pontos de interrupção e executar o bot no modo de depuração para percorrer seu código. Para definir pontos de interrupção no Visual Studio Code, faça o seguinte:
Inicie o Visual Studio Code e abra a pasta de projeto do bot.
Na barra de menus, selecione Depurar e, em seguida, selecione Iniciar a Depuração. Se você for solicitado a selecionar um mecanismo de runtime para executar seu código, selecione Node. js. Neste ponto, o bot está em execução localmente.
Selecione o arquivo .js e defina os pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números das linhas. Um pequeno ponto vermelho será exibido. Se você selecionar o ponto, o ponto de interrupção será definido. Se você selecionar o ponto novamente, o ponto de interrupção será removido.
Do emulador, envie uma mensagem ao bot (por exemplo: envie a mensagem "Olá"). A execução será interrompida na linha onde você colocar o ponto de interrupção.
Definir pontos de interrupção Java no Visual Studio Code
Instale o Java Extension Pack no Visual Studio Code, caso ainda não tenha feito isso. Essa extensão fornece suporte avançado para Java no Visual Studio Code, incluindo a depuração.
Inicie o Visual Studio Code e abra a pasta de projeto do bot.
Defina os pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números das linhas. Um pequeno ponto vermelho será exibido. Se você selecionar o ponto, o ponto de interrupção será definido. Se você selecionar o ponto novamente, o ponto de interrupção será removido.
Selecione o arquivo EchoBot.java e adicione um ponto de interrupção a um local desejado.
Na barra de menus, selecione Executar e, em seguida, selecione Iniciar a Depuração.
Selecione Java se solicitado a depurar o arquivo selecionado no momento.
Do emulador, envie uma mensagem ao bot (por exemplo: envie a mensagem "Olá"). A execução será interrompida na linha onde você colocar o ponto de interrupção.
Instale a extensão Python no Visual Studio Code, caso você ainda não o tenha feito. Essa extensão fornece suporte avançado para Python no Visual Studio Code, incluindo a depuração.
Inicie o Visual Studio Code e abra a pasta de projeto do bot.
Defina os pontos de interrupção conforme necessário. Para definir um ponto de interrupção, passe o mouse sobre a coluna à esquerda dos números das linhas. Um pequeno ponto vermelho será exibido. Se você selecionar o ponto, o ponto de interrupção será definido. Se você selecionar o ponto novamente, o ponto de interrupção será removido.
Selecione o arquivo app.py.
Na barra de menus, selecione Depurar e, em seguida, selecione Iniciar a Depuração.
Selecione Arquivo do Python para depurar o arquivo selecionado.
Do emulador, envie uma mensagem ao bot (por exemplo: envie a mensagem "Olá"). A execução será interrompida na linha onde você colocar o ponto de interrupção.
