自适应对话中的操作 - 参考指南

适用于： SDK v4

本文列出了 Bot Framework SDK 中定义的操作，这些操作按其常规用途分组。

回答和问题

这些条件操作的目的是帮助机器人根据你创建的任何预定义条件做出决策。这些动作由一组具有布尔表达式的条件语句指定，布尔表达式的计算结果为布尔值 true 或 false。

其余操作与循环语句相关，这些语句使你能够重复对集合中每个元素执行代码块。

操作名称	操作标题	说明
`BeginDialog`	开始新对话	开始一个新对话框，并将其添加到堆栈中。可以为新对话框提供输入参数。新对话框结束时，控件将返回到此触发器中的下一步。
`CancelAllDialogs`	取消所有活动对话	取消所有活动对话。（可选）发送可捕获的自定义事件，以防止取消传播。
`CancelDialog`	取消对话	取消活动对话。（可选）发送可捕获以防止取消的自定义事件。
`ContinueConversation`	继续对话	发送主动消息。需要具有配置的存储队列的机器人。
`ContinueConversationLater`	之后继续对话	对延迟后要发送的主动消息进行排队。要求机器人配置存储队列。
`EndDialog`	结束这个对话	结束当前对话框并返回可选结果。
`EndTurn`	结束轮次	结束当前这一轮对话，而不结束整个对话。
`GetConversationReference`	聊天引用	保存对内存的当前会话引用。用于继续对话操作。
`GotoAction`	转到操作	跳转到当前触发器中的另一个操作。
`RepeatDialog`	重复这个对话	重启目前对话。可以为对话框提供输入参数。
`ReplaceDialog`	替换这个对话	将当前对话替换为新对话。可以为新对话框提供输入参数。

操作名称	操作标题	说明
`DeleteActivity`	删除活动	删除之前发送给用户的活动。
`DeleteProperties`	删除多个属性	一次性删除多个属性。
`DeleteProperty`	删除属性	从内存中删除属性。
`EditArray`	编辑数组属性	对数组执行操作。
`GetActivityMembers`	获取活动成员	获取参与活动的成员。仅 BotFrameworkAdapter 连接器支持。
`GetConversationMembers`	获取对话成员	获取参与对话的成员。仅 BotFrameworkAdapter 连接器支持。
`SetProperties`	设置属性	同时设置多个属性的值。
`SetProperty`	设置属性	设置内存中属性的值。
`UpdateActivity`	更新活动	更新以前发送给用户的活动。

注意

Azure QnA Maker 将于 2025 年 3 月 31 日停用。从 2022 年 10 月 1 日开始，你将无法创建新的 QnA Maker 资源或知识库。问答功能的较新版本现已作为 Azure AI 语言的一部分提供。

自定义问答是 Azure 语言认知服务的一项功能，是 QnA Maker 服务的更新版本。有关 Bot Framework SDK 中的问答支持的详细信息，请参阅自然语言理解。

操作名称	操作标题	说明
`BeginSkill`	连接到技能	开始技能并将活动转发到技能，直到技能结束。
`EmitEvent`	发出自定义事件	引发自定义事件。若要允许对话对事件做出反应，请将自定义事件触发器添加给对话。
`HttpRequest`	发送 HTTP 请求	向终结点发出 HTTP 请求。
`OAuthInput`	Oauth 登录	要求用户使用 OAuth 标识提供者登录。
`QnAMakerDialog`	QnAMaker 对话框	添加 QnA Maker 知识库，回答用户提出的问题。
`SendHandoffActivity`	发送移交请求	已弃用。请勿使用此操作。
`SignOutUser`	注销用户	从 OAuth 标识提供者注销用户。

操作名称	操作标题	说明
`LogAction`	登录到控制台	写入控制台，并选择性地将消息作为跟踪活动发送。
`TelemetryTrackEventAction`	遥测 - 跟踪事件	使用已注册的遥测客户端跟踪自定义事件。
`ThrowException`	引发异常	引发异常。若要允许对话捕获异常，请将发生错误的触发器添加到对话。
`TraceActivity`	发出跟踪事件	发送跟踪活动。