地址收集预构建组件

地址收集预构建组件会从最终用户收集地址，并使用 Google Address Validation API 验证地址。

限制

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

• 仅支持 Address Validation API 覆盖范围详情中列出的国家/地区的地址。

其他功能

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

• 重复
• 等候室
• 播放

对话框示例

以下示例对话框演示了此预构建组件处理的常见场景。示例对话框演示了通过电话调用组件时的行为，这会触发默认欢迎 intent 并在对话开始时发出第一个客服人员回复。

完整有效的地址

最终用户提供完整的地址，地址收集组件成功验证该地址。

包含推断元素的部分有效地址

最终用户提供部分地址；客服人员猜测缺失的部分，并在最终用户确认后成功验证。

包含用户提供元素的部分有效地址

最终用户提供部分地址；客服人员猜测缺失的部分，但最终用户在说“不”后提供了自己的输入，客服人员成功接受了地址。

无法识别所输入的内容

最终用户提供无法识别的输入三次后，组件会退出流程。

地址不受支持

当最终用户提供 Address Validation API 目前不支持的地址后，组件会退出流程。

地址验证

如需了解地址收集组件如何验证地址，请参阅 Address Validation API 概览。

地址收集组件使用 @sys.address 系统实体捕获最终用户输入，并将捕获的地址发送到 Address Validation API 以提取地址元素以供进一步处理。

Address Validation API 会返回以下地址元素，该组件会使用这些元素收集和验证完整地址：

• administrative_area_level_1
• 群岛
• country
• locality
• postal_code
• route
• street_number

您可以使用受支持的地区中的任何地址试用 Google 地址验证演示。

命名规则

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

输入参数

输入参数是用于配置组件的特定行为的参数。流程中一个或多个条件将使用这些参数来确定组件的行为方式。必须在组件的开始页面上设置流程级范围的参数，如下所述。会话级范围的参数可以通过调用流程或在此组件的首页上设置。

您可以通过修改流程的开始页面中的参数预设值，配置此组件所需的地址元素。

此预构建组件接受以下输入参数：

输出参数

输出参数是会话参数，会在退出组件后保持有效状态。这些参数包含组件收集的重要信息。此预构建组件会为以下输出参数提供值：

{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}

string

基本设置

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

1. 导入预构建组件。
2. 启用 Address Validation API。
3. 使用您的 Google 地图 API 密钥配置提供的灵活 webhook，请参阅下文中的 Webhook 设置。

网络钩子设置

如需使用 Address Validation API 验证地址，您需要使用正确的凭据配置提供的灵活的 webhook。

地址验证 Webhook

此 Webhook 会执行以下操作：

1. 处理捕获的 Conversational Agents (Dialogflow CX) 参数、构建请求，并使用 Address Validation API 验证地址。
2. 从 Google Address Validation API 响应中提取已确认、未确认、缺失和推断出的地址元素。

如需为此组件配置 webhook，您需要使用 Google 地图 API 密钥更新 webhook 设置。

1. 如需检索您的 API 密钥，请依次前往 Google Cloud Platform 控制台 > API 和服务 > 凭据，选择您的 Google 地图 API 密钥，然后复制“API 密钥”字段。

如需配置该 webhook，请执行以下操作：

1. 打开 Dialogflow CX 控制台。
2. 选择您的 Google Cloud 项目。
3. 选择您的代理。
4. 选择管理标签页。
5. 点击网络钩子。
6. 选择 prebuilt_components_address_collection:address_validation webhook。
7. 将 Conversational Agents (Dialogflow CX) Webhook 网址字段中的网址替换为包含您的 Google 地图 API 密钥的网址：https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
8. 在身份验证设置中，将“用户名”配置为 key，并将“密码”设置为您的 Maps API 密钥。
9. 点击保存。

完成

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