Next Prompt Behavior 代码片段

本帮助页面上的信息同时适用于 CXone Studio 和 Desktop Studio。

Next Prompt Behavior 代码片段可使您自定义对话的特定轮次期间的行为。如果您想定义对话中所有轮次期间的默认行为，请使用 Default Next Prompt Behaviors 代码片段。您可以定义的行为包括舒适噪音、DTMF 当用户在电话按键上按下或敲击某个键时产生的信号音。检测、延迟和超时以及插入。您可以在提示行为帮助页面上了解有关这些行为的更多信息。

将此代码片段与具有 nextPromptBehavior 属性的操作一起使用，例如 Cloud Transcribe操作或 Voicebot Exchange操作。

每轮对话所需的时间

请务必计算对话中每一轮所需的时间。例如，如果没有停顿，说出 14 位数字可能需要 8 到 15 秒，但回答是或否只需要一两秒钟。要捕获整个号码，说出该号码的对话轮次必须比“是/否”轮次长。

在说出号码的轮次中，您必须将 maxUtteranceMilliseconds 增加到比默认设置更长的时间量。此外，您可能还希望该轮次的 maxPostEnergySilenceMS 更长。这将有助于确保联系人有时间说出号码。

要更改一个轮次的这些值，请在针对该轮次的 Voicebot Exchange 操作之前和之后放置一个 SNIPPET 操作。在 Voicebot Exchange 之前的 SNIPPET 中，更改您需要的设置。在 Voicebot Exchange 之后的 SNIPPET 中，将这些设置更改回来。

添加 Next Prompt Behavior 代码片段

在 Studio 中打开脚本。
在您要执行指定行为的 Voicebot Exchange 操作之前，将 Snippet 操作添加到脚本中。如果您将此代码片段用于非虚拟坐席应用程序，请将 Snippet 放在 Cloud Transcribe 操作之前。连接这些操作。

将以下对象声明添加到此代码片段中：

DYNAMIC nextPromptBehaviors
<add behaviors as needed>
ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"

使用以下语法添加您希望此操作执行的行为：

ASSIGN nextPromptBehaviors.[behavior] = [value]

其中 [behavior] 包括属性名称以及所有关联的成员和子成员名称。有关详细信息，请参阅以下部分中的示例代码片段代码。
使用用于保存 nextPromptBehaviors 对象的 JSON 内容的变量配置 Voicebot Exchange 或 Cloud Transcribe 操作的 nextPromptBehavior 属性。在该示例代码中，这是 nextPromptBehaviorsJson。

提示行为属性

下表描述了 Next Prompt Behavior 代码片段的可用属性。这些属性可使您配置下一个提示行为。这些行为在“虚拟坐席提示行为”帮助页面中有完整描述。如在与逐轮转录的非虚拟坐席应用程序一起使用时所描述的行为函数。

以下 Next Prompt Behavior 代码片段示例显示了用于每个属性的完整对象成员和子成员名称。

查看示例

DYNAMIC nextPromptBehaviors
ASSIGN nextPromptBehaviors.silenceRules.engageComfortSequence="false"
ASSIGN nextPromptBehaviors.silenceRules.botResponseDelayTolerance=5000
//botResponseDelayTolerance is not related to userInputTimeout. 
ASSIGN nextPromptBehaviors.silenceRules.comfortPromptSequence.prompts[1].audioFilePath="comfort.wav"
ASSIGN nextPromptBehaviors.silenceRules.millisecondsToWaitForUserResponse=10000
ASSIGN nextPromptBehaviors.audioCollectionRules.collectionType="SEND_UTTERANCE_AUDIO"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.detectDtmf="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.clearDigits="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.terminationCharacters="#"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.stripTerminator="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.interDigitTimeoutMilliseconds=5000
ASSIGN nextPromptBehaviors.audioCollectionRules.dtmfRules.maxDigits=10
ASSIGN nextPromptBehaviors.audioCollectionRules.bargeConfiguration.enableSpeakerBarge="true"
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxPostEnergySilenceMS=500
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxUtteranceMilliseconds=10000
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.trimSilence=1
ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"

