Fulfillment

每轮对话过程中，代理必须通过回答问题，询问信息或终止会话来响应最终用户。您的代理可能还需要与您的服务联系，以生成动态响应或执行操作。Fulfillment 用于完成所有这些操作。

fulfillment 可能包含以下任一选项：

静态响应消息。
用于动态响应和/或执行操作的网络钩子调用。
用于设置或替换参数值的参数预设。

在代理每轮对话期间，系统可以（且有时需要）调用多个 fulfillment，每个 fulfillment 都可以生成响应消息。Dialogflow 会在响应队列中维护这些响应。代理的每轮对话结束后，Dialogflow 会将已排序的响应发送给最终用户。

ES fulfillment 仅限于连接 webhook 服务。 CX 的 fulfillment 范围扩大了，因此现在涵盖了所有类型的提示和响应。

Fulfillment 用例

在所有需要响应消息的地方使用 Fulfillment：

对于每种用例，控制台都会打开一个 Fulfillment 修改面板。

Fulfillment 屏幕截图

静态响应消息（对话选项）

静态响应消息是您在设计时定义的代理响应。您可以在创建 fulfillment 时定义它们。在运行时，这些响应将添加到响应队列中。

有几种类型的响应消息，我们将在下面的小节中进行介绍。使用控制台时，Fulfillment 面板有一个初始文本响应消息卡片，但您可以点击添加对话框选项以给其他响应消息类型添加更多卡片。

文本

文本响应消息向最终用户发送文本对话框。如果您的检测意图 API 调用或集成调用使用语音合成，则此文本将用于生成音频内容。在这种情况下，提供的文本可以选择使用语音合成标记语言 (SSML)。

您可以定义多个文本响应卡片，并在每个卡片中定义多个文本响应。如果您定义了多个卡片，那么这些卡片会在运行时针对单个响应进行串联。如果您在一个卡片内定义多个响应，那么会在运行时随机选择该卡片中的一条消息。

这些文本消息可以包含参数引用和内嵌系统函数。

自定义负载

某些集成支持自定义载荷响应以处理丰富的响应。这些自定义载荷以集成文档中定义的 JSON 格式提供。例如，请参阅 Dialogflow Messenger 自定义载荷格式。

您可以在自定义载荷 JSON 中添加参数引用。它们应被视为 JSON 字符串值，因此应使用英文双引号引起来。例如：

{
  "someField": "$session.params.date"
}

您还可以将自定义载荷发送到您开发的集成。Dialogflow 不会处理这类载荷，因此您需要在自己的业务逻辑中进行处理。

在线客服人员交接

此响应会告知检测意图 API 调用方是否应将对话移交给人工客服。Dialogflow 仅使用以下信号来识别出于衡量目的而取消的会话，并且不会以任何方式更改会话状态。您的系统或集成可以使用此信号来采取任何必要的交流措施。Dialogflow 不会对此数据应用任何结构，因此您可以选择任何适合您系统的结构。

对话成功元数据

此响应会告知检测意图 API 调用方与 Dialogflow 代理之间的对话成功。Dialogflow 仅使用此信号来识别成功进行衡量的会话，并且不会以任何方式更改会话状态。您的系统或集成可以使用此信号执行任何必要的操作。Dialogflow 不会对此数据应用任何结构，因此您可以选择任何适合您系统的结构。

播放预先录制的音频

此响应会为支持此功能的集成播放音频文件。

不同集成的音频文件格式要求可能会有所不同。例如，请参阅 Dialogflow CX 电话网关的要求。

对于合作伙伴电话集成，您必须提供音频文件的可公开访问网址。例如，您可以使用 Cloud Storage 托管公开文件。

输出音频文本

此响应与文本响应类似，但仅适用于语音合成。如果代理可以处理文本和语音会话，您可以使用唯一文本和输出音频文本响应为文本和语音创建不同的用户体验。如果为语音会话提供了输出音频文本，纯文本响应将被忽略。

如果代理处理文本和语音会话，并且您希望使用相同的响应消息，则对文本和语音会话均使用文本响应。

