反馈预构建组件

反馈预构建组件会收集用户的定量和定性反馈。

该组件首先使用配置的 Check last feedback webhook 执行查找,以检查用户最近是否提供了反馈。如果近期没有反馈,该组件会要求用户提供 1 到 5 之间的量化反馈分数。如果反馈是负面的,该组件可以收集用户的自由形式定性反馈。

限制

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

  • 该组件假定您在客户关系管理 (CRM) 系统或其他服务中维护客户手机号码。
  • 此组件不会对使用备用手机号码与您联系的现有客户进行身份验证。

对话示例

以下示例对话展示了此预构建组件处理的常见场景。它们说明了当电话服务启动组件时会发生什么,这会在对话开始时触发默认欢迎 intent 和第一个代理响应。

正面反馈

检查上次反馈 webhook 的响应表明用户最近未提供反馈。客服人员请求用户提供反馈评分,用户给出了表示体验良好的评分。

用户输入 智能体回答
感谢您的来电。您的反馈对我们至关重要。请抽出一点时间,回答几个简短的问题,分享您对今天所获服务的看法。
如果 1 分表示最不满意,5 分表示最满意,您对今天所获服务的满意度是多少?
5
太棒了,感谢您的积极反馈。

负面反馈

检查上次反馈 webhook 的响应表明用户最近未提供反馈。智能体请求用户提供反馈评分,用户提供的评分表明其体验不佳。然后,代理会请求用户提供定性反馈。

用户输入 智能体回答
感谢您的来电。您的反馈对我们至关重要。请抽出一点时间,回答几个简短的问题,分享您对今天所获服务的看法。
如果 1 分表示最不满意,5 分表示最满意,您对今天所获服务的满意度是多少?
2
感谢您的反馈。请告诉我们,我们该如何为您提供更好的体验。
我的部分问题没有得到完整回答。
感谢您提供反馈。对于给您造成的不便,我们深表歉意,并会努力在下次为您提供更好的体验。

近期反馈

检查上次反馈 webhook 的响应表明用户最近提供了反馈,因此代理不会要求用户提供进一步的输入。

用户输入 智能体回答
感谢您与我们联系。

输入无效

检查上次反馈 webhook 的响应表明用户最近未提供反馈。智能体请求用户提供反馈分数,但用户多次提供无效输入。该组件以失败结束流程。

用户输入 智能体回答
感谢您的来电。您的反馈对我们至关重要。请抽出一点时间,回答几个简短的问题,分享您对今天所获服务的看法。
如果 1 分表示最不满意,5 分表示最满意,您对今天所获服务的满意度是多少?
-1
抱歉,我们没听明白。请输入 1、2、3、4 或 5 作为反馈评分。
100
抱歉,我们没听明白。请输入 1、2、3、4 或 5 作为反馈评分。
干得漂亮
很抱歉,重试次数已超出上限。请稍后再试。

命名规则

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

功能 格式 示例
Flow [Component Name] 反馈
参数 [param_name] feedback_score
网络钩子 prebuilt_components_[component_name]:[webhook_action] prebuilt_components_feedback:last_feedback_check

输入参数

输入参数用于配置组件的某些行为。流程中的一个或多个条件会使用这些参数来确定组件的行为。您必须在组件的起始页面上设置流级作用域参数,如下所述。您可以使用调用流或在此组件的起始页上设置会话级范围的参数。

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

参数名称 说明 输入格式
$session.params.phone_number 用户的本地手机号码,用于在 API 请求中标识用户。手机号码不应包含国家/地区代码。 字符串
$flow.minimum_feedback_score 指明被视为负面或正面反馈得分的阈值。低分(等于或低于此参数的值)表示负面体验,高分(大于此参数的值)表示正面体验。如果用户给出的评分较低,系统会要求用户提供定性反馈,询问他们如何改进体验。此参数的默认值是 3。 整数
$flow.feedback_max_retry_count 一个可配置的参数,用于捕获向用户提供的重试次数上限。为此参数指定的值应比可用尝试次数少 1。默认值为 2,这意味着来电者有三次机会提供所请求的信息。 整数

