编辑:
在查看源代码时,我在botbuilder.d.ts
中找到了以下内容。看起来在瀑布中您不需要显式调用endDialog
吗?
/* You can terminate a waterfall early by either falling through every step of the waterfall using
* calls to `skip()` or simply not starting another prompt or dialog.
*
* __note:__ Waterfalls have a hidden last step which will automatically end the current dialog if
* if you call a prompt or dialog from the last step. This is useful where you have a deep stack of
* dialogs and want a call to [session.endDialog()](/en-us/node/builder/chat-reference/classes/_botbuilder_d_.session.html#enddialog)
* from the last child on the stack to end the entire stack. The close of the last child will trigger
* all of its parents to move to this hidden step which will cascade the close all the way up the stack.
* This is typically a desired behavior but if you want to avoid it or stop it somewhere in the
* middle you'll need to add a step to the end of your waterfall that either does nothing or calls
* something like [session.send()](/en-us/node/builder/chat-reference/classes/_botbuilder_d_.session.html#send)
* which isn't going to advance the waterfall forward.
* @example
* <pre><code>
* var bot = new builder.BotConnectorBot();
* bot.add('/', [
* function (session) {
* builder.Prompts.text(session, "Hi! What's your name?");
* },
* function (session, results) {
* if (results && results.response) {
* // User answered question.
* session.send("Hello %s.", results.response);
* } else {
* // User said never mind.
* session.send("OK. Goodbye.");
* }
* }
* ]);
* </code></pre>
*/
我正在学习MS Bot Framework版本3-这是他们在这里使用的版本。
我遵循瀑布如何工作的概念(https://docs.microsoft.com/en-us/azure/bot-service/nodejs/bot-builder-nodejs-dialog-manage-conversation-flow?view=azure-bot-service-3.0),但是我不了解的一件事是
endDialog
扮演什么角色。例如,在我们使用的代码中,有一堆单独的对话框,它们都具有以下形式
module.exports = function showTickets() {
this.bot.dialog('/showAllTickets', [
async function showAllTicketsFn(session, args, next) {
this.beginDialog.bind(this, '/showTickets')(session, args, next);
}.bind(this)
]);
};
基本上,一个对话框会加载另一个对话框(之间还有其他一些代码,例如在数据存储区中设置数据)。
endDialog
无处调用。但是在MS教程的示例中,每个瀑布都以某种形式的endDialog
(endDialog
或endDialogWithResults
等)结束。瀑布完成后,也就是运行数组中传递给
beginDialog
的函数时,用bot.dialog
“打开”的每个对话框是否会自动“关闭”自身吗? (在上面的代码中,瀑布只是一步)。什么时候需要显式调用
endDialog
?谢谢你的帮助!
最佳答案
确实,文档应该说您应该结束对话框,而不是必须结束。如果您未明确调用EndDialog
,瀑布将自动结束。这意味着更多的是内置的安全机制,以帮助避免用户卡住,在获得结果后忘记致电enddialog。但是在某些情况下,可以不添加显式的EndDialog
调用。您可以在瀑布here中找到更多内容。
一个有效的用例是对话框调用是一个瀑布,它仅决定要跳转到哪个对话框。一旦分支到给定的对话框,就没有理由添加在该对话框结束之后结束的步骤。
但是即使在这种情况下,也可能仅使用ReplaceDialog
替换为要跳转到的对话框,这会更有效率。