Fouten opsporen in een SDK-eerste bot

VAN TOEPASSING OP: SDK v4

In dit artikel wordt beschreven hoe u fouten kunt opsporen in uw bot met behulp van een IDE, zoals Visual Studio of Visual Studio Code, en de Bot Framework Emulator. Gebruik deze methoden om lokaal fouten in een bot op te sporen. In dit artikel wordt een echo bot gebruikt, zoals de bot die is gemaakt in de Create a bot quickstart.

Notitie

In dit artikel gebruiken we de Bot Framework Emulator om berichten van de bot te verzenden en te ontvangen tijdens foutopsporing. Als u op zoek bent naar andere manieren om fouten in uw bot op te sporen met behulp van de Bot Framework Emulator, leest u het artikel Debug with the Bot Framework Emulator .

Notitie

De Sdk's voor Bot Framework JavaScript, C# en Python blijven ondersteund, maar de Java SDK wordt buiten gebruik gesteld met definitieve langetermijnondersteuning die eindigt op november 2023.

Bestaande bots die zijn gebouwd met de Java SDK blijven functioneren.

Voor het bouwen van nieuwe bots kunt u Microsoft Copilot Studio gebruiken en lezen over het kiezen van de juiste copilot-oplossing.

Zie De toekomst van botbouw voor meer informatie.

Vereisten

• Download en installeer de Bot Framework Emulator.
• Download en installeer Visual Studio Code of Visual Studio.

C#

C#-onderbrekingspunten instellen in Visual Studio Code

In Visual Studio Code kunt u onderbrekingspunten instellen en de bot uitvoeren in de foutopsporingsmodus om uw code te doorlopen. Ga als volgt te werk om onderbrekingspunten in Visual Studio Code in te stellen:

1. Start Visual Studio Code en open de projectmap van uw bot.

2. Stel indien nodig onderbrekingspunten in. Als u een onderbrekingspunt wilt instellen, beweegt u de muisaanwijzer over de kolom links van de regelnummers. Er verschijnt een kleine rode stip. Als u de stip selecteert, wordt het onderbrekingspunt ingesteld. Als u de stip opnieuw selecteert, wordt het onderbrekingspunt verwijderd.

   

3. Selecteer Uitvoeren in de menubalk en klik vervolgens op Start Foutopsporing. Uw bot zal in debugging-modus starten vanuit de Terminal in Visual Studio Code.

4. Start de Bot Framework Emulator en maak verbinding met uw bot, zoals beschreven in het opsporen van fouten met de Bot Framework Emulator.

5. Verzend vanuit de emulator een bericht naar uw bot (bijvoorbeeld het bericht 'Hallo'). De uitvoering wordt gestopt op de regel waar u een onderbrekingspunt plaatst.

   

C#-onderbrekingspunten instellen in Visual Studio

In Visual Studio kunt u onderbrekingspunten instellen en de bot uitvoeren in de foutopsporingsmodus om uw code te doorlopen. Ga als volgt te werk om onderbrekingspunten in Te stellen in Visual Studio:

1. Ga naar de map met de bot en open het .sln-bestand. De oplossing wordt nu geopend in Visual Studio.

2. Selecteer in de menubalk Build en selecteer Build Solution.

3. Selecteer in Solution Explorer het .cs-bestand en stel zo nodig de onderbrekingspunten in. In dit bestand wordt de hoofdlogica van uw bot gedefinieerd. Als u een onderbrekingspunt wilt instellen, beweegt u de muisaanwijzer over de kolom links van de regelnummers. Er wordt een kleine stip weergegeven. Als u de stip selecteert, wordt het onderbrekingspunt ingesteld. Als u de stip opnieuw selecteert, wordt het onderbrekingspunt verwijderd.

   

4. Selecteer Fouten opsporen in het menu en start foutopsporing. Vanaf dit moment wordt de bot lokaal uitgevoerd.

5. Start Bot Framework Emulator en maak verbinding met uw bot zoals beschreven in de bovenstaande sectie.

6. Verzend uw bot vanuit de emulator een bericht, zoals 'Hallo'. De uitvoering stopt op de regel waar u het onderbrekingspunt plaatst.

   

JavaScript

JavaScript-onderbrekingspunten instellen in Visual Studio Code

In Visual Studio Code kunt u onderbrekingspunten instellen en de bot uitvoeren in de foutopsporingsmodus om uw code te doorlopen. Ga als volgt te werk om onderbrekingspunten in Visual Studio Code in te stellen:

1. Start Visual Studio Code en open de projectmap van uw bot.

