此 预构建组件 可捕获名字、姓氏和可选的中间名，以及任何空格、连字符或 撇号。
限制
除了 常见的预构建组件限制之外， 此预构建组件还具有以下限制：
- 此组件不支持在空格、撇号和连字符之外包含特殊字符的名称。
其他功能
此预构建组件提供以下其他功能：
对话示例
以下对话示例展示了此预构建组件处理的常见场景。这些对话示例展示了通过电话调用组件时的行为，即在对话开始时触发默认欢迎意图和第一个智能体回答。
全名
最终用户在第一轮对话中提供全名；智能体成功接受该全名。
| 用户输入 | 智能体回答 |
|---|---|
| 您的全名是什么？请告诉我您的名字、姓氏和中间名（如果有）。 | |
| Sundar Pichai | |
| 确认一下，您的名字是 Sundar，姓氏是 Pichai。我拼对您的全名了吗？ | |
| 是 | |
| 您有中间名吗？ | |
| 否 | |
| 谢谢您，Sundar。 |
分部分提供全名
最终用户无法在第一次尝试时提供全名。然后，最终用户在不同的轮次中分别提供名字、姓氏和中间名；智能体成功接受这些信息。
| 用户输入 | 智能体回答 |
|---|---|
| 您的全名是什么？请告诉我您的名字、姓氏和中间名（如果有）。 | |
| nice | |
| 抱歉，我没听清楚。我们重新开始捕获名称。 在捕获您的名称之前，请先确认您的名称中是否包含连字符、多余的空格或撇号。 |
|
| 否 | |
| 我们先来捕获您的名字。 您的名字是什么？ |
|
| Lawrence | |
| Lawrence。我拼对您的名字了吗？ | |
| 是 | |
| 您的姓氏是什么？ | |
| Page | |
| Page。我拼对您的姓氏了吗？ | |
| 是 | |
| 您有中间名吗？ | |
| 是 | |
| 您的中间名是什么？ | |
| Edward | |
| Edward。我拼对您的中间名了吗？ | |
| 是 | |
| 谢谢您，Lawrence。 |
特殊字符
最终用户无法在第一次尝试时提供全名。然后，最终用户在不同的轮次中分别提供名字、姓氏和中间名，其中包含特殊字符；智能体成功接受这些信息。
| 用户输入 | 智能体回答 |
|---|---|
| 您的全名是什么？请告诉我您的名字、姓氏和中间名（如果有）。 | |
| nice | |
| 抱歉，我没听清楚。我们重新开始捕获名称。 在捕获您的名称之前，请先确认您的名称中是否包含连字符、多余的空格或撇号。 |
|
| 是 | |
| 知道了。这些特殊字符在您的名字、中间名还是姓氏中？ | |
| 名字 | |
| 请告诉我您的名字中在任何特殊字符之前的部分。 | |
| Evan | |
| Evan。我拼对第一部分了吗？ | |
| 是 | |
| 请告诉我接下来是什么：空格、撇号还是连字符。 | |
| 连字符 | |
| “连字符”。我正确捕获了您的名字中第一部分之后的名称分隔符吗？ | |
| 是 | |
| 请拼写出您的名字中连字符之后的下一部分。请仅说出字母，例如 J-O-H-N。 | |
| James | |
| James。请告诉我是否错误、是否结束，或者接下来是什么：空格、撇号还是连字符。 | |
| 我说完了 | |
| 您的姓氏是什么？ | |
| Mady | |
| Mady。我拼对您的姓氏了吗？ | |
| 是 | |
| 您有中间名吗？ | |
| 否 | |
| 谢谢您，Evan-James。 |
无输入
在最终用户三次未提供任何输入后，组件会退出流程。
| 用户输入 | 智能体回答 |
|---|---|
| 您的全名是什么？请告诉我您的名字、姓氏和中间名（如果有）。 | |
| [无输入] | |
| 抱歉，我没听到您说话。您的全名是什么？ | |
| [无输入] | |
| 嗯，我还是听不到您说话。请尝试大声说话，或移步至较为安静的地方。 | |
| [无输入] | |
| 抱歉，我难以理解您的回答。 |
命名规则
此预构建组件使用以下命名规则：
| 功能 | 格式 | 示例 |
|---|---|---|
| Flow | [组件名称] | Name Collection |
| 组件专用意图 | 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 |
| 参数 | [参数名称] | user_provided_first_name |
输出参数
输出参数是会话参数，在退出组件后仍会保持有效。这些参数包含组件收集的重要信息。此预构建组件为以下输出参数提供值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| name_collection_first_name | 此参数返回组件捕获的用户提供的名字 | 字符串 |
| name_collection_last_name | 此参数返回组件捕获的用户提供的姓氏 | 字符串 |
| name_collection_middle_name | 此参数返回组件捕获的用户提供的中间名。如果未收集到中间名，则该参数将为空字符串 | 字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
完成
您的智能体现在应该已设置完毕，可以进行测试了。