Eseguire il debug di un bot SDK-first

  • Articolo

SI APPLICA A: SDK v4

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.

Per la creazione di nuovi bot, è consigliabile usare Microsoft Copilot Studio e leggere le informazioni sulla scelta della soluzione copilota appropriata.

Per altre informazioni, vedere Il futuro della compilazione di bot.

Prerequisiti

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:

  1. Avviare Visual Studio Code e aprire la cartella del progetto bot.

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

    Screenshot di un punto di interruzione C# impostato in Visual Studio Code.

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

  4. Avviare Bot Framework Emulator e connettersi al bot come descritto in Come eseguire il debug con Bot Framework Emulator.

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

    Screenshot di un bot C# in Visual Studio Code, sospeso in un 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:

  1. Passare alla cartella del bot e aprire il file .sln. La soluzione verrà aperta in Visual Studio.

  2. Nella barra dei menu selezionare Compila e selezionare Compila soluzione.

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

    Screenshot di un punto di interruzione C# impostato in Visual Studio.

  4. Dal menu selezionare Debug, quindi Avvia debug. A questo punto il bot è in esecuzione in locale.

  5. Avviare Bot Framework Emulator e connettersi al bot come descritto nella sezione precedente.

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

    Screenshot di un bot C# in Visual Studio, sospeso in un punto di interruzione.

Risorse aggiuntive

Passaggi successivi

Eseguire il debug del bot usando i file di trascrizione.