出生日期收集預先建構元件

這個預先建構的元件會收集月份、日期和年份,進而擷取及驗證出生日期。

限制

除了常見的預先建構元件限制外,這個預先建構元件還有以下限制:

  • 這個元件不支援透過身分證件驗證來驗證使用者的出生日期。

啟用 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 日。對嗎?
太好了,我已收集到你的出生日期。

無法辨識的輸入內容

當使用者三次提供未識別的輸入內容,元件就會退出流程。

使用者輸入內容 服務專員回應
請提供您的出生日期。請說出您的出生月份、出生日和出生年份。
沒關係
抱歉,我沒聽清楚。請再次說出或輸入您的出生日期。
不錯
很抱歉,我沒有收到你的出生日期。我們先從月份開始。請說出您出生的月份?
good
抱歉,我沒聽清楚。請再說一次或輸入月份數字。
不錯
嗯,我還是沒聽清楚。請確認你說的是月份。如果我聽不清楚,你也可以使用撥號鍵輸入月份數字。
不錯
抱歉,我不懂你的意思。

驗證出生日期

這個預先建構的元件會使用 IS_DATEIS_FUTURE_DATE 系統函式,檢查收集到的日期是否有效且已過期。此外:

  • 輸入的內容 (例如「本月」、「下個月」或「上個月」) 會轉換為適當的月份。舉例來說,如果使用者是在 3 月與服務專員互動,那麼「本月」、「下個月」和「上個月」會分別轉換為「3 月」、「4 月」和「2 月」。
  • 驗證年份應為四位數字。如果年份輸入內容只有兩位數字,元件會將其轉換為四位數的年份。例如「98」會轉換為「1998」。
  • 輸入的內容 (例如「本週四」、「上週四」和「下週四」) 會擷取為適當的月份和日期,並由服務機器人提示提供年份。舉例來說,如果使用者是在 2023 年 3 月 22 日 (星期三) 與服務專員互動,則「本星期四」、「上星期四」和「下星期四」會分別轉換為「3 月 23 日」、「3 月 16 日」和「3 月 30 日」。

命名慣例

這個預先建構的元件採用下列命名慣例:

功能 格式 範例
心流狀態 [元件名稱] 收集出生日期
元件專屬意圖 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 這個參數會傳回包含出生日期元素的物件:日期、月份和年份
{
"year": integer,
"month": integer,
"day": integer
}

基本設定

如要設定這個預先建構的元件,請按照下列步驟操作:

  1. 匯入預先建構的元件

完成

您的服務專員現在應已設定完成,可以開始測試。