处理用户中断

若要使用对话，请安装 Microsoft.Bot.Builder.Dialogs NuGet 包。

Dialogs\CancelAndHelpDialog.cs

实现 CancelAndHelpDialog 类来处理用户中断。 可取消的对话 BookingDialog 和 DateResolverDialog 派生自此类。

在 CancelAndHelpDialog 类中，OnContinueDialogAsync 方法调用 InterruptAsync 方法来检查用户是否中断了正常的流。 如果该流已中断，则调用基类方法；否则返回 InterruptAsync 中的返回值。

如果用户键入“help”，InterruptAsync 方法将发送一条消息，然后调用 DialogTurnResult (DialogTurnStatus.Waiting) 来指示最前面的对话正在等待用户的响应。 这样只会中断某个轮次的聊天流，下一轮聊天会从上次中断聊天的地方继续。

如果用户键入“cancel”，该方法将对其内部对话上下文调用 CancelAllDialogsAsync，这会清除其对话堆栈，导致堆栈退出并返回 cancelled（已取消）状态，但不返回结果值。 MainDialog（稍后会介绍）将显示预订对话已结束并返回了 null，就如同用户选择不确认其预订一样。

若要使用对话，请安装 botbuilder-dialogs npm 包。

dialogs/cancelAndHelpDialog.js

实现 CancelAndHelpDialog 类来处理用户中断。 可取消的对话 BookingDialog 和 DateResolverDialog 扩展了此类。

在 CancelAndHelpDialog 类中，onContinueDialog 方法调用 interrupt 方法来检查用户是否中断了正常的流。 如果该流已中断，则调用基类方法；否则返回 interrupt 中的返回值。

如果用户键入“help”，interrupt 方法将发送一条消息，然后返回一个 { status: DialogTurnStatus.waiting } 对象来指示最前面的对话正在等待用户的响应。 这样只会中断某个轮次的聊天流，下一轮聊天会从上次中断聊天的地方继续。

如果用户键入“cancel”，该方法将对其内部对话上下文调用 cancelAllDialogs，这会清除其对话堆栈，导致堆栈退出并返回 cancelled（已取消）状态，但不返回结果值。 MainDialog（稍后会介绍）将显示预订对话已结束并返回了 null，就如同用户选择不确认其预订一样。

CancelAndHelpDialog.java

实现 CancelAndHelpDialog 类来处理用户中断。 可取消的对话 BookingDialog 和 DateResolverDialog 派生自此类。

在 CancelAndHelpDialog 类中，onContinueDialog 方法调用 interrupt 方法来检查用户是否中断了正常的流。 如果该流已中断，则调用基类方法；否则返回 interrupt 中的返回值。

如果用户键入“help”，interrupt 方法将发送一条消息，然后调用 DialogTurnResult(DialogTurnStatus.WAITING) 来指示最前面的对话正在等待用户的响应。 这样只会中断某个轮次的聊天流，下一轮聊天会从上次中断聊天的地方继续。

如果用户键入“cancel”，该方法将对其内部对话上下文调用 cancelAllDialogs，这会清除其对话堆栈，导致堆栈退出并返回 cancelled（已取消）状态，但不返回结果值。 MainDialog（稍后会介绍）将显示预订对话已结束并返回了 null，就如同用户选择不确认其预订一样。

若要使用对话框，请安装 botbuilder-dialogs 包并确保示例 requirements.txt 文件包含正确的引用，如 botbuilder-dialogs>=4.5.0。 有关安装包的详细信息，请参阅示例存储库 README 文件。

dialogs/cancel-and-help-dialog.py

实现 CancelAndHelpDialog 类来处理用户中断。 可取消的对话 BookingDialog 和 DateResolverDialog 派生自此类。

在 CancelAndHelpDialog 类中，on_continue_dialog 方法调用 interrupt 方法来检查用户是否中断了正常的流。 如果该流已中断，则调用基类方法；否则返回 interrupt 中的返回值。

如果用户键入“help”或“?”，interrupt 方法将发送一条消息，然后调用 DialogTurnResult(DialogTurnStatus.Waiting) 来指示堆栈顶部的对话正在等待用户的响应。 这样只会中断某个轮次的聊天流，下一轮聊天会从上次中断聊天的地方继续。

