Robot hibakeresése átiratfájlokkal

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

A robot sikeres tesztelésének és hibakeresésének egyik kulcsa, hogy rögzítheti és megvizsgálhatja a robot futtatásakor előforduló feltételeket. Ez a cikk egy robot átiratfájljának létrehozását és használatát ismerteti, amely részletes felhasználói interakciókat és robotválaszokat biztosít teszteléshez és hibakereséshez.

A robot átiratfájlja

A robot átiratfájlja egy speciális JSON-fájl, amely megőrzi a felhasználó és a robot közötti interakciókat. Az átiratfájl nemcsak az üzenet tartalmát őrzi meg, hanem az interakció részleteit is, például a felhasználói azonosítót, a csatornaazonosítót, a csatorna típusát, a csatorna képességeit, az interakció idejét stb. Ezek az információk ezután felhasználhatók a robot tesztelése vagy hibakeresése során felmerülő problémák megkereséséhez és megoldásához.

Robot átiratfájljának létrehozása/tárolása

Ez a cikk bemutatja, hogyan hozhat létre átiratfájlokat robotok számára a Bot Framework Emulator használatával. Az átiratfájlok programozott módon is létrehozhatók; erről a megközelítésről további információt a Blob-átirattárolóban talál. Ebben a cikkben a Multi Turn Prompt robot Bot Framework mintakódját fogjuk használni, amely a felhasználó szállítási módját, nevét és életkorát kéri le, de a Microsoft Bot Framework Emulator keresztül elérhető bármely kód használható átiratfájl létrehozásához.

A folyamat megkezdéséhez győződjön meg arról, hogy a tesztelni kívánt robot kódja a fejlesztési környezetben fut.

1. Indítsa el az Emulátort.

2. Az Üdvözlőlapon válassza a Robot megnyitása lehetőséget.

3. Adja meg annak a portnak a címét, amelyre a robot figyel, majd /api/messagespéldául http://localhost:3978/api/messages.

   Ha a robot microsoftos alkalmazásazonosítóval és -jelszóval van konfigurálva, adja meg az azonosítót és a jelszót a Robot megnyitása párbeszédpanelen. Ellenkező esetben az Emulator nem fog tudni csatlakozni a robothoz.

4. Válassza a Csatlakozás lehetőséget az Emulator robothoz való csatlakoztatásához.

   

Tesztelje a kódot úgy, hogy az Emulatorban használja a robotot. Miután megadta az összes megőrizni kívánt felhasználói beavatkozást, a Bot Framework Emulator használatával létrehozhat és menthet egy, a beszélgetést tartalmazó átiratfájlt.

1. Az Élő csevegés lapon válassza az Átirat mentése lehetőséget.

   

2. Válassza ki az átiratfájl helyét és nevét, majd kattintson a Mentés gombra.

   

A kód emulátorsal való teszteléséhez megadott összes felhasználói interakciót és robotválaszt egy átiratfájlba mentettük, amelyet később újra betölthet, hogy segítsen a felhasználó és a robot közötti interakciók hibakeresésében.

Robot átiratfájlja lekérése

Amikor megnyit egy átiratfájlt, az Emulator betölti a mentett beszélgetést egy új lapra.

Robot átiratfájlja lekérése:

1. Nyissa meg az Emulátort.
2. A menüben válassza a Fájl , majd az Átirat megnyitása lehetőséget.
3. Az Átirat megnyitása fájllal jelölje ki és nyissa meg a lekérni kívánt átiratfájlt.

Hibakeresés átiratfájl használatával

Miután betöltötte az átiratfájlt, készen áll a felhasználó és a robot között rögzített interakciók hibakeresésére.

1. Válassza ki az Emulator naplópaneljén rögzített felhasználói vagy robotüzeneteket vagy tevékenységeket.

2. Az Emulator megjeleníti a tevékenységadatokat az inspector panelen. A tevékenység adatai a tevékenység HTTP-kérésének hasznos adatai.

   Az üzenettevékenységek közé tartoznak a következők:

   • A tevékenység típusa
   • A tevékenység csatorna általi küldésének vagy fogadásának időpontja
   • A felhasználó csatornájával kapcsolatos információk
   • A tevékenység küldőjének és fogadójának adatai a from mezőkben és recipient a mezőkben
   • A tevékenység típusára vonatkozó információk, például az üzenetszöveg egy üzenettevékenységhez.

Ez a részletes információszint lehetővé teszi a felhasználó bemenete és a robot válasza közötti lépésenkénti interakciók követését, ami olyan hibakeresési helyzetekben hasznos, amikor a robot nem a várt módon válaszolt, vagy egyáltalán nem válaszolt a felhasználónak. Ezeknek az értékeknek és a sikertelen interakcióhoz vezető lépések rekordjának megírásával végighaladhat a kódon, megkeresheti azt a helyet, ahol a robot nem a várt módon válaszol, és megoldhatja ezeket a problémákat.

Az átiratfájlok és a Bot Framework Emulator együttes használata csupán egy a robot kódjának és felhasználói interakcióinak teszteléséhez és hibakereséséhez használható számos eszköz közül.

További információ

További tesztelési és hibakeresési információkért lásd:

• Robottesztelési és hibakeresési irányelvek
• Hibakeresés a Bot Framework Emulator
• Elhárítja az általános problémákat és az ebben a szakaszban található egyéb hibaelhárítási cikkeket.
• Hibakeresés a Visual Studióban