为集合预构建组件命名

此预构建组件会捕获名字、姓氏和可选的中间名，以及任何空格、连字符或撇号。

限制

除了常见的预构建组件限制之外，此预构建组件还具有以下限制：

此预构建组件提供以下附加功能：

以下示例对话展示了此预构建组件处理的常见场景。示例对话演示了通过电话呼叫组件时的行为，这会在对话开始时触发默认欢迎 intent 和第一个代理响应。

最终用户在第一轮对话中提供了全名；代理成功接受了该信息。

用户输入	智能体回答
	您的全名是什么？请告诉我您的名字、姓氏和中间名（如有）。
Sundar Pichai
	确认一下，您的名字是 Sundar，姓氏是 Pichai。我拼写的全名是否正确？
是
	您有中间名吗？
否
	谢谢 Sundar。

最终用户无法在第一次尝试时提供全名。然后，最终用户在不同的回合中提供其名字、姓氏和中间名；代理成功接受了这些信息。

用户输入	智能体回答
	您的全名是什么？请告诉我您的名字、姓氏和中间名（如有）。
nice
	抱歉，我没听明白。我们重新开始采集姓名。在采集姓名之前，请帮我确认您的姓名中是否包含连字符、多余空格或撇号。
否
	我们先来获取您的名字。您的名字是什么？
Lawrence
	Lawrence。我拼写的名字正确吗？
是
	您的姓氏是什么？
页面
	页面。我拼写的姓氏正确吗？
是
	您有中间名吗？
是
	您的中间名是什么？
Edward
	Edward。我拼写的中间名是否正确？
是
	谢谢 Lawrence。

最终用户无法在第一次尝试时提供全名。然后，最终用户在不同的对话轮次中提供其名字、姓氏和中间名，其中包含特殊字符；智能体成功接受了这些信息。

用户输入	智能体回答
	您的全名是什么？请告诉我您的名字、姓氏和中间名（如有）。
nice
	抱歉，我没听明白。我们重新开始采集姓名。在采集姓名之前，您能否帮我确认一下您的姓名中是否包含连字符、多余空格或撇号？
是，我符合
	知道了。这些特殊字符是在您的名字、中间名还是姓氏中？
名字
	请告诉我您名字中第一个特殊字符之前的部分。
Evan
	Evan。我是否拼写正确了第一部分？
是
	请告诉我接下来是什么：空格、单引号还是连字符。
连字符
	“hyphen”。我是否正确记录了您名字第一部分后面的分隔符？
是
	请拼写出您名字中连字符后面的部分。请只说出字母，例如 J-O-H-N。
James
	James。如果不对，请告诉我。如果这就是结尾，或者接下来是空格、撇号或连字符，也请告诉我。
我没问题了
	您的姓氏是什么？
Mady
	Mady。我拼写的姓氏正确吗？
是
	您有中间名吗？
否
	谢谢，Evan-James。

在最终用户三次未提供输入后，组件退出流程。

用户输入	智能体回答
	您的全名是什么？请告诉我您的名字、姓氏和中间名（如有）。
[无输入]
	抱歉，我没听清。您的全名是什么？
[无输入]
	嗯，我还是听不到您的声音。请尝试大声说话或换到更安静的地方。
[无输入]
	抱歉，我没听懂您的回答。

此预构建组件使用以下命名惯例：

功能	格式	示例
Flow	[Component Name]	为合集命名
组件特定 intent	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	此参数会返回组件捕获的用户提供的中间名。如果未收集中间名，则该参数将为空字符串	字符串

如需设置此预构建组件，请执行以下操作：

您的代理现在应该已设置完毕，可以进行测试了。