命名集合預先建構元件

這個預先建構的元件會擷取姓氏、名字和選用的中間名，以及任何空格、連字號或撇號。

限制

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

這個預先建構的元件會提供下列額外功能：

以下對話方塊範例說明這個預先建構元件處理的常見情境。以下對話方塊範例說明透過電話呼叫元件時的行為，這會在對話開始時觸發預設歡迎意圖和第一個服務專員回應。

使用者在第一回合中提供全名，服務專員成功接受。

使用者輸入內容	服務專員回應
	你的全名為何？請告訴我你的姓名和中間名 (如果有的話)。
Sundar Pichai
	確認一下，你的名字是 Sundar，姓氏是 Pichai。我拼寫的全名正確嗎？
是
	您是否有中間名字？
否
	謝謝你，Sundar。

使用者無法在第一次嘗試時提供全名。使用者接著在不同回合中提供自己的名字、姓氏和中間名，服務專員則成功接受。

使用者輸入內容	服務專員回應
	你的全名為何？請告訴我你的姓名和中間名 (如果有的話)。
不錯
	抱歉，我沒聽清楚。我們來重新擷取你的姓名。擷取姓名之前，請確認你的姓名是否含有連字號、多餘的空格或撇號？
否
	我們先擷取你的名字。你的名字是什麼？
Lawrence
	勞倫斯。我拼寫的名字是否正確？
是
	你的姓氏是什麼？
頁面
	頁面。我拼寫的姓氏是否正確？
是
	您是否有中間名字？
是
	你的中間名字是什麼？
Edward
	Edward。我拼寫的中間名是否正確？
是
	謝謝你，Lawrence。

使用者無法在第一次嘗試時提供全名。接著，使用者會在不同回合中提供自己的姓氏、名字和中間名，並使用特殊字元；服務專員順利接受。

使用者輸入內容	服務專員回應
	你的全名為何？請告訴我你的姓名和中間名 (如果有的話)。
不錯
	抱歉，我沒聽清楚。我們來重新擷取你的姓名。擷取姓名之前，請確認你的姓名是否含有連字號、多餘的空格或撇號？
是的
	好的，這些特殊字元是否出現在你的名字、中間名或姓氏中？
名字
	請告訴我你的名字中的第一個字母，不要加上任何特殊字元。
Evan
	Evan，我是否正確拼寫第一個部分？
是
	請告訴我接下來是空格、撇號還是連字號。
連字號鍵
	「連字號」。我是否正確擷取姓氏第一個字後面的名稱分隔符號？
是
	請拼出名字中連字號後面的部分。只說出字母，例如 J-O-H-N。
Juan
	James。請告訴我是否有錯誤、是否結束，或是下一個字元是空格、撇號或連字號。
我完成了
	你的姓氏是什麼？
Mady
	Mady，我拼寫的姓氏是否正確？
是
	您是否有中間名字？
否
	謝謝你，Evan-James。

當使用者連續三次未提供輸入內容，元件就會退出流程。

使用者輸入內容	服務專員回應
	你的全名為何？請告訴我你的姓名和中間名 (如果有的話)。
[無輸入]
	抱歉，我沒聽清楚你說什麼，你的全名為何？
[無輸入]
	嗯，我還是聽不到你的聲音。請試著提高說話音量，或移動到較安靜的區域。
[無輸入]
	抱歉，我不懂你的意思。

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

功能	格式	範例
心流狀態	[元件名稱]	命名集合
元件專屬意圖	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_name_collection_special_characters_decider
實體類型	prebuilt_components_[component_name]_[entity_type_name]	prebuilt_components_name_collection_first_name
參數	[param_name]	user_provided_first_name

輸出參數是會在退出元件後仍保持啟用的會話參數。這些參數包含元件收集的重要資訊。這個預先建構的元件會為下列輸出參數提供值：

參數名稱	說明	輸出格式
name_collection_first_name	這個參數會傳回元件擷取的使用者提供的名字	字串
name_collection_last_name	這個參數會傳回元件擷取的使用者提供的姓氏	字串
name_collection_middle_name	這個參數會傳回元件擷取的使用者提供的中間名稱。如果沒有收集中間名，參數會是空字串	字串

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

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