Next Prompt Behavior 代码片段

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

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

添加 Next Prompt Behavior 代码片段

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

    DYNAMIC nextPromptBehaviors
    <add behaviors as needed>
    ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"
  4. 使用以下语法添加您希望此操作执行的行为:

    ASSIGN nextPromptBehaviors.[behavior] = [value]

    其中 [behavior] 包括属性名称以及所有关联的成员和子成员名称。有关详细信息,请参阅以下部分中的示例代码片段代码

  5. 使用用于保存 nextPromptBehaviors 对象的 JSON 内容的变量配置 Voicebot ExchangeCloud Transcribe 操作的 nextPromptBehavior 属性。在该示例代码中,这是 nextPromptBehaviorsJson

提示行为属性

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

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

属性 行为 详细信息
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,具体取决于联系人的预期响应时间。例如,对于简短的单字答案,如 yesnotechnical 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

该属性可单独使用。