下一個提示行為 Snippet

本説明頁面上的資訊同時適用於 CXone Studio 和 Desktop Studio。

下一個提示行為 snippet 允許您自訂對話中特定輪次的行為。如果您想為對話中的所有輪次定義預設行為，請使用預設下一個提示行為 snippet。您可以定義的行為有舒適雜音、DTMF 使用者點擊或輕點電話鍵盤上的某個鍵而產生的訊號音。偵測、延遲和超時，以及干預。有關這些行為的更多資訊，請參閱提示行為説明頁面。

將此 snippet 用於擁有 nextPromptBehavior 屬性的動作（例如 Cloud Transcribe動作或 Voicebot Exchange動作）。

各對話輪次所需的時間

請務必計算對話中每一輪次所需的時間。例如，如果沒有停頓，說出一個 14 位數字可能需要八到十五秒，但回應是或否只需要一或兩秒。要擷取整個號碼，說出該號碼的對話輪次必須比「是/否」輪次長。

在說出數字的輪次中，您必須將maxUtteranceMilliseconds增加到比預設設定值更長的數量。此外，您可能還想使該輪次的 maxPostEnergySilenceMS更長。這將有助於確保聯絡人有時間說出號碼。

要更改一個輪次的這些值，請在該輪次的Voicebot Exchange 動作的前後放置一個SNIPPET動作。在Voicebot Exchange之前的SNIPPET中，更改您需要的設定。在Voicebot Exchange之後的SNIPPET中，將設定改回。

新增下一個提示行為 Snippet

在Studio 中開啟指令碼。
在要執行指定行為的 Voicebot Exchange動作之前向指令碼新增 Snippet 動作。如果將此 snippet 用於非虛擬客服應用程式，請將 Snippet 放在Cloud Transcribe動作之前。連接動作。

在 snippet 中新增以下目標聲明：

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

使用以下語法新增您希望該動作執行的行為：

指派 nextPromptBehaviors。[behavior] = [value]

其中[behavior] 包括屬性名稱以及所有相關的成員和子成員名稱。詳細資訊，請參閱後續部分中的範例 snippet 代碼。
使用用於保留nextPromptBehaviors物件 JSON 內容的變數配置 Voicebot Exchange 或 Cloud Transcribe 動作的nextPromptBehavior屬性。在範例代碼中，這是 nextPromptBehaviorsJson。

提示行為屬性

下表描述了下一個提示行為 snippets 的可用屬性。該屬性允許您配置下一步提示行為。這些行為在「虛擬客服專員提示行為」説明頁面中有完整描述。與逐輪次轉錄的非虛擬客服應用程式一起使用時，這些行為的功能與描述的相同。

下面的下一個提示行為範例顯示了每個屬性應使用的完整物件成員和子成員名稱。

檢視範例

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 採集	輸入聯絡人可以在此動作的提示中輸入的最大位數。例如，如果提示指示聯絡人輸入 ID 號碼的最後四位，則將此屬性設定為 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。此屬性可單獨使用。