此预构建组件会捕获名字、姓氏和可选中间名，以及所有空格、连字符或撇号。
限制
除了常见的预构建组件限制之外，此预构建组件还具有以下限制：
- 此组件不支持在空格、撇号和连字符之外包含特殊字符的名称。
其他功能
此预构建组件提供了以下其他功能：
示例对话框
以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为，这会在对话开始时触发“默认欢迎意图”和第一个代理响应。
全名
最终用户在第一轮提供全名，客服人员成功接受该全名。
| 用户输入 | 代理响应 |
|---|---|
| 您的全名是什么？请告诉我你的姓氏、名字和中间名（如果有的话）。 | |
| 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 | 此参数返回由组件捕获的由用户提供的中间名。如果未收集中间名，该参数将为空字符串 | 字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
完成
您的代理现在应已设置完毕，可以进行测试了。