Отладка бота с помощью файлов записей разговоров

ОБЛАСТЬ ПРИМЕНЕНИЯ: Пакет SDK версии 4

Один из залогов успеха в тестировании и отладке бота — возможность записать и просмотреть набор условий, возникающих при запуске бота. В этой статье описывается, как создать и использовать файл записи разговора с ботом, чтобы предоставить детальный набор действий пользователя и ответов бота для тестирования и отладки.

Файл записи разговора с ботом

Файл записи разговора с ботом — это специализированный JSON-файл, в котором хранятся данные о взаимодействии между пользователем и ботом. Файл расшифровки сохраняет не только содержимое сообщения, но и сведения о взаимодействии, такие как идентификатор пользователя, идентификатор канала, тип канала, возможности канала, время взаимодействия и т. д. Затем всю эту информацию можно использовать для поиска и устранения проблем при тестировании или отладке бота.

Создание и сохранение файла записи разговора с ботом

В этой статье показано, как создать файлы расшифровки бота с помощью Bot Framework Emulator. Файлы расшифровки также могут создаваться программными средствами; Дополнительные сведения об этом подходе см. в разделе "Хранилище расшифровок BLOB-объектов ". В этой статье мы будем использовать пример кода Bot Framework для многоэтапного бота, который запрашивает режим транспорта, имени и возраста пользователя, но любой код, к которому можно получить доступ с помощью Bot Framework Emulator Майкрософт, можно использовать для создания файла расшифровки.

Чтобы начать этот процесс, убедитесь, что код бота, который требуется протестировать, выполняется в среде разработки.

1. Запустите эмулятор Bot Framework.

2. На вкладке Добро пожаловать выберите Открыть бот.

3. Введите адрес порта, на который ожидается прослушивание бота/api/messages, а затем , например. http://localhost:3978/api/messages

   Если бот настроен с идентификатором приложения Майкрософт и паролем, введите идентификатор и пароль в диалоговом окне "Открыть бот ". В противном случае эмулятор не сможет подключиться к боту.

4. Выберите "Подключиться ", чтобы подключить эмулятор к боту.

   

Протестируйте код, взаимодействуя с ботом в эмуляторе. После ввода всех взаимодействий с пользователем, которые вы хотите сохранить, используйте Bot Framework Emulator для создания и сохранения файла расшифровки, содержащего эту беседу.

1. На вкладке Live Chat выберите "Сохранить расшифровку".

   

2. Выберите расположение и имя файла расшифровки и нажмите кнопку "Сохранить".

   

Все взаимодействия с пользователем и ответы бота, введенные для тестирования кода с помощью эмулятора, теперь сохранены в файл расшифровки, который позже можно перезагрузить, чтобы помочь отладить взаимодействие между пользователем и ботом.

Получение файла записи разговора с ботом

При открытии файла расшифровки эмулятор загружает сохраненную беседу на новую вкладку.

Чтобы получить файл расшифровки бота, выполните следующее:

1. Откройте эмулятор.
2. В меню выберите "Файл" , а затем "Открыть расшифровку".
3. Откройте файл расшифровки , чтобы выбрать и открыть нужный файл расшифровки.

Отладка с помощью файла записи разговора

После загрузки файла расшифровки теперь можно отлаживать взаимодействия, захваченные между пользователем и ботом.

1. Выберите любое сообщение пользователя или бота или действия, записанные в области журнала эмулятора.

2. Эмулятор отобразит сведения о действиях в области инспектора . Сведения о действии — это полезные данные HTTP-запроса для действия.

   Действие сообщения включает в себя следующее:

   • Тип действия
   • Время отправки или получения действия каналом
   • Сведения о канале пользователя
   • Сведения об отправителе и получателе действия в from полях и recipient полях соответственно
   • Сведения, относящиеся к типу действия, например текст сообщения для действия сообщения.

Этот подробный уровень информации позволяет выполнять пошаговые взаимодействия между входными данными пользователя и ответом бота, что полезно для отладки ситуаций, когда бот либо не ответил на ожидаемый способ, либо вообще не ответил на него. Наличие этих значений и записи шагов, ведущих к сбою взаимодействия, позволяет выполнять пошаговое выполнение кода, находить расположение, в котором бот не отвечает ожидаемым образом, и устранять эти проблемы.

Использование файлов записей разговоров вместе с Bot Framework Emulator — это лишь один из многих способов тестирования и отладки кода бота и взаимодействия с пользователями.

Дополнительные сведения

Дополнительные сведения о тестировании и отладке см. в статьях:

• Рекомендации по тестированию и отладке ботов
• Отладка ботов с помощью Bot Framework Emulator
• Сведения об устранении общих проблем и другие статьи об устранении неполадок в этом разделе.
• Отладка в Visual Studio