你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

适用于: SDK v4

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

  • 有关本主题的简介,请参阅 Composer 文档中的 Actions 主题。

回答和问题

操作名称 操作标题 说明
Ask 发送回复以提问 使用活动作为提示用户的方法。
AttachmentInput 提示输入文件或附件 请求用户输入文件或图像。
ChoiceInput 使用多选项提示 请求用户从选项列表中进行选择。
ConfirmInput 提示确认 询问用户进行确认(是-否问题)。
DateTimeInput 提示输入日期或时间 请求用户输入日期或时间值。
NumberInput 提示输入数字 要求用户输入数值。
OAuthInput Oauth 登录 要求用户使用 OAuth 标识提供者登录。
SendActivity 发送响应 发送任何活动,如响应用户。
TextInput 提示输入文本 要求用户键入响应。

条件和循环

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

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

操作名称 操作标题 说明
BreakLoop 中断循环 退出封闭循环。
ContinueLoop 继续循环 启动封闭循环的下一次迭代。
ForEach 循环:适用于每个项 对集合中的每个项运行一组操作。
ForEachPage 循环:适用于每个页面(多个项) 在集合中的每个页面(项子集)上运行一组操作。
IfCondition 分支: if/else 基于布尔表达式运行一组操作。
SwitchCondition 分支:Switch(多个选项) 基于属性的值运行一组操作。

对话管理

操作名称 操作标题 说明
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 AI 语言的一项功能,是 QnA Maker 服务的更新版本。 有关 Bot Framework SDK 中的问答支持的详细信息,请参阅 自然语言理解

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

调试选项

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

其他信息