字母数字集合预构建组件

字母数字集合预构建组件会从最终用户收集字母数字序列。最小值和最大值接受的长度可通过输入参数进行配置。

该组件会在每轮对话中捕获用户输入的字符块，并将其串联起来形成最终序列。最小值和最大值可以通过输入参数配置每个分块接受的长度。

序列捕获将持续到最终用户表示它们已完成，且输入的输入与 prebuilt_components_confirmation_done intent。

国际音标

该组件支持使用拼音字母，例如北约语音字母。

此预构建组件提供了以下附加功能：

以下示例对话框展示了由此函数处理的常见场景预构建组件。示例对话框演示了组件通过电话调用，这将触发“默认欢迎 intent”和第一个在对话开始时让客服人员回应你。

最终用户一次性提供一个字母数字序列，并说“我完成了”，客服人员成功接受。

用户输入	代理响应
	首先，请说出字母数字序列的前 1 到 8 个字符。完成后，说“大功告成”以完成集合。您也可以随时说“播放”来查看当前收集的序列。
fvfd3433
	好的。我收到了 fvfd3433，对吗？
是
	好的。请说出序列中接下来的 1 到 8 个字符。
我没问题了
	感谢您的确认。我收到的最终字母数字序列是 fvfd3433，对吗？
是
	太好了，我已经收集到字母数字序列了。

最终用户以 2 个分块的形式提供字母数字序列；客服人员成功接受。

用户输入	代理响应
	首先，请说出字母数字序列的前 1 到 8 个字符。完成后，说“大功告成”以完成集合。您也可以随时说“播放”来查看当前收集的序列。
fvfd3433
	好的。我收到了 fvfd3433，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
gh67
	好的。我收到了 gh67，对吗？
是
	好的。请说出序列中接下来的 1 到 8 个字符。
我没问题了
	感谢您的确认。我收到的最终字母数字序列是 fvfd3433gh67，对吗？
是
	太好了，我已经收集到字母数字序列了。

最终用户提供字母数字序列；客服人员再次提示最终用户进行确认。最终用户说“否”并在确认时提供字母数字序列；代理会成功接受该请求

用户输入	代理响应
	首先，请说出字母数字序列的前 1 到 8 个字符。完成后，说“大功告成”以完成集合。您也可以随时说“播放”来查看当前收集的序列。
fvfd3433
	好的。我收到了 fd3433，对吗？
否
	抱歉，您能再说一遍前 1 到 8 个字符吗？
fvfd3433
	好的。我收到了 fvfd3433，对吗？
是
	好的。请说出序列中接下来的 1 到 8 个字符。
我没问题了
	感谢您的确认。我收到的最终字母数字序列是 fvfd3433，对吗？
是
	太好了，我已经收集到字母数字序列了。

最终用户在三次尝试后无法提供 1 到 8 个字符的字母数字序列，并且组件退出流程。

用户输入	代理响应
	请说出字母数字序列的前 1 到 8 个字符。完成后，说“大功告成”以完成集合。您也可以随时说“播放”来查看当前收集的序列。
123N
	好的。我获得了 1.23 亿，对吗？
否
	抱歉，能否请您再次提供前 1 到 8 个字符？
123 北
	好的。我获得了 1.23 亿，对吗？
否
	抱歉，您能再说一遍前面的 1 到 8 个字符吗？请拼出序列中的每个字母，每个字母以一个单词开头。例如，如果您的序列是 AB123，请说“Apple Baby 123”。
123 Nest
	好的。我输入了 123N，对吗？
否
	抱歉，我尝试了太多次，未能收集到字母数字序列。

最终用户提供字母数字序列；代理重新提示最终用户进行确认。最终用户说“否”确认操作后，已启用语音转换，且最终用户提供字母数字序列；代理会成功接受该请求

用户输入	代理响应
	请说出字母数字序列的前 1 到 8 个字符。完成后，说“大功告成”以完成集合。您也可以随时说“播放”来查看当前收集的序列。
123N
	好的。我获得了 1.23 亿，对吗？
否
	抱歉，能否请您再次提供前 1 到 8 个字符？
123 北
	好的。我获得了 1.23 亿，对吗？
否
	抱歉，您能再说一遍前面的 1 到 8 个字符吗？请拼出序列中的每个字母，每个字母以一个单词开头。例如，如果您的序列是 AB123，请说“Apple Baby 123”。
《123 N as in Nancy》
	好的。我输入了 123N，对吗？
是
	好的。请说出序列中接下来的 1 到 8 个字符。
公元前 567 年
	好的。我猜到了公元前 567 年，对吗？
就这些了
	感谢您的确认。我得到的最后一个字母数字序列是 123N56BC。对吗？
好
	太好了，我已经收集到字母数字序列了。

最终用户提供长度超出预定义的最小和最大长度的字母数字序列。代理提示最终用户重新开始，最终用户拒绝，而组件退出流程。

用户输入	代理响应
	首先，请说出字母数字序列的前 1 到 8 个字符。完成后，说“我完成了”即可完成收集。您也可以说“播放”检查当前收集的序列。
1.23 亿
	好的。我获得了 1.23 亿，对吗？
完成
	抱歉，您提供的字母数字序列超出了 5 到 30 个字符的长度限制。要重新开始吗？
否
	抱歉，尝试次数过多，未能收集到字母数字序列。

此预构建组件使用以下命名惯例：

特征	格式	示例
流程	[组件名称]	字母数字集合
组件专用 intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_alphanumeric_collection_support_continue
参数	[param_name]	alphanumeric_max_length

输入参数是用于配置组件。流程中的一个或多个条件将使用这些参数来确定组件的行为方式。必须在组件的开始页面上设置流程级范围的参数，如下所述。会话级范围的参数可以通过调用流程或在此组件的首页上设置。

您可以配置每次拍摄接受的最小和最大长度，将最终收集的序列修改为参数预设，位于流程的初始页。

此预构建组件接受以下输入参数：

参数名称	说明	输入格式
$flow.alphanumeric_min_length	最终字母数字序列的最短长度。默认值为 `1`。	整数
$flow.alphanumeric_max_length	最终字母数字序列的长度上限。默认值为 `30`。	整数
$flow.lower_limit	用户每轮可提供的分块长度下限。默认值为 `1`。	整数
$flow.upper_limit	用户每轮提供的最大分块长度。默认值为 `8`。	整数

输出参数是会话参数，会在退出组件后保持有效状态。这些参数包含组件收集的重要信息。此预构建组件为以下输出提供了值参数：

参数名称	说明	输出格式
alphanumeric_collection_alphanumeric_sequence	此参数会返回组件捕获的字母数字序列	字符串

如需设置此预构建组件，请执行以下操作：

您的代理现在应该已设置完毕并准备好进行测试。