如果用户键入“cancel”或“quit”，该方法将对其内部对话上下文调用 cancel_all_dialogs()，这会清除其对话堆栈，导致堆栈退出并返回“已取消”状态，但不返回结果值。 稍后会介绍的 MainDialog 将显示预订对话已结束并返回了 null，就如同用户选择不确认其预订一样。

Dialogs\MainDialog.cs

当新的消息活动抵达时，机器人将运行 MainDialog。 MainDialog 提示用户需要哪种帮助。 然后，机器人将通过调用 BookingDialog 来启动 MainDialog.ActStepAsync 方法中的 BeginDialogAsync，如下所示。

接下来，在 FinalStepAsync 类的 MainDialog 方法中，预订对话将会结束，而预订被视为已完成或已取消。

此处不显示 BookingDialog 中的代码，因为其不直接与中断处理相关。 其用于提示用户预订详细信息。 可以在 Dialogs\BookingDialogs.cs 中找到这些代码。

dialogs/mainDialog.js

当新的消息活动抵达时，机器人将运行 MainDialog。 MainDialog 提示用户需要哪种帮助。 然后，机器人将通过调用 bookingDialog 来启动 MainDialog.actStep 方法中的 beginDialog，如下所示。

接下来，在 finalStep 类的 MainDialog 方法中，预订对话将会结束，而预订被视为已完成或已取消。

此处不显示 BookingDialog 中的代码，因为其不直接与中断处理相关。 其用于提示用户预订详细信息。 可以在 dialogs/bookingDialogs.js 中找到这些代码。

MainDialog.java

当新的消息活动抵达时，机器人将运行 MainDialog。 MainDialog 提示用户需要哪种帮助。 然后，机器人将通过调用 BookingDialog 来启动 MainDialog.actStep 方法中的 beginDialog，如下所示。

接下来，在 finalStep 类的 MainDialog 方法中，预订对话将会结束，而预订被视为已完成或已取消。

此处不显示 BookingDialog 中的代码，因为其不直接与中断处理相关。 其用于提示用户预订详细信息。 可以在“BookingDialogs.java”中找到这些代码。

dialogs/main_dialog.py

当新的消息活动抵达时，机器人将运行 MainDialog。 MainDialog 提示用户需要哪种帮助。 然后，机器人将通过调用 bookingDialog 来启动 act_step 方法中的 begin_dialog，如下所示。

接下来，在 final_step 类的 MainDialog 方法中，预订对话将会结束，而预订被视为已完成或已取消。

AdapterWithErrorHandler.cs

在本示例中，适配器的 OnTurnError 处理程序接收机器人的轮次逻辑引发的任何异常。 如果引发了异常，该处理程序将删除当前聊天的聊天状态，以防止错误状态导致机器人陷入错误循环。

index.js

在本示例中，适配器的 onTurnError 处理程序接收机器人的轮次逻辑引发的任何异常。 如果引发了异常，该处理程序将删除当前聊天的聊天状态，以防止错误状态导致机器人陷入错误循环。

在此示例中，通过在 AdapterWithErrorHandler 中针对 将 BotFrameworkHttpAdapter 注册到 Spring Framework，适配器的 onTurnError 处理程序接收机器人的轮次逻辑引发的任何异常。 如果引发了异常，该处理程序将删除当前聊天的聊天状态，以防止错误状态导致机器人陷入错误循环。 在 Java SDK 中，AdapterWithErrorHandler 以 SDK 的一部分的形式实现，并包含在 com.microsoft.bot.integration 包中。 有关此适配器的实现的详细信息，请参阅 Java SDK 源代码。

adapter_with_error_handler.py

在本示例中，适配器的 on_error 处理程序接收机器人的轮次逻辑引发的任何异常。 如果引发了异常，该处理程序将删除当前聊天的聊天状态，以防止错误状态导致机器人陷入错误循环。

Startup.cs

最后，在 Startup.cs 中创建一个暂时性的机器人，并在每个轮次创建该机器人的新实例。

下面提供了在用于创建上述机器人的调用中使用的类定义供参考。

index.js

最后，在 index.js 中创建机器人。

下面提供了在用于创建上述机器人的调用中使用的类定义供参考。

Application.java

最后，在 Application.java 中创建机器人。

下面提供了在用于创建上述机器人的调用中使用的类定义供参考。

app.py 最后，在 app.py 中创建机器人。

为方便参考，下面提供了在用于创建机器人的调用中使用的类定义。