此预构建组件通过收集月份、日期和年份来捕获并验证出生日期。
限制
除了常见的预构建组件限制之外，此预构建组件还具有以下限制：
- 此组件不支持通过身份证件验证来验证最终用户的出生日期。
推荐的代理设置
启用 DTMF 以允许用户使用电话键盘输入数值。
其他功能
此预构建组件提供了以下其他功能：
示例对话框
以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为，这会在对话开始时触发“默认欢迎意图”和第一个代理响应。
完整出生日期
最终用户依次提供完整的出生日期；客服人员成功接受了出生日期。
| 用户输入 | 代理响应 |
|---|---|
| 请提供您的出生日期。请说出你的出生月份，接着说出你的出生日，然后说出你的出生年份。 | |
| 1995 年 9 月 9 日 | |
| 好的，你的出生日期是 1995 年 9 月 9 日对吗？ | |
| 是 | |
| 太好了，我已经收集你的出生日期了。 |
出生日期不完整
最终用户提供出生日期，即先说月份，后跟日期和时间；代理成功接受出生日期。
| 用户输入 | 代理响应 |
|---|---|
| 请提供您的出生日期。请说出你的出生月份，接着说出你的出生日，然后说出你的出生年份。 | |
| 3 月 | |
| 你的生日是哪一天？ | |
| 12 | |
| 你出生于哪一年？ | |
| 1999 | |
| 好的，你的出生日期是 1999 年 3 月 12 日对吗？ | |
| 是 | |
| 太好了，我已经收集你的出生日期了。 |
未来日期验证
在此场景下，假设当前日期是 2023 年 3 月 22 日。最终用户提供未来的出生日期；代理进行验证，并重新提示最终用户提供正确的出生日期。
| 用户输入 | 代理响应 |
|---|---|
| 请提供您的出生日期。请说出你的出生月份，接着说出你的出生日，然后说出你的出生年份。 | |
| 2023 年 9 月 9 日 | |
| 你出生于哪一年？ | |
| 2023 | |
| 好的，你的出生日期是 2023 年 9 月 9 日对吗？ | |
| 是 | |
| 抱歉，你提供的是未来的日期。我们再来一次。 你出生于哪个月份？ |
|
| 3 月 | |
| 你的生日是哪一天？ | |
| 12 | |
| 你出生于哪一年？ | |
| 1999 | |
| 好的，你的出生日期是 1999 年 3 月 12 日对吗？ | |
| 是 | |
| 太好了，我已经收集你的出生日期了。 |
日期无效
最终用户提供的出生日期无效，例如 1999 年 2 月 30 日或 1999 年 4 月 31 日；代理进行验证，并重新提示最终用户提供正确的出生日期。
| 用户输入 | 代理响应 |
|---|---|
| 请提供您的出生日期。请说出你的出生月份，接着说出你的出生日，然后说出你的出生年份。 | |
| 1999 年 2 月 30 日 | |
| 好的，你的出生日期是 1999 年 2 月 30 日对吗？ | |
| 是 | |
| 您提供的日期无效。我们再来一次。 你出生于哪个月份？ |
|
| 3 月 | |
| 你的生日是哪一天？ | |
| 12 | |
| 你出生于哪一年？ | |
| 1999 | |
| 好的，你的出生日期是 1999 年 3 月 12 日对吗？ | |
| 是 | |
| 太好了，我已经收集你的出生日期了。 |
无法识别的输入内容
在最终用户提供无法识别的输入内容三次后，组件会退出流程。
| 用户输入 | 代理响应 |
|---|---|
| 请提供您的出生日期。请说出你的出生月份，接着说出你的出生日，然后说出你的出生年份。 | |
| 没关系 | |
| 抱歉，我没听明白。您能再说一遍或输入您的出生日期吗？ | |
| nice | |
| 抱歉，我不知道你的出生日期。让我们从月份开始。请说出您出生于哪个月份？ | |
| good | |
| 抱歉，我没听明白。您能再说一遍或输入月份吗？ | |
| nice | |
| 抱歉，我还是没听明白。请确保您说的是月份。如果没听清，您也可以使用拨号键盘输入月份。 | |
| nice | |
| 抱歉，我没听懂你的回复。 |
出生日期验证
此预构建组件使用 IS_DATE 和 IS_FUTURE_DATE 系统函数来检查所收集日期是否有效且是过去的日期。此外：
- 诸如“本月”“下个月”或“上个月”之类的输入内容会转换为相应的月份。例如，如果最终用户在 3 月与代理互动，则“本月”“下个月”和“上个月”会分别转换为“3 月”“4 月”和“2 月”。
- 用于验证年份是否为四位数。如果输入的年份仅包含两位数，该组件会将其转换为四位数的年份。例如，“98”会转换为“1998”。
- 系统将捕获“this Thursday”“last Thursday”和“next Thursday”等输入作为相应的月份和日期，代理会提示您提供年份。例如，如果最终用户在 2023 年 3 月 22 日（即星期三）与代理互动，则“本周四”“上周四”和“下周四”会分别转换为“3 月 23 日”“3 月 16 日”和“3 月 30 日”。
命名惯例
此预构建组件使用以下命名惯例：
| 特征 | 形式 | 示例 |
|---|---|---|
| 流 | [组件名称] | DOB 集合 |
| 组件专用 intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_dob_collection_collect_month |
| 参数 | [param_name] | DOB |
| 实体类型 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_dob_collection_dob_day |
输出参数
输出参数是在退出组件后将保持活跃状态的会话参数。这些参数包含该组件收集的重要信息。此预构建组件提供了以下输出参数的值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| dob_collection_dob | 此参数会返回包含出生日期元素（日、月和年）的对象 |
{ |
基本设置
如需设置此预构建组件，请执行以下操作：
完成
您的代理现已设置完毕，可以进行测试了。