這個數字和字母收集預先建構元件會從使用者端收集數字和字母序列。您可以透過輸入參數設定接受的最小和最大長度。
元件會在每個對話回合中擷取使用者輸入的字元片段，並將這些片段連接起來，形成最終序列。每個區塊可接受的最小和最大長度，可透過輸入參數設定。
系統會持續擷取序列，直到使用者透過輸入內容表示已完成序列，且符合 prebuilt_components_confirmation_done intent。
拼音字母
這個元件支援使用語音拼字，例如 NATO 語音拼字。
| 使用者輸入內容 | 已擷取的序列 |
|---|---|
| alpha bravo charlie 123 | abc123 |
| A B Cat 1 2 3 | ABC123 |
| A 代表 apple (蘋果)、B 代表 banana (香蕉)、C 代表 chili (辣椒)、15 代表 15 分鐘 | ABC115 |
其他功能
這個預先建構的元件會提供下列額外功能：
對話方塊範例
以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為，這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。
單一區塊
使用者在一個區塊中提供英數字元序列，並說「我完成了」；代理程式成功接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| fvfd3433 | |
| 好的。我收到 fvfd3433，對嗎？ | |
| 是 | |
| 好的，請告訴我序列中的下一個 1 到 8 個字元。 | |
| 我沒問題了 | |
| 感謝確認！我收到的最終英數字元序列是 fvfd3433，對嗎？ | |
| 是 | |
| 太好了，我已收集到英數字元序列。 |
多個區塊
使用者以 2 個區塊提供英數字元序列，代理程式成功接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| fvfd3433 | |
| 好的。我收到 fvfd3433，對嗎？ | |
| 是 | |
| 好的，請告訴我序列中的下一個 1 到 8 個字元。 | |
| gh67 | |
| 好的。我收到 gh67，對嗎？ | |
| 是 | |
| 好的，請告訴我序列中的下一個 1 到 8 個字元。 | |
| 我沒問題了 | |
| 感謝確認！我收到的最終英數字元序列是 fvfd3433gh67，對嗎？ | |
| 是 | |
| 太好了，我已收集到英數字元序列。 |
重試成功
使用者提供英數字元序列；服務專員再次提示使用者確認。使用者對確認訊息說「否」，並再次提供英數字元序列；服務專員成功接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| fvfd3433 | |
| 好的。我收到 fd3433，對嗎？ | |
| 否 | |
| 很抱歉，請再提供前 1 到 8 個字元。 | |
| fvfd3433 | |
| 好的。我收到 fvfd3433，對嗎？ | |
| 是 | |
| 好的，請告訴我序列中的下一個 1 到 8 個字元。 | |
| 我沒問題了 | |
| 感謝確認！我收到的最終英數字元序列是 fvfd3433，對嗎？ | |
| 是 | |
| 太好了，我已收集到英數字元序列。 |
重試失敗
使用者無法在三次嘗試內提供 1 到 8 個英數字元的序列，因此元件會退出流程。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| 123N | |
| 好的。我得到 123M，對嗎？ | |
| 否 | |
| 很抱歉，請再提供前 1 到 8 個字元。 | |
| 123N | |
| 好的。我得到 123M，對嗎？ | |
| 否 | |
| 很抱歉，請再提供前 1 到 8 個字元。 請將序列中的每個字母拼寫出來，並加上以該字母開頭的單字。舉例來說，如果序列是 AB123，請說「Apple Baby 123」。 |
|
| 123 Nest | |
| 好的。我收到 123N，對嗎？ | |
| 否 | |
| 很抱歉，我嘗試次數過多，無法收集英數字元序列。 |
拼音字母
使用者提供英數字元序列；服務專員再次提示使用者確認。使用者連續兩次拒絕確認，系統啟用拼音轉換功能，使用者再次提供英數字元序列；服務專員成功接受。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| 123N | |
| 好的。我得到 123M，對嗎？ | |
| 否 | |
| 很抱歉，請再提供前 1 到 8 個字元。 | |
| 123N | |
| 好的。我得到 123M，對嗎？ | |
| 否 | |
| 很抱歉，請再提供前 1 到 8 個字元。 請將序列中的每個字母拼寫出來，並加上以該字母開頭的單字。舉例來說，如果序列是 AB123，請說「Apple Baby 123」。 |
|
| 123 N 代表 Nancy | |
| 好的。我收到 123N，對嗎？ | |
| 是 | |
| 好的，請告訴我序列中的下一個 1 到 8 個字元。 | |
| 567BC | |
| 好的。我得到 567BC，對嗎？ | |
| 就這樣 | |
| 感謝確認！我最後得到的英數字元序列是 123N56BC。對嗎？ | |
| 沒錯 | |
| 太好了，我已收集到英數字元序列。 |
序列長度無效
使用者提供的英數字元序列長度超出預先定義的英數字元序列最小和最大長度。代理程式提示使用者重新開始，使用者拒絕，元件退出流程。
| 使用者輸入內容 | 服務專員回應 |
|---|---|
| 請先說出英數字元序列的前 1 到 8 個字元。完成後，請說出「完成了」來結束收藏。你也可以隨時說出「播放」來查看目前收集到的序列。 | |
| 123M | |
| 好的。我得到 123M，對嗎？ | |
| 完成 | |
| 很抱歉，您提供的英數字元序列長度超出 5 到 30 個字元的規定長度。要重新開始嗎？ | |
| 否 | |
| 很抱歉，我嘗試次數過多，無法收集英數字元序列。 |
命名慣例
這個預先建構的元件採用下列命名慣例：
| 功能 | 格式 | 範例 |
|---|---|---|
| 心流狀態 | [元件名稱] | 英數字元集合 |
| 元件專屬意圖 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_alphanumeric_collection_support_continue |
| 參數 | [param_name] | alphanumeric_max_length |
輸入參數
輸入參數是用來設定元件特定行為的參數。參數會由工作流程中的一或多個條件使用，用於決定元件的行為方式。流程範圍參數必須在元件的起始頁面中設定，如下所述。您可以透過呼叫流程或此元件的起始頁面，設定會話範圍參數。
您可以在流程的起始頁面中修改參數預設值，設定每個擷取作業和最終收集序列可接受的最小和最大長度。
這個預先建構的元件可接受下列輸入參數：
| 參數名稱 | 說明 | 輸入格式 |
|---|---|---|
| $flow.alphanumeric_min_length | 最終英數字元序列的長度下限。預設值為 1。 |
整數 |
| $flow.alphanumeric_max_length | 最終英數字元序列的長度上限。預設值為 30。 |
整數 |
| $flow.lower_limit | 使用者每次回合可提供的片段最短長度。預設值為 1。 |
整數 |
| $flow.upper_limit | 使用者每次回合可提供的片段長度上限。預設值為 8。 |
整數 |
如要設定此元件的輸入參數，請展開操作說明。
- 開啟 Dialogflow CX 控制台。
- 選擇 Google Cloud 專案。
- 選取所需的代理程式。
- 選取「Build」分頁標籤。
- 在「流程」部分中，按一下匯入的元件。
- 按一下「網頁」部分中的「首頁」。
- 按一下「Start」頁面中的「true」路徑。
- 在路徑視窗中，視需要編輯「參數預設值」值。
- 按一下 [儲存]。
輸出參數
輸出參數是會在退出元件後仍保持啟用的會話參數。這些參數包含元件收集的重要資訊。這個預先建構的元件會為下列輸出參數提供值：
| 參數名稱 | 說明 | 輸出格式 |
|---|---|---|
| alphanumeric_collection_alphanumeric_sequence | 這個參數會傳回元件擷取到的英數字元序列 | 字串 |
基本設定
如要設定這個預先建構的元件，請按照下列步驟操作：
完成
您的服務專員現在應已設定完成，可以開始測試。