Sdílet prostřednictvím

Ladění robota pomocí souborů přepisu

  • Článek

PLATÍ PRO: SDK v4

Jedním z klíčů k úspěšnému testování a ladění robota je vaše schopnost zaznamenávat a zkoumat sadu podmínek, ke kterým dochází při spuštění robota. Tento článek popisuje vytvoření a použití souboru přepisu robota k poskytnutí podrobné sady interakcí uživatelů a odpovědí robota pro testování a ladění.

Soubor přepisu robota

Soubor přepisu robota je specializovaný soubor JSON, který zachovává interakce mezi uživatelem a robotem. Soubor přepisu zachovává nejen obsah zprávy, ale také podrobnosti interakce, jako je ID uživatele, ID kanálu, typ kanálu, možnosti kanálu, čas interakce atd. Všechny tyto informace pak můžete použít k vyhledání a řešení problémů při testování nebo ladění robota.

Vytvoření nebo uložení souboru přepisu robota

Tento článek ukazuje, jak pomocí Bot Framework Emulator vytvořit soubory přepisu robota. Soubory přepisu se můžou vytvářet také programově; Další informace o tomto přístupu najdete v tématu Úložiště přepisů objektů blob . V tomto článku použijeme vzorový kód Bot Frameworku pro robota s více výzvami, který požaduje režim dopravy, názvu a věku uživatele, ale veškerý kód, ke kterému se dá získat přístup pomocí Bot Framework Emulator Microsoftu, se dá použít k vytvoření souboru přepisu.

Pokud chcete tento proces zahájit, ujistěte se, že kód robota, který chcete otestovat, běží ve vašem vývojovém prostředí.

  1. Spusťte emulátor.

  2. Na úvodní kartě vyberte Otevřít robota.

  3. Zadejte adresu portu, do kterého robot naslouchá, a za ním /api/messagesnapříklad http://localhost:3978/api/messages.

    Pokud je váš robot nakonfigurovaný s ID a heslem aplikace Microsoft, zadejte ID a heslo v dialogovém okně Otevřít robota . Jinak se emulátor nebude moct připojit k robotovi.

  4. Vyberte Připojit a připojte emulátor k robotovi.

    Snímek obrazovky s dialogovým oknem pro připojení k robotovi z emulátoru

Otestujte kód pomocí interakce s robotem v emulátoru. Po zadání všech interakcí uživatelů, které chcete zachovat, použijte Bot Framework Emulator k vytvoření a uložení souboru přepisu obsahujícího tuto konverzaci.

  1. Na kartě Live Chat vyberte Uložit přepis.

    Snímek obrazovky konverzace a tlačítka Uložit přepis v emulátoru

  2. Zvolte umístění a název souboru přepisu a vyberte Uložit.

    Snímek obrazovky s dialogovým oknem Uložit přepis konverzace

Všechny uživatelské interakce a odpovědi robota, které jste zadali k otestování kódu pomocí emulátoru, se teď uložily do souboru přepisu, který můžete později načíst, abyste mohli ladit interakce mezi uživatelem a robotem.

Načtení souboru přepisu robota

Když otevřete soubor přepisu, emulátor načte uloženou konverzaci na novou kartu.

Načtení souboru přepisu robota:

  1. Otevřete emulátor.
  2. V nabídce vyberte Soubor a pak otevřít přepis.
  3. Pomocí souboru Otevřít přepis vyberte a otevřete soubor přepisu, který chcete načíst.

Snímek obrazovky s dialogovým oknem Otevřít soubor přepisu

Ladění pomocí souboru přepisu

S načteným souborem přepisu teď jste připraveni ladit interakce, které jste zachytili mezi uživatelem a robotem.

  1. Vyberte libovolnou zprávu uživatele nebo robota nebo aktivitu zaznamenané v podokně protokolu emulátoru.

  2. Emulátor zobrazí informace o aktivitě v podokně inspektoru . Informace o aktivitě jsou datovou částí požadavku HTTP pro aktivitu.

    Aktivita zprávy zahrnuje:

    • Typ aktivity
    • Čas odeslání aktivity nebo přijetí kanálem
    • Informace o kanálu uživatele
    • Informace o odesílateli a příjemci aktivity v polích from a recipient polích
    • Informace specifické pro typ aktivity, například text zprávy pro aktivitu zprávy.

Tato podrobná úroveň informací umožňuje postupovat podle podrobných interakcí mezi vstupem uživatele a odpovědí robota, což je užitečné pro ladění situací, kdy váš robot nereagoval tak, jak jste očekávali, nebo vůbec nereagoval na uživatele. Když budete mít tyto hodnoty i záznam kroků, které vedou k neúspěšné interakci, umožní vám procházet kód, najít umístění, kde robot nereaguje podle očekávání, a tyto problémy vyřešit.

Použití souborů přepisu společně s Bot Framework Emulator je jen jedním z mnoha nástrojů, které můžete použít k testování a ladění kódu robota a interakcí uživatelů.

Další informace

Další informace o testování a ladění najdete v tématu: