字母数字集合预构建组件用于从最终用户那里收集字母数字序列。可通过输入参数配置接受的最小和最大长度。
该组件在每个对话回合中捕获用户字符块，并将它们串联起来，形成最终序列。每个分块接受的最小和最大长度可以通过输入参数进行配置。
序列捕获将持续进行，直到最终用户指示他们已完成序列的输入与 prebuilt_components_confirmation_done intent 匹配为止。
拼音字母
此组件支持使用拼音字母，例如 NATO 拼音字母。
| 用户输入 | 捕获的序列 |
|---|---|
| alpha bravo Charlie 123 | abc123 |
| A B Cat 1 2 3 | ABC123 |
| A 表示苹果，B 表示香蕉，C 表示辣椒，115 | ABC115 |
其他功能
此预构建组件提供了以下其他功能：
示例对话框
以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为，这会在对话开始时触发“默认欢迎意图”和第一个代理响应。
单个分块
最终用户在一个分块中提供一个字母数字序列，并说“我做完了”，代理成功接受了。
| 用户输入 | 代理响应 |
|---|---|
| 请先说出字母数字序列的前 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.23M，对吗？ | |
| 无 | |
| 很抱歉，能否请您再次提供前 1 到 8 个字符？ | |
| 123N | |
| 好的。我的电话号码是 1.23M，对吗？ | |
| 无 | |
| 抱歉，能否请您再提供一下前 1 到 8 个字符？ 请写出序列中的每个字母，每个字母都以每个字母开头的单词开头。例如，如果您的序列是 AB123，请说“Apple Baby 123”。 |
|
| 123 Nest | |
| 好的。我收到的是 123N，对吗？ | |
| 无 | |
| 抱歉，我尝试的次数过多，但未能收集到字母数字序列。 |
拼音字母
最终用户提供字母数字序列；代理会重新提示最终用户进行确认。最终用户连续两次对确认说“否”，启用语音转换，最终用户再次提供字母数字序列；代理成功接受转换。
| 用户输入 | 代理响应 |
|---|---|
| 请先说出字母数字序列的前 1 到 8 个字符。完成后，说“我做完了”即可完成收集操作。您也可以随时说“播放”，以查看当前收集的序列。 | |
| 123N | |
| 好的。我的电话号码是 1.23M，对吗？ | |
| 无 | |
| 很抱歉，能否请您再次提供前 1 到 8 个字符？ | |
| 123N | |
| 好的。我的电话号码是 1.23M，对吗？ | |
| 无 | |
| 抱歉，能否请您再提供一下前 1 到 8 个字符？ 请写出序列中的每个字母，每个字母都以每个字母开头的单词开头。例如，如果您的序列是 AB123，请说“Apple Baby 123”。 |
|
| 南希的 123 N | |
| 好的。我收到的是 123N，对吗？ | |
| 是 | |
| 好的，请说出序列中接下来的 1 到 8 个字符。 | |
| 公元前 567 年 | |
| 好的。我说的是公元前 567 年，对吗？ | |
| 就这些了 | |
| 感谢您的确认。我得到的最后一个字母数字序列是 123N56BC。对吗？ | |
| 好 | |
| 太棒了，我收集了字母数字序列。 |
序列长度无效
最终用户提供长度超出了字母数字序列预定义最小和最大长度的字母数字序列。代理提示最终用户重新开始，最终用户拒绝，组件退出流程。
| 用户输入 | 代理响应 |
|---|---|
| 请先说出字母数字序列的前 1 到 8 个字符。完成后，说“我做完了”即可完成收集操作。您也可以随时说“播放”，以查看当前收集的序列。 | |
| 1.23 亿 | |
| 好的。我的电话号码是 1.23M，对吗？ | |
| 完成 | |
| 抱歉，您提供的字母数字序列超出了 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。 |
整数 |
如需为此组件配置输入参数，请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择 Build 标签页。
- 在流部分中点击导入的组件。
- 点击网页部分中的初始页。
- 点击初始页中的 true 路由。
- 在“路由”窗口中，根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是在退出组件后将保持活跃状态的会话参数。这些参数包含该组件收集的重要信息。此预构建组件提供了以下输出参数的值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| alphanumeric_collection_alphanumeric_sequence | 此参数返回组件捕获的字母数字序列 | 字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
完成
您的代理现在应已设置完毕，可以进行测试了。