此预构建组件用于收集最终用户的数字序列。可通过输入参数配置接受的最小和最大长度。
该组件在每个对话回合中捕获用户的数字块,并将它们串联起来,形成最终序列。每个分块接受的最小和最大长度可以通过输入参数进行配置。
序列捕获将持续进行,直到最终用户指示他们已完成序列的输入与 prebuilt_components_confirmation_done intent 匹配为止。
限制
除了常见的预构建组件限制之外,此预构建组件还具有以下限制:
- 不支持非数字字符。如需了解对字母和数字的支持,请参阅字母数字集合。
推荐的代理设置
启用 DTMF 以允许用户使用电话键盘输入数值。
其他功能
此预构建组件提供了以下其他功能:
示例对话框
以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为,这会在对话开始时触发“默认欢迎意图”和第一个代理响应。
单个分块
最终用户在第一次尝试时提供了数字序列;客服人员成功接受了。
用户输入 | 代理响应 |
---|---|
请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
2374 30940 029 30 | |
我收到的电话号码是 23743094002930,对吗? | |
是 | |
好的。请说出或输入数字序列的下一部分。 | |
完成 | |
谢谢,我收集的数字序列是 23743094002930。对吗? | |
是 | |
太好了,我已完成数字序列的收集。 |
多个数据块
最终用户提供多个分块的数字序列;客服人员成功接受。
用户输入 | 代理响应 |
---|---|
请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
2374 30940 029 30 | |
我收到的电话号码是 23743094002930,对吗? | |
否 | |
别担心,能否请您再次提供数字序列的前 1 到 30 位数字? | |
2374 | |
我的电话号码是 2374,对吗? | |
是 | |
好的。请说出或输入数字序列的下一部分。 | |
3094 | |
我收到的是 3094,对吗? | |
对 | |
好的。请说出或输入数字序列的下一部分。 | |
002930 | |
我发给 002930,对吗? | |
否 | |
别担心,23743094 之后是什么? | |
2930 | |
我发给 2930,对吗? | |
是的,就这样吧 | |
谢谢,我收集的数字序列是 237430942930。对吗? | |
是 | |
太好了,我已完成数字序列的收集。 |
重试成功
最终用户在第一次尝试中提供了一个数字序列;客服人员会重新确认,但最终用户说“否”。代理要求最终用户再次提供序列。 最终用户提供并确认序列,客服人员成功接受。
用户输入 | 代理响应 |
---|---|
请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
92832938 3489 | |
我收到的是 928329383459,对吗? | |
无 | |
别担心,能否请您再次提供数字序列的前 1 到 30 位数字? | |
928329383435 | |
我收到的电话号码是 928329383435,对吗? | |
是的,我就要全部了 | |
谢谢,我找到的数字序列是 928329383435。对吗? | |
是 | |
太好了,我已完成数字序列的收集。 |
重试失败
最终用户提供三次数字序列,并在重新确认步骤中说“否”,组件在第三次确认失败后退出流程。
用户输入 | 代理响应 |
---|---|
请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
928329383435 | |
我收到的电话号码是 928329383835,对吗? | |
无 | |
别担心,能否请您再次提供数字序列的前 1 到 30 位数字? | |
23 289 0239 903 | |
我收到的电话号码是 232890239953,对吗? | |
无 | |
别担心,能否请您再次提供数字序列的前 1 到 30 位数字? | |
23847 02938 | |
我收到的电话号码是 2384702938,对吗? | |
无 | |
抱歉,我尝试的次数过多,也没能收到你的回复。 |
无法识别的输入内容
在最终用户提供无法识别的输入内容三次后,组件会退出流程。
用户输入 | 代理响应 |
---|---|
请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
没关系 | |
抱歉,我没听明白。请先说出数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。 | |
nice | |
抱歉,我还是没听明白。请确保您说的是数字序列的前 1 到 30 位数字。完成后,说“我做完了”即可完成收集操作。您也可以随时说“播放”,以查看当前收集的序列。如果我们听不到您的声音,您也可以使用拨号键盘输入数字序列。 | |
非常好 | |
抱歉,我没听懂你的回复。 |
命名惯例
此预构建组件使用以下命名惯例:
特征 | 形式 | 示例 |
---|---|---|
流 | [组件名称] | 数值集合 |
组件专用 intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_numeric_collection_collect_numeric_sequence |
参数 | [param_name] | user_provided_cur_seq |
输入参数
输入参数是用于配置组件某些行为的参数。流中的一个或多个条件将使用这些参数来确定组件的行为方式。流范围的参数必须在组件的初始页上设置,如下所述。会话级范围的参数可以通过调用流设置,也可以在此组件的初始页上设置。
您可以通过修改流程初始页面中的参数预设,为每次捕获以及最终收集的序列配置最小和最大长度。
此预构建组件接受以下输入参数:
参数名称 | 说明 | 输入格式 |
---|---|---|
$flow.numeric_min_length | 最终数字序列的最小长度 | 整数 |
$flow.numeric_max_length | 最终数字序列的长度上限 | 整数 |
$flow.lower_limit | 用户每轮可以提供的区块长度下限 | 整数 |
$flow.upper_limit | 用户每轮可以提供的区块长度上限 | 整数 |
如需为此组件配置输入参数,请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择 Build 标签页。
- 在流部分中点击导入的组件。
- 点击网页部分中的初始页。
- 点击初始页中的 true 路由。
- 在“路由”窗口中,根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是在退出组件后将保持活跃状态的会话参数。这些参数包含该组件收集的重要信息。此预构建组件提供了以下输出参数的值:
参数名称 | 说明 | 输出格式 |
---|---|---|
numeric_collection_numeric_sequence | 此参数返回在会话期间捕获的数字序列 | 字符串 |
基本设置
如需设置此预构建组件,请执行以下操作:
完成
您的代理现在应已设置完毕,可以进行测试了。