输出音频文本的串联方式与文本响应类似。如果输出音频文本响应同时包含文本和 SSML，则串联结果被视为 SSML。代理设计人员最好一致地使用文本或 SSML。

条件式响应

此响应类型用于条件式响应。基本格式为：

if [condition]
  [response]
elif [condition]
  [response]
elif [condition]
  [response]
else
  [response]
endif

其中：

[condition] 与路由条件使用的格式相同
[response] 是文本响应
elif 和 else 块是可选的

例如：

if $session.params.user-age >= 21
  Ok, you may enter.
else
  Sorry, you cannot enter.
endif

[condition] 和 [response] 都可以使用内嵌系统函数在对话期间生成动态值。如需了解详情，请参阅系统函数和路由条件参考文档。

对于多语言代理，[condition] 对所有语言都是通用的，而 [response] 针对特定语言。如果您在控制台中更新了一种语言的 [condition]，则此部分会在代理的所有语言中进行更新，并且因为它成为新的条件，所以系统会针对除更新 [condition] 时选择的语言之外的其他所有语言清除 [response]。

电话转接来电

对于某些电话集成，您可以为来电转接指定美国电话号码。在运行时，当 Dialogflow 虚拟客服通过来电转接调用 fulfillment 时，该调用将被转接到指定的号码，并且虚拟客服处理将被暂停。

网络钩子调用

调用 fulfillment 并且 fulfillment 具有网络钩子时，代理会向您的网络钩子发送请求。您的网络钩子可以在您的服务中执行任何必要的操作，提供动态响应消息，替换参数值以及更改当前页面。

参数预设

您可以使用 fulfillment 提供用于设置或替换当前参数值的预设。系统会在解析静态响应消息或调用网络钩子之前应用这些预设。

您还可以使用系统函数将参数预设为动态生成的值。

以下是一些示例：

将参数 now 设置为当前时间：

参数值

现在 $sys.func.NOW()
将现有参数 counter 递增 1：

参数值

计数器 $sys.func.ADD($session.params.counter, 1)
将参数 new-cost 设置为 other-cost 参数值，同时保留完整的复合对象值：

参数值

新费用 $sys.func.IDENTITY($session.params.other-cost)

参数	值
现在	$sys.func.NOW()

参数	值
计数器	$sys.func.ADD($session.params.counter, 1)

参数	值
新费用	$sys.func.IDENTITY($session.params.other-cost)

高级语音设置

这些语音设置可以选择覆盖相同的页面语音设置、流语音设置和代理语音设置。

响应队列

在代理每轮对话期间，系统可以（且有时需要）调用多个 fulfillment，每个 fulfillment 都可以生成响应消息。Dialogflow 会在响应队列中维护这些响应。

流式传输 API 的部分响应

默认情况下，Dialogflow 仅在代理轮替完成后向最终用户发送有序响应。您还可以在 fulfillment 中启用返回部分响应选项，以便在使用流式传输 API 时将当前已加入队列的响应作为部分响应返回。如需了解详情，请参阅页面的生命周期。

例如，如果您的网络钩子很可能会运行很长时间，则您可以在 fulfillment 中添加一个静态响应并启用部分响应。这样，Dialogflow 便可以刷新响应队列，并在调用网络钩子之前将所有消息作为部分响应进行发送。

如需在模拟器中测试此功能，您也需要启用部分响应。

模拟器中的部分响应的屏幕截图

在以下示例中，假设您的网络钩子需要 5 秒才能完成，并且您未启用部分响应。在网络钩子完成之前，Dialogflow 代理的对话回合不会结束。在此 5 秒回合期间，响应会在等待网络钩子完成期间位于队列中，并且在回合完成之前不会返回给最终用户。这会导致糟糕的用户体验。

未启用部分响应。

如果您在第一个 fulfillment 中启用部分响应，则 Dialogflow 会快速返回第一个 fulfillment 消息并调用网络钩子。网络钩子完成后，Dialogflow 会返回最终响应。在这种情况下，最终用户体验会得到改善，因为系统会指示他们等待一小段时间。此外，网络钩子调用会与发送到最终用户的响应并发执行。

启用了部分响应。

参数

Webhook