這個預先建構的元件會向使用者收集數字序列。您可以透過輸入參數設定接受的最小和最大長度。
這個元件會在每個對話回合中擷取使用者輸入的數字片段，並將這些片段連接起來，形成最終序列。每個區塊可接受的最小和最大長度，可透過輸入參數設定。
系統會持續擷取序列，直到使用者透過輸入內容表示已完成序列，且符合 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 位數字。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| 不錯 | |
| 嗯，我還是沒聽清楚。請確認你說的是數字序列的前 1 到 30 位數字。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。如果我們無法聽到你的聲音，你也可以使用數字鍵盤輸入數字序列。 | |
| 很棒 | |
| 抱歉，我不懂你的意思。 |
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| 心流狀態 | [元件名稱] | 數字集合 |
| 元件專屬意圖 | 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」分頁標籤。
- 在「流程」部分中，按一下匯入的元件。
- 按一下「網頁」部分中的「首頁」。
- 按一下「Start」頁面中的「true」路徑。
- 在路徑視窗中，視需要編輯「參數預設值」值。
- 按一下 [儲存]。
輸出參數
輸出參數是會在退出元件後仍保持啟用的會話參數。這些參數包含元件收集的重要資訊。這個預先建構的元件會為下列輸出參數提供值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| numeric_collection_numeric_sequence | 這個參數會傳回工作階段期間擷取的數字序列 | 字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
完成
您的服務專員現在應已設定完成，可以開始測試。