属性	行为	详细信息
audioFilePath	虚拟坐席延迟期间的安抚音	输入舒适噪音音频文件的位置。文件应位于您的租户用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组的文件结构中。如果文件位于文件夹中，则包含完整路径。该文件结构与其他提示行为一样被强制执行。配合使用： botResponseDelayTolerance engageComfortSequence
botResponseDelayTolerance	虚拟坐席延迟期间的安抚音	输入触发舒适噪音音频文件的时间量（以毫秒为单位）。配合使用： audioFilePath engageComfortSequence 该属性仅用于安抚音行为。它不能控制脚本何时采用 userInputTimeout 分支。millisecondsToWaitForUserResponse 是控制何时采用此分支的属性。
clearDigits	DTMF 收集	如果您想在操作开始时清除 DTMF 铃声缓冲区，请将该属性设为 true。当联系人按下手机键盘上的键时，缓冲区会缓存 DTMF 铃声。此属性与 Menu 操作中的 clearDigits 属性类似。该属性必须与 detectDtmf 一起使用。您还可以使用其他属性配置与 DTMF 相关的其他选项。
detectDtmf	DTMF 收集	如果您希望操作捕获 DTMF 条目，请将该属性设为 true。该属性可用于收集 DTMF 铃声。要配置其他 DTMF 相关选项，必须包含其他属性： clearDigits terminationCharacters stripTerminator interDigitTimeoutMilliseconds maxDigits
enableSpeakerBarge	插话	将该属性设为 true 以启用插入。对于大多数机器人交互，应启用此属性 (true)，但当音频包含呼叫者需要收听的信息（例如法律免责声明）时，可禁用此属性 (false)。该属性可单独使用。
engageComfortSequence	虚拟坐席延迟期间的安抚音	如果要为该操作启用舒适噪音，请将属性设为 true 。如果不希望该操作使用舒适噪音，请将属性设为 false 。配合使用： botResponseDelayTolerance audioFilePath
interDigitTimeoutMilliseconds	DTMF 收集联系人超时处理	输入联系人输入一个数字后系统等待的时间量（以毫秒为单位），以确定联系人是否会输入另一个数字。此属性与 Menu 操作中的 InterDigitTimeout 属性类似。该属性必须与 detectDtmf 一起使用。您还可以使用其他属性配置与 DTMF 相关的其他选项。
maxDigits	DTMF 收集	输入联系人可以为此操作提示输入的最大数字位数。例如，如果提示指示联系人输入其社会保障号码的最后四位数字，请将该属性设为 4。当达到 maxDigits 值时，脚本继续执行。此属性与 MaxDigits Menu操作中的属性类似。该属性必须与 detectDtmf 一起使用。您还可以使用其他属性配置与 DTMF 相关的其他选项。
maxPostEnergySilenceMS	联系人超时处理	配置联系人在说话时暂停后机器人等待的时间（以毫秒为单位）。默认值为 500 毫秒。您可以增加暂停时长来降低机器人中断联系的几率。暂停时间越长，交互的交流延迟越大。最佳做法是仅当您希望联系人的回复为数字时增大此值。该属性可单独使用。
maxUtteranceMilliseconds	背景噪声处理联系人超时处理	配置机器人在首次检测到来自联系人的音频后的等待时间。（毫秒）。该设置定义响应时间的长短。当达到 maxUtteranceMilliseconds 限制时，虚拟坐席会尝试从捕获的音频中确定意图。如果线路上存在大量背景噪音，这会很有帮助。有关该属性工作原理的更多详细信息，请参见虚拟坐席提示行为页面。该属性的默认设置与millisecondsToWaitForUserResponse 相同，即使您自定义了 millisecondsToWaitForUserResponse 亦是如此。您可能需要更改 maxUtteranceMilliseconds，具体取决于联系人的预期响应时间。例如，对于简短的单字答案，如 yes、no 或 technical support，10 秒（10,000 毫秒）是合理的。较长的预期响应将需要更多时间。最大值为五分钟（300,000 毫秒）。该属性必须与 millisecondsToWaitForUserResponse 一起使用。
millisecondsToWaitForUserResponse	联系人超时处理背景噪声处理	输入操作在超时之前等待联系人响应的时间量（以毫秒为单位）。当达到该超时时，脚本将执行 userInputTimeout 分支。该属性可单独使用。在配置虚拟坐席以处理嘈杂环境时，此属性必须与 maxUtteranceMilliseconds 一起使用。
stripTerminator	DTMF 收集	如果要从捕获的 DTMF 铃声中移除终止字符的值，请将该属性设为 true。该属性必须与 detectDtmf 一起使用。您还可以使用其他属性配置与 DTMF 相关的其他选项。
terminationCharacters	DTMF 收集	输入您希望联系人输入的字符，表示其已输完数字。例如，您可能希望联系人输完帐号后按井字符号 (#)。此属性与 Menu 操作中的 Termination 属性类似。该属性必须与 detectDtmf 一起使用。您还可以使用其他属性配置与 DTMF 相关的其他选项。
trimSilence	联系人超时处理	如果您希望从发送到虚拟坐席的音频中移除话语开头的静音，请设置为 true 。这有助于减少处理每句话语所需的时间。这有助于减少延迟。 trimSilence 的默认值为 false。该属性可单独使用。