Questo articolo descrive come eseguire il debug del bot usando un IDE, ad esempio Visual Studio o Visual Studio Code, e Bot Framework Emulator. Usare questi metodi per eseguire il debug di un bot in locale. Questo articolo usa un bot echo, ad esempio quello creato nella guida introduttiva Creare un bot .
Nota
In questo articolo viene usato Bot Framework Emulator per inviare e ricevere messaggi dal bot durante il debug. Se si stanno cercando altri modi per eseguire il debug del bot usando Bot Framework Emulator, vedere l'articolo Eseguire il debug con Bot Framework Emulator .
Nota
Gli SDK JavaScript, C# e Python di Bot Framework continueranno a essere supportati, ma Java SDK verrà ritirato con il supporto finale a lungo termine che termina a novembre 2023.
I bot esistenti creati con Java SDK continueranno a funzionare.
Impostare punti di interruzione C# in Visual Studio Code
In Visual Studio Code è possibile impostare punti di interruzione ed eseguire il bot in modalità debug per eseguire il codice passo per passo. Per impostare i punti di interruzione in Visual Studio Code, eseguire le operazioni seguenti:
Avviare Visual Studio Code e aprire la cartella del progetto bot.
Impostare i punti di interruzione secondo necessità. Per impostare un punto di interruzione, posizionare il puntatore del mouse sulla colonna a sinistra dei numeri di riga. Verrà visualizzato un puntino rosso. Se si seleziona il puntino, viene impostato il punto di interruzione. Se si seleziona di nuovo il puntino, il punto di interruzione viene rimosso.
Nella barra dei menu selezionare Esegui, quindi Avvia debug. Il bot inizierà a essere eseguito in modalità di debug dal terminale in Visual Studio Code.
Dall'emulatore inviare un messaggio al bot( ad esempio, inviare il messaggio "Hi"). L'esecuzione verrà interrotta in corrispondenza della riga in cui è stato inserito il punto di interruzione.
Impostare punti di interruzione C# in Visual Studio
In Visual Studio è possibile impostare punti di interruzione ed eseguire il bot in modalità di debug per scorrere il codice. Per impostare i punti di interruzione in Visual Studio, eseguire le operazioni seguenti:
Passare alla cartella del bot e aprire il file .sln. La soluzione verrà aperta in Visual Studio.
Nella barra dei menu selezionare Compila e selezionare Compila soluzione.
In Esplora soluzioni selezionare il file CS e impostare i punti di interruzione in base alle esigenze. Questo file definisce la logica principale del bot. Per impostare un punto di interruzione, posizionare il puntatore del mouse sulla colonna a sinistra dei numeri di riga. Verrà visualizzato un piccolo punto. Se si seleziona il puntino, viene impostato il punto di interruzione. Se si seleziona di nuovo il puntino, il punto di interruzione viene rimosso.
Dal menu selezionare Debug, quindi Avvia debug. A questo punto il bot è in esecuzione in locale.
Avviare Bot Framework Emulator e connettersi al bot come descritto nella sezione precedente.
Dall'emulatore inviare al bot un messaggio, ad esempio "Hi". L'esecuzione verrà interrotta in corrispondenza della riga in cui è stato inserito il punto di interruzione.
Impostare punti di interruzione JavaScript in Visual Studio Code
In Visual Studio Code è possibile impostare punti di interruzione ed eseguire il bot in modalità debug per eseguire il codice passo per passo. Per impostare i punti di interruzione in Visual Studio Code, eseguire le operazioni seguenti:
Avviare Visual Studio Code e aprire la cartella del progetto bot.
Nella barra dei menu selezionare Debug e quindi avvia debug. Se viene richiesto di selezionare un motore di runtime per eseguire il codice, selezionare Node.js. A questo punto il bot è in esecuzione in locale.
Selezionare il file JS e impostare i punti di interruzione in base alle esigenze. Per impostare un punto di interruzione, posizionare il puntatore del mouse sulla colonna a sinistra dei numeri di riga. Verrà visualizzato un puntino rosso. Se si seleziona il puntino, viene impostato il punto di interruzione. Se si seleziona di nuovo il puntino, il punto di interruzione viene rimosso.
Dall'emulatore inviare un messaggio al bot( ad esempio, inviare il messaggio "Hi"). L'esecuzione verrà interrotta in corrispondenza della riga in cui è stato inserito il punto di interruzione.
Impostare punti di interruzione Java in Visual Studio Code
In Visual Studio Code è possibile impostare punti di interruzione ed eseguire il bot in modalità debug per eseguire il codice passo per passo. Vedere anche Creare un bot con Bot Framework SDK per Java.
Installare Java Extension Pack in Visual Studio Code, se non è già stato fatto. Questa estensione offre un supporto avanzato per Java in Visual Studio Code, incluso il debug.
Avviare Visual Studio Code e aprire la cartella del progetto bot.
Impostare i punti di interruzione secondo necessità. Per impostare un punto di interruzione, posizionare il puntatore del mouse sulla colonna a sinistra dei numeri di riga. Verrà visualizzato un puntino rosso. Se si seleziona il puntino, viene impostato il punto di interruzione. Se si seleziona di nuovo il puntino, il punto di interruzione viene rimosso.
Selezionare il EchoBot.java file e aggiungere un punto di interruzione a un percorso desiderato.
Nella barra dei menu selezionare Esegui e quindi avvia debug.
Selezionare Java se viene richiesto di eseguire il debug del file attualmente selezionato.
Dall'emulatore inviare un messaggio al bot( ad esempio, inviare il messaggio "Hi"). L'esecuzione verrà interrotta in corrispondenza della riga in cui è stato inserito il punto di interruzione.
Impostare punti di interruzione Python in Visual Studio Code
In Visual Studio Code è possibile impostare punti di interruzione ed eseguire il bot in modalità debug per eseguire il codice passo per passo. Vedere anche Creare un bot con Bot Framework SDK per Python.
Installare l'estensione Python in Visual Studio Code, se non è già stato fatto. Questa estensione offre supporto avanzato per Python in Visual Studio Code, incluso il debug.
Avviare Visual Studio Code e aprire la cartella del progetto bot.
Impostare i punti di interruzione secondo necessità. Per impostare un punto di interruzione, posizionare il puntatore del mouse sulla colonna a sinistra dei numeri di riga. Verrà visualizzato un puntino rosso. Se si seleziona il puntino, viene impostato il punto di interruzione. Se si seleziona di nuovo il puntino, il punto di interruzione viene rimosso.
Selezionare il file app.py.
Nella barra dei menu selezionare Debug e quindi avvia debug.
Selezionare File Python per eseguire il debug del file selezionato.
Dall'emulatore inviare un messaggio al bot( ad esempio, inviare il messaggio "Hi"). L'esecuzione verrà interrotta in corrispondenza della riga in cui è stato inserito il punto di interruzione.