名称集合预构建组件

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

限制

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

此预构建组件提供了以下其他功能：

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

最终用户在第一轮提供全名，客服人员成功接受该全名。

用户输入	代理响应
	您的全名是什么？请告诉我你的姓氏、名字和中间名（如果有的话）。
Sundar Pichai
	确认一下，你的名字是 Sundar，姓氏是 Pichai。我拼对了你的全名吗？
是
	你有中间名吗？
无
	谢谢，Sundar。

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

用户输入	代理响应
	您的全名是什么？请告诉我你的姓氏、名字和中间名（如果有的话）。
nice
	抱歉，我没听明白。我们再来一次输入这个名称。在捕获您的姓名之前，能否请您确认一下您的姓名中是否包含连字符、多余的空格或撇号？
否
	让我们先来记录您的名字。请问您的名字是什么？
劳伦斯
	劳伦斯。我拼对了你的名字是否正确？
是
	您的姓氏是什么？
页面
	页面。我拼对你的姓氏了吗？
是
	你有中间名吗？
是
	您的中间名是什么？
Edward
	Edward。我拼对了你的中间名吗？
是
	谢谢，Lawrence。

最终用户在第一次尝试时无法提供全名。然后，最终用户用特殊字符依次提供他们的名字、姓氏和中间名；代理成功接受这个请求。

用户输入	代理响应
	您的全名是什么？请告诉我你的姓氏、名字和中间名（如果有的话）。
nice
	抱歉，我没听明白。我们再来一次输入这个名称。在捕获您的姓名之前，能否请您确认一下您的姓名中是否包含连字符、多余的空格或撇号？
是，我有
	知道了。您的名字、中间名或姓氏中是否包含这些特殊字符？
名字
	请告诉我你名字的前半部分，在特殊字符前面。
Evan
	Evan。第一部分拼写正确吗？
是
	请说出接下来的内容：空格、撇号或连字符。
连字符
	“连字符”。我是否正确捕获了名字第一部分之后的名称分隔符？
是
	请拼出你名字的下一部分（连字符后）。请只说出字母，例如 J-O-H-N。
华健
	James。请告知我说的是不是错了，如果是结尾，或者接下来是空格、撇号或连字符。
我没问题了
	您的姓氏是什么？
麦迪
	妈妈。我拼对你的姓氏了吗？
是
	你有中间名吗？
无
	谢谢 Evan-James。

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

用户输入	代理响应
	您的全名是什么？请告诉我你的姓氏、名字和中间名（如果有的话）。
[无输入]
	抱歉，我没听清。您的全名是什么？
[无输入]
	抱歉，我还是听不到你的声音。请大声说话或移到更安静的地方。
[无输入]
	抱歉，我没听懂你的回复。

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

特征	形式	示例
流	[组件名称]	名称集合
组件专用 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	此参数返回由组件捕获的由用户提供的中间名。如果未收集中间名，该参数将为空字符串	字符串

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

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