如需为此组件配置输入参数,请展开以查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择构建标签页。
  5. 在流部分中点击导入的组件。
  6. 点击页面部分中的“Start Page”。
  7. 点击“Start Page”中的 true 路由。
  8. 在“Route”(路线)窗口中,根据需要修改参数预设值。
  9. 点击保存。

输出参数

输出参数是在退出组件后仍保持活跃状态的会话参数。这些参数包含组件收集的重要信息。

此预构建组件会为以下输出参数提供值:

参数名称 说明 输出格式
feedback_score 捕获用户提供的反馈评分。有效值为 1 到 5 之间的整数(含边界值)。 整数
feedback_comment 捕获用户提供的定性评论(如果有)。 字符串
transfer_reason 指明流程未成功退出的原因。返回的值为以下值之一:

agent:用户在对话期间的某个时间点请求了人工客服。

denial_of_information:用户拒绝分享组件请求的信息。

max_no_input:对话达到了无输入事件的最大重试次数。请参阅无输入内置事件。

max_no_match:对话达到了不匹配事件的重试次数上限。请参阅不匹配内置事件。

webhook_error:发生了 webhook 错误。请参阅 webhook.error 内置事件。

webhook_not_found:网络钩子网址无法访问。请参阅 webhook.error.not-found 内置事件。
字符串

基本设置

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

  1. 导入预构建组件。
  2. 使用外部服务配置提供的灵活 webhook,请参阅 Webhook 设置。

Webhook 设置

如需使用此组件,请配置包含的灵活网络钩子,以便从外部服务检索必要的信息。

查看上次反馈

该组件使用 prebuilt_components_feedback:last_feedback_check webhook 检查用户最近是否提供了反馈。与此 webhook 集成的外部服务定义了先前提供的反馈被视为近期反馈的时间段,服务所有者可以配置此时间段。

API 请求参数

该组件提供以下参数作为 API 请求的输入:

参数名称 说明 输入格式
phone_number 用户的本地手机号码(不含国家/地区代码),用于识别用户。 字符串

API 响应参数

该组件会从 API 响应中检索以下参数:

参数名称 说明 输出格式
last_feedback_time_elapsed 指明用户最近是否提供了反馈。true 表示自用户上次提供反馈以来已过去足够长的时间,并且未找到近期反馈。false 表示用户最近提供了反馈,且距离上次提供反馈的时间还不够长。 布尔值

如需为此组件配置“检查上次反馈”Webhook,请展开查看说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhooks。
  6. 选择 prebuilt_components_feedback:last_feedback_check webhook。
  7. 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
  8. 查看并更新请求正文,为您的网络钩子设置正确的请求格式。
  9. 查看并更新响应配置,以从 webhook 的响应中提取特定字段。请勿修改参数名称,因为组件需要这些名称来访问返回的字段值。
  10. 根据需要查看并更新身份验证设置。
  11. 点击保存。

更新反馈

该组件使用 prebuilt_components_feedback:update_feedback webhook 将收集到的反馈发送到外部服务。

API 请求参数

该组件提供以下参数作为 API 请求的输入:

参数名称 说明 输入格式
phone_number 用户的本地手机号码(不含国家/地区代码),用于识别用户。 字符串
feedback_score 存储用户提供的反馈评分。预期值为 1 到 5 之间的整数(含边界值)。 整数
feedback_comment 存储用户提供的定性反馈评论。 字符串

如需为此组件配置“更新反馈”Webhook,请展开查看相关说明。

  1. 打开 Dialogflow CX 控制台。
  2. 选择您的 Google Cloud 项目。
  3. 选择您的代理。
  4. 选择管理标签页。
  5. 点击 Webhooks。
  6. 选择 prebuilt_components_feedback:update_feedback webhook。
  7. 将 Dialogflow CX 网络钩子网址字段中的网址替换为您要集成的服务的端点。在下拉菜单中选择适当的方法。
  8. 查看并更新请求正文,为您的网络钩子设置正确的请求格式。
  9. 查看并更新响应配置,以从 webhook 的响应中提取特定字段。请勿修改参数名称,因为组件需要这些名称来访问返回的字段值。
  10. 根据需要查看并更新身份验证设置。
  11. 点击保存。

完成

反馈预构建组件及其网络钩子现已设置完毕,可以进行测试。