Felsöka din robot med avskriftsfiler
GÄLLER FÖR: SDK v4
En av nycklarna till att testa och felsöka en robot är möjligheten att registrera och undersöka de villkor som inträffar när du kör roboten. Den här artikeln beskriver hur du skapar och använder en robotavskriftsfil för att tillhandahålla en detaljerad uppsättning användarinteraktioner och robotsvar för testning och felsökning.
Robotavskriftsfilen
En robotavskriftsfil är en specialiserad JSON-fil som bevarar interaktionerna mellan en användare och din robot. En avskriftsfil bevarar inte bara innehållet i ett meddelande, utan även interaktionsinformation som användar-ID, kanal-ID, kanaltyp, kanalfunktioner, tid för interaktionen och så vidare. All den här informationen kan sedan användas för att hitta och lösa problem när du testar eller felsöker din robot.
Skapa/lagra en robotavskriftsfil
Den här artikeln visar hur du skapar robotavskriftsfiler med hjälp av Bot Framework Emulator. Avskriftsfiler kan också skapas programmatiskt; Se Blob-avskriftslagring för att läsa mer om den metoden. I den här artikeln använder vi Bot Framework-exempelkoden för robot med flera svarsmeddelanden som begär en användares transport-, namn- och åldersläge, men all kod som kan nås med Microsofts Bot Framework Emulator kan användas för att skapa en avskriftsfil.
Börja den här processen genom att se till att robotkoden som du vill testa körs i utvecklingsmiljön.
Starta emulatorn.
På fliken Välkommen väljer du Öppna robot.
Ange adressen till den port som roboten lyssnar på, följt av
/api/messages
, till exempelhttp://localhost:3978/api/messages
.Om din robot har konfigurerats med ett App-ID och lösenord från Microsoft anger du ID och lösenord i dialogrutan Öppna en robot . Annars kan emulatorn inte ansluta till din robot.
Välj Anslut för att ansluta emulatorn till roboten.
Testa koden genom att interagera med roboten i emulatorn. När du har angett alla användarinteraktioner som du vill bevara använder du Bot Framework Emulator för att skapa och spara en avskriftsfil som innehåller den här konversationen.
På fliken Livechatt väljer du Spara avskrift.
Välj en plats och ett namn för avskriftsfilen och välj Spara.
Alla användarinteraktioner och robotsvar som du angav för att testa koden med emulatorn har nu sparats i en avskriftsfil som du senare kan läsa in på nytt för att felsöka interaktioner mellan användaren och roboten.
Hämta en robotavskriftsfil
När du öppnar en avskriftsfil läser emulatorn in den sparade konversationen på en ny flik.
Så här hämtar du en robotavskriftsfil:
- Öppna emulatorn.
- På menyn väljer du Arkiv och sedan Öppna avskrift.
- Använd öppna avskriftsfilen för att välja och öppna avskriftsfilen som du vill hämta.
Felsöka med avskriftsfil
När avskriftsfilen har lästs in är du nu redo att felsöka interaktioner som du har samlat in mellan en användare och din robot.
Välj ett användar- eller robotmeddelande eller en aktivitet som registrerats i emulatorns loggfönster .
Emulatorn visar aktivitetsinformationen i kontrollfönstret . Aktivitetsinformationen är nyttolasten för HTTP-begäran för aktiviteten.
En meddelandeaktivitet innehåller:
- Aktivitetstypen
- Den tid då aktiviteten skickades från eller togs emot av kanalen
- Information om användarens kanal
- Information om avsändare och mottagare av aktiviteten, i fälten
from
ochrecipient
respektive - Information som är specifik för typen av aktivitet, till exempel meddelandetexten för en meddelandeaktivitet.
Med den här detaljerade informationsnivån kan du följa de stegvisa interaktionerna mellan användarens indata och robotens svar, vilket är användbart för felsökning av situationer där roboten antingen inte svarade på det sätt som du förväntade dig eller inte svarade användaren alls. Med både dessa värden och en post med stegen som leder fram till den misslyckade interaktionen kan du stega igenom din kod, hitta den plats där roboten inte svarar som förväntat och lösa dessa problem.
Att använda avskriftsfiler tillsammans med Bot Framework Emulator är bara ett av de många verktyg som du kan använda för att testa och felsöka robotens kod och användarinteraktioner.
Ytterligare information
Mer information om testning och felsökning finns i:
- Riktlinjer för robottestning och felsökning
- Felsöka med Bot Framework Emulator
- Felsöka allmänna problem och andra felsökningsartiklar i det avsnittet.
- Felsökning i Visual Studio