Fouten opsporen in uw bot met transcriptiebestanden

VAN TOEPASSING OP: SDK v4

Een van de sleutels voor een geslaagde test en foutopsporing van een bot is de mogelijkheid om de set voorwaarden vast te leggen en te onderzoeken die optreden bij het uitvoeren van uw bot. In dit artikel wordt het maken en gebruiken van een bottranscriptiebestand besproken om een gedetailleerde set gebruikersinteracties en botreacties te bieden voor het testen en opsporen van fouten.

Het transcriptbestand van de bot

Een bottranscriptiebestand is een gespecialiseerd JSON-bestand dat de interacties tussen een gebruiker en uw bot behoudt. Een transcriptiebestand behoudt niet alleen de inhoud van een bericht, maar ook interactiedetails zoals de gebruikers-id, kanaal-id, kanaaltype, kanaalmogelijkheden, tijd van de interactie, enzovoort. Al deze informatie kan vervolgens worden gebruikt om problemen te vinden en op te lossen bij het testen of opsporen van fouten in uw bot.

Een transcriptiebestand voor een bot maken/opslaan

In dit artikel wordt beschreven hoe u transcriptiebestanden voor bot maakt met behulp van de Bot Framework Emulator. Transcriptbestanden kunnen ook programmatisch worden gemaakt; zie blobtranscriptieopslag voor meer informatie over die aanpak. In dit artikel gebruiken we de Bot Framework-voorbeeldcode voor multi-turn prompt-bot die de transportmodus, naam en leeftijd van een gebruiker aanvraagt, maar elke code die kan worden geopend met behulp van de Bot Framework Emulator van Microsoft, kan worden gebruikt om een transcriptiebestand te maken.

Om dit proces te starten, moet u ervoor zorgen dat de botcode die u wilt testen, wordt uitgevoerd in uw ontwikkelomgeving.

1. Start de emulator.

2. Selecteer Bot openen op het tabblad Welkom.

3. Voer het adres in van de poort waarnaar uw bot luistert, gevolgd door /api/messagesbijvoorbeeld http://localhost:3978/api/messages.

   Als uw bot is geconfigureerd met een Microsoft-app-id en -wachtwoord, voert u de id en het wachtwoord in het dialoogvenster Een bot openen in. Anders kan de emulator geen verbinding maken met uw bot.

4. Selecteer Verbinding maken om de emulator te verbinden met uw bot.

   

Test uw code door te communiceren met uw bot in de emulator. Nadat u alle gebruikersinteracties hebt ingevoerd die u wilt behouden, gebruikt u de Bot Framework Emulator om een transcriptiebestand met dit gesprek te maken en op te slaan.

1. Selecteer Transcript opslaan op het tabblad Live Chat.

   

2. Kies een locatie en naam voor het transcriptbestand en selecteer Opslaan.

   

Alle gebruikersinteracties en botreacties die u hebt ingevoerd om uw code te testen met de emulator, zijn nu opgeslagen in een transcriptbestand dat u later opnieuw kunt laden om fouten in interacties tussen uw gebruiker en uw bot op te sporen.

Een bottranscriptiebestand ophalen

Wanneer u een transcriptiebestand opent, laadt de emulator het opgeslagen gesprek in een nieuw tabblad.

Een transcriptiebestand voor de bot ophalen:

1. Open de emulator.
2. Selecteer Bestand in het menu en open transcriptie.
3. Gebruik het transcriptiebestand openen om het transcriptiebestand te selecteren en te openen dat u wilt ophalen.

Fouten opsporen met behulp van transcriptiebestand

Nu uw transcriptiebestand is geladen, kunt u fouten opsporen in interacties die u hebt vastgelegd tussen een gebruiker en uw bot.

1. Selecteer een gebruikers- of botbericht of activiteit die is vastgelegd in het logboekvenster van de emulator.

2. De emulator geeft de activiteitsgegevens weer in het deelvenster Inspector . De activiteitsgegevens zijn de nettolading van de HTTP-aanvraag voor de activiteit.

   Een berichtactiviteit omvat:

   • Het activiteitstype
   • De tijd waarop de activiteit is verzonden van of ontvangen door het kanaal
   • Informatie over het kanaal van de gebruiker
   • Informatie over de afzender en ontvanger van de activiteit, respectievelijk in de from en recipient velden
   • Informatie die specifiek is voor het type activiteit, zoals de berichttekst voor een berichtactiviteit.

Met dit gedetailleerde informatieniveau kunt u de stapsgewijze interacties tussen de invoer van de gebruiker en het antwoord van uw bot volgen. Dit is handig voor foutopsporingssituaties waarbij uw bot niet reageerde op de manier die u verwachtte of helemaal niet op de gebruiker heeft gereageerd. Als u deze waarden en een record hebt van de stappen die tot de mislukte interactie leiden, kunt u uw code doorlopen, de locatie vinden waar uw bot niet zoals verwacht reageert en deze problemen oplossen.

Het gebruik van transcriptiebestanden samen met de Bot Framework Emulator is slechts een van de vele hulpprogramma's die u kunt gebruiken om de code en gebruikersinteracties van uw bot te testen en fouten op te sporen.

Aanvullende informatie

Zie voor meer test- en foutopsporingsinformatie:

• Richtlijnen voor testen en foutopsporing van bots
• Fouten opsporen met de Bot Framework Emulator
• Los algemene problemen en de andere artikelen over probleemoplossing in die sectie op.
• Foutopsporing in Visual Studio