使用脚本文件调试机器人

适用于： SDK v4

成功测试和调试机器人的其中一个密钥是能够记录和检查运行机器人时发生的一组条件。 本文讨论如何创建和使用机器人脚本文件，以提供一组详细的用户交互和机器人响应，用于测试和调试。

机器人转录文件

机器人脚本文件是一个专用 JSON 文件，用于保留用户与机器人之间的交互。 脚本文件不仅保留消息的内容，还保留交互详细信息，例如用户 ID、通道 ID、通道类型、通道功能、交互时间等。 然后，可以使用所有这些信息来帮助在测试或调试机器人时查找和解决问题。

创建/存储机器人对话记录文件

本文介绍如何使用 Bot Framework Emulator 创建机器人脚本文件。 脚本文件也可以以编程方式创建;有关该方法的详细信息，请参阅 Blob 脚本存储 。 在本文中，我们将使用 多轮次提示机器人 的 Bot Framework 示例代码来请求用户的交通方式、姓名和年龄，但可以使用 Microsoft 的 Bot Framework Emulator 访问的任何代码来生成转录文件。

若要开始此过程，请确保要测试的机器人代码在开发环境中运行。

1. 启动 Emulator。

2. 在“欢迎”选项卡上，选择“打开机器人”。

3. 输入机器人正在侦听的端口的地址，后面接上/api/messages，例如http://localhost:3978/api/messages。

   如果机器人配置了Microsoft应用 ID 和密码，请在 “打开机器人 ”对话框中输入 ID 和密码。 否则，模拟器将无法连接到机器人。

4. 选择 “连接 ”以将模拟器连接到机器人。

   

通过在模拟器中与机器人交互来测试代码。 输入要保留的所有用户交互后，使用 Bot Framework Emulator 创建并保存包含此对话的脚本文件。

1. 在“ 实时聊天 ”选项卡中，选择“ 保存脚本”。

   

2. 选择脚本文件的位置和名称，然后选择“ 保存”。

   

输入用于测试模拟器代码的所有用户交互和机器人响应现已保存到脚本文件中，稍后可以重新加载，以帮助调试用户与机器人之间的交互。

检索机器人对话记录文件

打开脚本文件时，模拟器会将保存的对话加载到新选项卡中。

检索机器人对话记录文件：

1. 打开模拟器。
2. 从菜单中选择“ 文件 ”，然后选择“ 打开脚本”。
3. 使用 “打开脚本文件 ”选择并打开要检索的脚本文件。

使用记录文件进行调试

加载转录文件后，现在可以调试您在用户和机器人之间捕获的交互。

1. 选择模拟器 日志 窗格中记录的任何用户或机器人消息或活动。

2. 模拟器将在 检查器 窗格中显示活动信息。 活动信息是活动的 HTTP 请求的有效负载。

   消息活动包括：

   • 活动类型
   • 活动从通道发送或被通道接收的时间
   • 有关用户频道的信息
   • 有关活动的发送方和接收方的信息，分别位于 from 和 recipient 字段中
   • 特定于活动类型的信息，例如消息活动的消息文本。

通过此详细的信息级别，可以遵循用户输入与机器人响应之间的分步交互，这对于调试机器人未按预期或根本不响应用户的方式进行响应的情况非常有用。 拥有这些值以及记录导致失败交互之前的步骤，使您能够逐步检查您的代码，找到机器人未按预期响应的位置，并解决这些问题。

结合使用转录文件与 Bot Framework Emulator 只是众多可用于测试和调试机器人代码及用户交互工具之一。

其他信息

有关更多测试和调试信息，请参阅：

• 机器人测试和调试指南
• 使用 Bot Framework Emulator 进行调试
• 排查一般故障，以及该部分中的其他故障排除文档。
• 在 Visual Studio 中进行调试