命名集合預先建構元件

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

限制

除了常見的預建元件限制外，這項預建元件還有下列限制：

這項預建元件提供下列額外功能：

下列對話範例說明這項預建元件處理的常見情境。範例對話會示範透過電話呼叫元件時的行為，這會觸發預設歡迎意圖，並在對話開始時觸發第一個代理回覆。

使用者在第一輪提供全名，代理成功接受。

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

使用者無法在第一次嘗試時提供全名。接著，使用者在不同的對話回合中提供姓氏、名字和中間名，代理也成功接受。

使用者輸入內容	代理回覆
	你的全名為何？請告訴我你的名字、姓氏和中間名 (如果有的話)。
nice
	抱歉，我沒聽清楚。我們重新擷取姓名。擷取姓名之前，請協助確認姓名中是否有連字號、額外空格或單引號。
否
	首先，請提供您的名字。您的名字是？
Lawrence
	Lawrence。請問我拼的名字正確嗎？
是
	您的姓氏是？
頁面
	。請問你的姓氏拼法正確嗎？
是
	你有中間名嗎？
是
	你的中間名是什麼？
Edward
	Edward。請問我拼寫的中間名是否正確？
是
	謝謝 Lawrence。

使用者無法在第一次嘗試時提供全名。使用者接著在不同回合中提供名字、姓氏和中間名，並使用特殊字元，代理成功接受。

使用者輸入內容	代理回覆
	你的全名為何？請告訴我你的名字、姓氏和中間名 (如果有的話)。
nice
	抱歉，我沒聽清楚。我們重新擷取姓名。擷取姓名之前，請協助確認姓名中是否有連字號、額外空格或單引號。
是，我符合這些條件
	好的，這些特殊字元是在你的名字、中間名或姓氏中嗎？
名字
	請提供名字的第一部分，不含任何特殊字元。
Evan
	Evan。第一部分的拼寫是否正確？
是
	請告訴我接下來要輸入什麼：空格、撇號或連字號。
連字號鍵
	「連字號」。我是否正確擷取了你名字第一部分後方的名稱分隔符號？
是
	請拼出名字連字號後面的部分。請只說出字母，例如 J-O-H-N。
James
	James。如果拼錯、拼完或需要空格、撇號或連字號，請告訴我。
我完成了
	您的姓氏是？
Mady
	Mady。請問你的姓氏拼法正確嗎？
是
	你有中間名嗎？
否
	謝謝你，Evan-James。

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

使用者輸入內容	代理回覆
	你的全名為何？請告訴我你的名字、姓氏和中間名 (如果有的話)。
[No-input]
	抱歉，我聽不清楚。你的全名為何？
[No-input]
	嗯，我還是聽不到你的聲音。請試著提高音量，或前往較安靜的地方。
[No-input]
	抱歉，我不懂你的意思。

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

功能	格式	範例
Flow	[Component Name]	命名珍藏內容
元件專屬意圖	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	這個參數會傳回元件擷取的使用者中間名。如果未收集中間名，參數會是空字串	字串

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

代理應已設定完成，可以開始測試。