字母数字集合预构建组件

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

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

序列捕获会一直持续，直到用户通过提供与 prebuilt_components_confirmation_done intent 匹配的输入来表明他们已完成序列。

拼音字母

此组件支持使用音标，例如 NATO 音标。

用户输入	捕获的序列
alpha bravo charlie 123	abc123
A B Cat 1 2 3	ABC123
A for apple, B for banana, C for chili, 115	ABC115

其他功能

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

• 重复
• 等候室
• 播放

对话示例

这些示例对话展示了此预构建组件处理的常见场景。 它们展示了您使用电话服务调用组件时的行为，这会在对话开始时触发默认欢迎 intent 和第一个代理响应。

单个区块

1. 用户一次性提供一串字母数字序列，并说“我说完了”。
2. 客服人员成功接受邀请。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
fvfd3433
	好的。我听到的是 fvfd3433，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
我没问题了
	感谢您的确认。我最终得到的字母数字序列是 fvfd3433，对吗？
是
	太棒了，我已收集到字母数字序列。

多个数据块

1. 用户提供由两部分组成的字母数字序列。
2. 客服人员成功接受邀请。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
fvfd3433
	好的。我听到的是 fvfd3433，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
gh67
	好的。我听到的是 gh67，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
我没问题了
	感谢您的确认。我得到的最终字母数字序列是 fvfd3433gh67，对吗？
是
	太棒了，我已收集到字母数字序列。

重试成功

1. 用户提供字母数字序列。
2. 智能体会再次提示用户确认。
3. 用户在确认时说“否”，并再次提供字母数字序列。
4. 智能体成功接受第二个序列。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
fvfd3433
	好的。我听到的是 fd3433，对吗？
否
	抱歉，能否请您再次提供前 1 到 8 个字符？
fvfd3433
	好的。我听到的是 fvfd3433，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
我没问题了
	感谢您的确认。我最终得到的字母数字序列是 fvfd3433，对吗？
是
	太棒了，我已收集到字母数字序列。

重试失败

用户无法在三次尝试内提供 1 到 8 个字符的字母数字序列，因此组件退出流程。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
123N
	好的。我得到的是 1.23 亿，对吗？
否
	抱歉，能否请您再次提供前 1 到 8 个字符？
123N
	好的。我得到的是 1.23 亿，对吗？
否
	抱歉，您能再次提供前 1 到 8 个字符吗？ 请用以每个字母开头的单词拼出序列中的每个字母。例如，如果序列是 AB123，请说“Apple Baby 123”。
123 Nest
	好的。我听到的是 123N，对吗？
否
	抱歉，我已尝试太多次，但未能收集到字母数字序列。

拼音字母

1. 用户提供字母数字序列。
2. 智能体会再次提示用户确认。
3. 用户在确认时回答“否”，智能体会再次提示用户。
4. 用户再次对确认说“不”，智能体启用语音转换。
5. 用户使用拼音转换提供字母数字序列。
6. 代理成功接受了字母数字序列。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
123N
	好的。我得到的是 1.23 亿，对吗？
否
	抱歉，能否请您再次提供前 1 到 8 个字符？
123N
	好的。我得到的是 1.23 亿，对吗？
否
	抱歉，您能再次提供前 1 到 8 个字符吗？ 请用以每个字母开头的单词拼出序列中的每个字母。例如，如果序列是 AB123，请说“Apple Baby 123”。
123 N（Nancy 的首字母）
	好的。我听到的是 123N，对吗？
是
	好的。请告诉我序列中的下 1 到 8 个字符。
567BC
	好的。我算出的结果是公元前 567 年，对吗？
仅此而已
	感谢您的确认。我最终得到的字母数字序列是 123N56BC。对吗？
好
	太棒了，我已收集到字母数字序列。

序列长度无效

1. 用户提供的字母数字序列的长度不在预定义的字母数字序列最小和最大长度范围内。
2. 代理提示用户重新开始。
3. 用户拒绝，组件退出流程。

用户输入	智能体回答
	请先说出字母数字序列的前 1 到 8 个字符。完成后，请说“我完成了”以结束收集。您也可以随时说“playback”（播放），查看当前收集的序列。
1.23 亿
	好的。我得到的是 1.23 亿，对吗？
完成
	抱歉，您提供的字母数字序列长度不符合要求（5 到 30 个字符）。要重新开始吗？
否
	抱歉，我尝试了太多次，但未能收集到字母数字序列。

命名规则

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

功能	格式	示例
Flow	[Component Name]	字母数字集合
组件特定 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。	整数

如需为此组件配置输入参数，请展开以查看相关说明。

1. 打开 Dialogflow CX 控制台。
2. 选择您的 Google Cloud 项目。
3. 选择您的代理。
4. 选择构建标签页。
5. 在流部分中点击导入的组件。
6. 点击页面部分中的“Start Page”。
7. 点击“Start Page”中的 true 路由。
8. 在“Route”（路线）窗口中，根据需要修改参数预设值。
9. 点击保存。

输出参数

输出参数是指在您退出组件后仍保持活跃状态的会话参数。这些参数包含组件收集的信息。 此预构建组件会为以下输出参数提供值：

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

基本设置

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

导入预构建组件。

完成

预构建组件现已设置完毕，可以开始测试了。