反馈预构建组件用于收集最终用户的定量反馈和定性反馈。
该组件首先使用配置的检查上次反馈 webhook 执行查找,以检查该特定最终用户是否提供了最近的反馈。如果不存在近期反馈,该组件会要求用户提供 1 到 5 之间的定量反馈得分。如果反馈是负面的,则组件可以选择向用户收集自由格式的定性反馈。
限制
除了常见的预构建组件限制之外,此预构建组件还具有以下限制:
- 该组件假定客户手机号码保留在 CRM(客户关系管理)系统或其他服务中。
- 此组件不会对使用备用手机号码联系的现有客户进行身份验证。
示例对话框
以下示例对话框演示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为,该行为会在对话开始时触发“默认欢迎意图”和第一个代理响应。
正面反馈
检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户提供反馈评分,用户提供表示积极体验的评分。
用户输入 | 代理响应 |
---|---|
感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题,分享您对于今天获得的服务的看法。 您对今天获得的服务的满意度如何?请按 1 到 5 分,其中 1 表示最不满意,5 表示最满意? |
|
5 | |
太好了,感谢你的好评。 |
负面反馈
检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户提供反馈评分,用户提供表示负面体验的评分。然后,代理会要求用户提供定性反馈。
用户输入 | 代理响应 |
---|---|
感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题,分享您对于今天获得的服务的看法。 您对今天获得的服务的满意度如何?请按 1 到 5 分,其中 1 表示最不满意,5 表示最满意? |
|
2 | |
请告诉我们如何可以为您改善这一体验。 | |
我的一些问题没有得到彻底的回答。 | |
感谢您提供反馈。对于由此给您带来的不便,我们深表歉意,并努力让下次为您提供更好的体验。 |
近期反馈
检查上次反馈 webhook 的响应表示最终用户最近提供反馈,因此代理不会要求用户进一步输入。
用户输入 | 代理响应 |
---|---|
感谢您与我们联系。 |
输入无效
检查上次反馈 webhook 的响应表示最终用户最近未提供反馈。代理请求用户的反馈得分,并且用户多次提供无效输入。组件以失败结束流程。
用户输入 | 代理响应 |
---|---|
感谢您的来电。您的反馈对我们至关重要。请花点时间回答几个简短的问题,分享您对于今天获得的服务的看法。 您对今天获得的服务的满意度如何?请按 1 到 5 分,其中 1 表示最不满意,5 表示最满意? |
|
-1 | |
抱歉,无法识别你说的内容。请告诉我们反馈得分(1 分、2 分、3 分、4 分或 5 分)。 | |
100 | |
抱歉,无法识别你说的内容。请告诉我们反馈得分(1 分、2 分、3 分、4 分或 5 分)。 | |
不错 | |
抱歉,已超过最大重试次数。请稍后再试。 |
命名惯例
此预构建组件使用以下命名惯例:
特征 | 形式 | 示例 |
---|---|---|
流 | [组件名称] | 反馈 |
参数 | [参数名称] | feedback_score |
Webhook | 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 ,表示调用方将尝试三次,以提供请求的信息。 |
整数 |
如需配置此组件的输入参数,请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择 Build 标签页。
- 在流部分中,点击导入的组件。
- 点击网页部分中的初始页。
- 点击初始页中的 true 路由。
- 在“路由”窗口中,根据需要修改参数预设值。
- 点击保存。
输出参数
输出参数是退出组件后将保持有效的会话参数。这些参数包含该组件收集的重要信息。此预构建组件提供了以下输出参数的值:
参数名称 | 说明 | 输出格式 |
---|---|---|
feedback_score | 此参数会捕获最终用户提供的反馈得分。有效值为 1 到 5(包括 1 和 5)之间的整数。 | 整数 |
feedback_comment | 此参数会捕获最终用户提供的定性评论(如果有)。 | 字符串 |
transfer_reason | 此参数表示流程退出的原因(如果失败的话)。返回值为以下值之一:agent :最终用户在对话期间的某个时刻请求人工客服。denial_of_information :最终用户拒绝分享该组件请求的信息。max_no_input :对话已达到无输入事件的重试次数上限。请参阅无输入内置事件。max_no_match :对话已达到非匹配事件的重试次数上限。请参阅无匹配的内置事件。webhook_error :发生网络钩子错误。请参阅 webhook.error 内置事件。webhook_not_found :某个网络钩子网址无法访问。请参阅 webhook.error.not-found 事件。 |
字符串 |
基本设置
如需设置此预构建组件,请执行以下操作:
网络钩子设置
为了使用此组件,您需要配置所包含的灵活 webhook,以从外部服务中检索所需信息。
查看上次反馈
该组件使用 prebuilt_components_feedback:last_feedback_check
网络钩子来检查用户最近是否提供了反馈。之前提供的反馈被视为最新反馈的时间段由与此 webhook 集成的外部服务定义,可由服务所有者配置。
API 请求参数
以下参数由组件提供,作为 API 请求的输入。
参数名称 | 说明 | 输入格式 |
---|---|---|
phone_number | 用户的本地手机号码(不含国家/地区代码),用于识别用户。 | 整数 |
API 响应参数
以下参数是从 API 响应中提取的,供组件使用。
参数名称 | 说明 | 输出格式 |
---|---|---|
last_feedback_time_elapsed | 指明用户最近是否提供了反馈。true 表示自用户上次提供反馈以来经过了一段时间,但未找到最近的反馈。false 表示最近提供了反馈,自用户上次提供反馈以来未过多长时间。 |
boolean |
如需为此组件配置“检查上次反馈”网络钩子,请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 preview_components_feedback:last_feedback_check 网络钩子。
- 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
- 查看并更新请求正文,为网络钩子构建正确的请求格式。
- 查看并更新响应配置,以从 webhook 的响应中提取特定字段。请勿修改参数名称,因为组件需要这些名称才能访问返回的字段值。
- 查看并视需要更新 Authentication 设置。
- 点击保存。
更新反馈
该组件使用 prebuilt_components_feedback:update_feedback
网络钩子将收集的反馈发送到外部服务。
API 请求参数
以下参数由组件提供,作为 API 请求的输入。
参数名称 | 说明 | 输入格式 |
---|---|---|
phone_number | 用户的本地手机号码(不含国家/地区代码),用于识别用户。 | 字符串 |
feedback_score | 此参数会存储最终用户提供的反馈得分。预期值是 1 到 5(包括 1 和 5)之间的整数。 | 整数 |
feedback_comment | 此参数用于存储最终用户提供的定性反馈评论。 | 字符串 |
如需为此组件配置更新反馈网络钩子,请展开查看相关说明。
- 打开 Dialogflow CX 控制台。
- 选择您的 Google Cloud 项目。
- 选择您的代理。
- 选择管理标签页。
- 点击网络钩子。
- 选择 preview_components_feedback:update_feedback 网络钩子。
- 将 Dialogflow 网络钩子网址字段中的网址替换为您要集成的服务的端点。从下拉菜单中选择合适的方法。
- 查看并更新请求正文,为网络钩子构建正确的请求格式。
- 查看并更新响应配置,以从 webhook 的响应中提取特定字段。请勿修改参数名称,因为组件需要这些名称才能访问返回的字段值。
- 查看并视需要更新 Authentication 设置。
- 点击保存。
完成
现在,您的代理及其 webhook 应该已设置完毕,可以进行测试了。