2. Selecteer in de menubalk Debuggen en selecteer vervolgens Debuggen starten. Als u wordt gevraagd om een runtime-engine te selecteren om uw code uit te voeren, selecteert u Node.js. Vanaf dit moment draait de bot lokaal.

3. Selecteer het .js-bestand en stel zo nodig de onderbrekingspunten in. Als u een onderbrekingspunt wilt instellen, beweegt u de muisaanwijzer over de kolom links van de regelnummers. Er zal een kleine rode stip verschijnen. Als u de stip selecteert, wordt het onderbrekingspunt ingesteld. Als u de stip opnieuw selecteert, wordt het onderbrekingspunt verwijderd.

   

4. Start de Bot Framework Emulator en maak verbinding met je bot, zoals beschreven in het artikel Foutopsporing met de Bot Framework Emulator.

5. Verzend vanuit de emulator een bericht naar uw bot (bijvoorbeeld het bericht 'Hallo'). De uitvoering wordt gestopt op de regel waar u het onderbrekingspunt plaatst.

   

Java

Java-onderbrekingspunten instellen in Visual Studio Code

In Visual Studio Code kunt u onderbrekingspunten instellen en de bot uitvoeren in de foutopsporingsmodus om uw code te doorlopen. Zie ook Een bot maken met de Bot Framework SDK voor Java.

1. Installeer het Java Extension Pack in Visual Studio Code als u dit nog niet hebt gedaan. Deze extensie biedt uitgebreide ondersteuning voor Java in Visual Studio Code, waaronder foutopsporing.

2. Start Visual Studio Code en open de projectmap van uw bot.

3. Stel indien nodig onderbrekingspunten in. Als u een onderbrekingspunt wilt instellen, beweegt u de muisaanwijzer over de kolom links van de regelnummers. Er zal een kleine rode stip verschijnen. Als u de stip selecteert, wordt het onderbrekingspunt ingesteld. Als u de stip opnieuw selecteert, wordt het onderbrekingspunt verwijderd.

   

4. Selecteer het EchoBot.java bestand en voeg een onderbrekingspunt toe aan een gewenste locatie.

5. Selecteer in de menubalk Uitvoeren en selecteer dan Start foutopsporing.

6. Selecteer Java als u wordt gevraagd om fouten op te sporen in het geselecteerde bestand.

7. Start de Bot Framework Emulator en maak verbinding met uw bot, zoals beschreven in het artikel Foutopsporing met de Bot Framework Emulator.

8. Verzend vanuit de emulator een bericht naar uw bot (bijvoorbeeld het bericht 'Hallo'). De uitvoering stopt op de regel waar u het onderbrekingspunt plaatst.

   

Zie Uitvoeren en fouten opsporen in Java voor meer informatie.

Python

Python-onderbrekingspunten instellen in Visual Studio Code

In Visual Studio Code kunt u onderbrekingspunten instellen en de bot uitvoeren in de foutopsporingsmodus om uw code te doorlopen. Zie ook Een bot maken met de Bot Framework SDK voor Python.

1. Installeer de Python-extensie in Visual Studio Code als u dit nog niet hebt gedaan. Deze extensie biedt uitgebreide ondersteuning voor Python in Visual Studio Code, waaronder foutopsporing.

2. Start Visual Studio Code en open de projectmap van uw bot.

3. Stel indien nodig onderbrekingspunten in. Als u een onderbrekingspunt wilt instellen, beweegt u de muisaanwijzer over de kolom links van de regelnummers. Er zal een kleine rode stip verschijnen. Als u de stip selecteert, wordt het onderbrekingspunt ingesteld. Als u de stip opnieuw selecteert, wordt het onderbrekingspunt verwijderd.

   

4. Selecteer het bestand app.py.

5. Selecteer Debuggen in de menubalk en selecteer vervolgens Debuggen starten.

6. Selecteer Python-bestand om fouten op te sporen in het geselecteerde bestand.

7. Begin de Bot Framework Emulator en maak verbinding met uw bot, zoals beschreven in het artikel Debuggen met de Bot Framework Emulator.

8. Verzend vanuit de emulator een bericht naar uw bot (bijvoorbeeld het bericht 'Hallo'). Het uitvoeren zal stoppen bij de regel waar je het breakpoint plaatst.

   

Zie Fouten opsporen in uw Python-code voor meer informatie.

Aanvullende bronnen

• Los problemen met botconfiguratie op en met de andere artikelen over probleemoplossing in die sectie.
• Fouten opsporen met de emulator.

Volgende stappen

Fouten opsporen in uw bot met behulp van transcriptbestanden.