借助“开立账号” 预构建组件 ，新用户和现有用户可以开立新账号或查看 现有申请的状态。此组件使用 “收集出生日期”、 “收集姓名”和 “收集电话号码” 预构建组件来收集用户的信息，以便注册新账号。
账号类型
默认情况下，此组件支持以下账号类型：
- 储蓄账号
- 支票账号，也称为活期账号
- 实物账户
- 薪资账号
您可以通过修改 prebuilt_components_open_account_account_type 自定义实体来添加或移除受支持的账号类型。
限制
除了 常见的预构建组件限制之外， 此预构建组件还具有以下限制：
- 此组件不会加密任何数据。
对话示例
以下对话示例展示了此预构建组件处理的常见场景。这些对话示例展示了通过电话调用组件时的行为，即在对话开始时触发默认欢迎意图和第一个智能体回答。
新用户
智能体收集用户的手机号码，并识别出该用户未注册账号。然后，智能体收集用户的全名和出生日期等详细信息，并生成申请，该申请会发送到用户提供的电话号码。
| 用户输入 | 智能体回答 |
|---|---|
| 请提供电话号码以进行验证。 | |
| 智能体使用“收集电话号码”预构建组件收集用户的电话号码 | |
| 太棒了，我们已收集完电话号码。 很高兴您想在我们这里开立账号。 |
|
| 智能体使用“收集姓名”预构建组件收集用户的全名 | |
| 谢谢您，John Doe。 | |
| 智能体使用“收集出生日期”预构建组件收集用户的电话号码 | |
| 太棒了，我们已收集到您的出生日期。 您想开立哪种类型的账号？您可以说“储蓄”“支票”“薪资”或“实物”。 |
|
| 活期账号 | |
| 请确认，您想开立新的支票账户，对吗？ | |
| 是 | |
| 感谢您提供信息。请稍候，我们会生成您的申请。 您的应用 ID 为 81037。请点击注册手机号码上提供的链接，完成申请。 |
现有用户
智能体识别出用户之前已通过身份验证，并确认用户想开立哪种类型的账号。智能体为用户创建申请，并将说明发送到用户注册的手机号码。
| 用户输入 | 智能体回答 |
|---|---|
| 很高兴您想在我们这里开立新账号。 您想开立哪种类型的账号？您可以说“储蓄”“支票”“薪资”或“实物”。 |
|
| 请开立储蓄账号 | |
| 请确认，您想开立新的储蓄账号，对吗？ | |
| 是的，没错 | |
| 感谢您提供信息。请稍候，我们会生成您的申请。 您的应用 ID 为 21430。请点击注册手机号码上提供的链接，完成申请。 |
现有申请
智能体识别出用户之前已开立一个申请，并向用户显示当前状态。用户拒绝为新账号开立其他申请。
| 用户输入 | 智能体回答 |
|---|---|
| 请提供电话号码以进行验证。 | |
| 智能体使用“收集电话号码”预构建组件收集用户的电话号码 | |
| 太棒了，我们已收集完电话号码。 您开立储蓄账号的申请（ID 为 12234）正在处理中。您想开立其他账号吗？ |
|
| 否 | |
| 好的，谢谢您致电我们。 |
命名规则
此预构建组件使用以下命名规则：
| 功能 | 格式 | 示例 |
|---|---|---|
| Flow | [组件名称] | 开立账号 |
| 组件专用意图 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| 实体类型 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
输入参数
输入参数是用于配置组件某些行为的参数。这些参数将由 flow 中的一个或多个条件使用，以确定组件应如何运行。flow 范围的参数必须在组件的起始页上设置，如下所述。会话级范围的参数可以由调用 flow 设置，也可以在此组件的起始页上设置。
此预构建组件接受以下输入参数：
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.auth_level | （可选）表示调用方的身份验证级别。 | 整数 |
| $session.params.phone_number | （可选）客户用于身份验证的注册手机号码。 | 字符串 |
| $session.params.min_age_limit | 指定开立新账号的用户允许的最低年龄。默认值为 18。 |
整数 |
| $session.params.max_age_limit | 指定开立新账号的用户允许的最高年龄。默认值为 100。 |
整数 |
| $flow.max_dob_retry_count | 指定在收集有效出生日期时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_account_type | 指定在收集用户想开立的账号类型时允许的重试次数。默认值为 2。 |
整数 |
| $flow.max_retry_another_account | 指定在用户想更改所选账号类型时允许的重试次数。默认值为 2。 |
整数 |
如需为此组件配置输入参数，请展开即可查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的智能体。
- 选择构建 标签页。
- 点击Flows部分中导入的组件。
- 点击Pages部分中的起始页。
- 点击起始页中的 true 路由。
- 在“路由”窗口中，根据需要修改参数预设 值。
- 点击保存 。
输出参数
输出参数是会话参数，在退出组件后仍会保持有效状态。这些参数包含组件收集的重要信息。此预构建组件为以下输出参数提供值：
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| transfer_reason | 此参数表示 flow 退出的原因（如果 flow 未成功退出）。返回的值为以下其中一项：agent：最终用户在对话期间的某个时间点请求人工智能体。denial_of_information：最终用户拒绝分享组件请求的信息。max_no_input：对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。max_no_match：对话达到了无匹配事件的最大重试次数。请参阅无匹配内置事件。webhook_error：发生了 Webhook 错误。请参阅 webhook.error 内置事件。webhook_not_found：网络钩子网址无法访问。请参阅 webhook.error.not-found 内置事件。 |
字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
- 导入预构建组件。
- 使用描述外部服务的配置来配置提供的 灵活 Webhook，请参阅下面的 Webhook 设置。
Webhook 设置
如需使用此组件，您需要配置包含的 灵活 Webhook，以从外部服务检索 所需的信息。
电话验证
组件使用 prebuilt_components_open_account:telephone_verification Webhook 获取与用户电话号码关联的注册账号和之前的申请的相关信息。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
API 响应参数
以下参数从 API 响应中提取，供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| account_count | 与注册电话号码关联的账号数量。这些账号包括用户自己的账号，以及用户拥有代理权的账号。如果给定电话号码未关联任何账号，则此值为 null。 |
整数 |
| user_first_name | 注册用户的名字。如果电话号码未关联任何注册账号，则此值为 null。 |
字符串 |
| user_last_name | 注册用户的姓氏。如果电话号码未关联任何注册账号，则此值为 null。 |
字符串 |
| user_dob | 注册用户的出生日期，格式为“YYYY-MM-DD”。如果电话号码未关联任何注册账号，则此值为 null。 |
字符串 |
| application_count | 与注册电话号码关联的申请数量。如果给定电话号码未关联任何申请，则此值为 null。 |
整数 |
| application_id | 列表，其中包含与给定电话号码关联的每个应用的 应用 ID，例如 ["00000", "11111", "22222"]。此列表中的每个元素表示的申请与 account_type 和 application_status 中具有相同索引的元素表示的申请相同。如果给定电话号码未关联任何申请，则此值为 null。 |
列表（字符串） |
| account_type | 列表，其中包含与给定电话号码关联的每个申请的账号类型，例如["savings", "checking", "demat"]。此列表中的每个元素表示的申请与 application_id 和 application_status 中具有相同索引的元素表示的申请相同。如果给定电话号码未关联任何申请，则此值为 null。 |
列表（字符串） |
| application_status | 列表，其中包含与给定电话号码关联的每个申请的状态，例如 ["in progress", "on hold", "completed"]。此列表中的每个元素表示的申请与 application_id 和 account_type 中具有相同索引的元素表示的申请相同。 如果给定电话号码未关联任何申请，则此值为 null。 |
列表（字符串） |
如需为此组件配置电话验证 Webhook，请展开即可查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的智能体。
- 选择管理 标签页。
- 点击Webhook。
- 选择 prebuilt_components_open_account:telephone_verification Webhook。
- 将 Dialogflow CX 网络钩子网址 字段中的网址替换为您要集成的服务的端点。在下拉列表中选择适当的方法 。
- 检查并更新请求正文 ，以形成适合您的 Webhook 的请求格式。
- 检查并更新响应配置 ，以从 Webhook 的 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问 返回的字段值。
- 根据需要检查并更新身份验证 设置。
- 点击保存 。
生成申请
组件使用 prebuilt_components_open_account:generate_application Webhook 为新账号生成申请。
API 请求参数
以下参数由组件提供，作为 API 请求的输入。
| 参数名称 | 说明 | 输入格式 |
|---|---|---|
| $session.params.phone_number | 用户的本地手机号码（不含国家/地区代码），用于识别用户。 | 字符串 |
| user_first_name | 用户的名字。 | 字符串 |
| user_last_name | 用户的姓氏。 | 字符串 |
| user_dob | 用户的出生日期，格式为“YYYY-MM-DD”。 | 字符串 |
API 响应参数
以下参数从 API 响应中提取，供组件使用。
| 参数名称 | 说明 | 输出格式 |
|---|---|---|
| application_id | 为新账号申请生成的应用 ID。 | 字符串 |
如需为此组件配置“生成申请”Webhook，请展开即可查看说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的智能体。
- 选择管理 标签页。
- 点击Webhook。
- 选择 prebuilt_components_open_account:generate_application Webhook。
- 将 Dialogflow CX 网络钩子网址 字段中的网址替换为您要集成的服务的端点。在下拉列表中选择适当的方法 。
- 检查并更新请求正文 ，以形成适合您的 Webhook 的请求格式。
- 检查并更新响应配置 ，以从 Webhook 的 响应中提取特定字段。请勿修改参数名称，因为组件需要这些名称才能访问 返回的字段值。
- 根据需要检查并更新身份验证 设置。
- 点击保存 。
完成
您的智能体及其 Webhook 现在应已设置完毕，可以进行测试了。