出生日期收集预构建组件

此 预构建组件 通过收集月、日和年信息来捕获和验证出生日期。

限制

除了 常见的预构建组件限制之外， 此预构建组件还具有以下限制：

• 此组件不支持通过身份验证来验证最终用户的出生日期。

建议的代理设置

启用 DTMF，以便用户可以使用电话拨号键盘输入数值。

其他功能

此预构建组件提供以下其他功能：

• 重复
• 等候室
• 播放

对话示例

以下对话示例展示了此预构建组件处理的常见场景。这些对话示例展示了通过电话调用组件时的行为，该行为会在对话开始时触发默认欢迎意图和代理的第一个回答。

完整出生日期

最终用户在一个轮次中提供完整的出生日期；代理成功接受该日期。

部分出生日期

最终用户先说出月份，然后说出日期和年份，从而提供出生日期；代理成功接受该日期。

未来日期验证

此场景假定当前日期为 2023 年 3 月 22 日。最终用户提供未来的出生日期；代理验证该日期，并重新提示最终用户提供正确的出生日期。

无效日期

最终用户提供无效的出生日期，例如 1999 年 2 月 30 日或 1999 年 4 月 31 日；代理验证该日期，并重新提示最终用户提供正确的出生日期。

无法识别的输入

在最终用户提供无法识别的输入三次后，组件会退出流程。

出生日期验证

此预构建组件使用 IS_DATE 和 IS_FUTURE_DATE 系统函数来 检查收集的日期是否有效且是过去的日期。此外：

• “本月”“下个月”或“上个月”等输入会转换为相应的月份。例如，如果最终用户在 3 月与代理互动，则“本月”“下个月”和“上个月”分别转换为“3 月”“4 月”和“2 月”。
• 验证年份应为四位数。如果年份输入仅包含两位数，则组件会将其转换为四位数年份。例如，“98”会转换为“1998”。
• “本周四”“上周四”和“下周四”等输入会捕获为相应的月份和日期，代理会提示提供年份。例如，如果最终用户在 2023 年 3 月 22 日（星期三）与代理互动，则“本周四”“上周四”和“下周四”分别转换为“3 月 23 日”“3 月 16 日”和“3 月 30 日”。

命名规则

此预构建组件使用以下命名规则：

输出参数

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

基本设置

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

1. 导入预构建组件。

完成

您的代理现在应该已设置完毕，可以进行测试了。