次のプロンプト動作スニペット

このヘルプページの情報は、StudioとDesktop Studioの両方に適用されます。

次のプロンプト動作スニペットを使用すると、会話中の特定のターンのデフォルトの動作をカスタマイズできます。会話中のすべてのターンのデフォルト動作を定義したい場合は、デフォルトの次のプロンプト動作スニペットを使用します。定義できる動作は、コンフォートノイズ、DTMF ユーザーが電話のキーパッドのキーを押すかタップしたときに生成される信号音。、遅延とタイムアウト、および割り込みです。これらの動作の詳細については、プロンプト動作のヘルプページを参照してください。

このスニペットは、nextPromptBehaviorCloud TranscribeアクションアクションやVoicebot Exchangeアクションアクションなど、プロパティを持つアクションで使用します。

会話の各ターンに必要な時間

会話の各ターンに必要な時間を必ず計算してください。たとえば、14桁の番号を伝える場合、間を置かなくても8秒から15秒かかりますが、「はい」や「いいえ」で回答する場合は1～2秒しかかかりません。番号全体を捉えるには、番号を伝えるターンが「はい/いいえ」のターンよりも長くなければなりません。

番号を発話するターンでは、maxUtteranceMillisecondsをデフォルト設定より長くする必要があります。さらに、そのターンでは maxPostEnergySilenceMSも長く設定します。これにより、コンタクトが番号を伝えるのに必要な時間を確保できます。

1つのターンについてこれらの値を変更するには、そのターンのVoicebot Exchangeアクションの前後にSNIPPETアクションを配置します。 Voicebot Exchangeの前のSNIPPETで、必要な設定を変更します。 Voicebot Exchangeの後のSNIPPETで、設定を元に戻します。

次のプロンプト動作スニペットの追加

Studioでスクリプトを開きます。
Snippetアクションをスクリプトに追加します。場所はユースケースによって異なります：
- Voicebot Gatewayのないバーチャルエージェント：指定された動作を実行したいSnippetVoicebot Exchangeアクションアクションの前にを配置します。
- Voicebot Gatewayのバーチャルエージェント：SnippetをContinuous Transcription アクションの前に配置します。
- 非バーチャルエージェントユースケース：SnippetをCloud Transcribe アクションの前に配置します。
スクリプトでアクションを接続します。

スニペットに以下のオブジェクト宣言を追加します。

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

次の構文を使用して、アクションに実行させる動作を追加します。

ASSIGN nextPromptBehaviors.[behavior] = [value]

ここで、[behavior]には、プロパティ名と関連するすべてのメンバー名とサブメンバー名が含まれます。詳細については、次のセクションのサンプルスニペットコードを参照してください。
Voicebot ExchangeまたはCloud TranscribeアクションのnextPromptBehaviorプロパティに、nextPromptBehaviorsオブジェクトのJSONコンテンツを保持するための変数を設定します。コード例では、これはnextPromptBehaviorsJsonです。

Voicebot Gatewayを使用するバーチャルエージェントを使用して作業している場合は、スクリプトでnextPromptBehaviorアクションのVoicebot Exchangeプロパティを設定します。

プロンプト動作のプロパティ

ここでは、次のプロンプト動作スニペットで使用できるプロパティについて説明します。これらのプロパティによって、次のプロンプトの動作を設定できます。これらの動作の概要については、「バーチャルエージェントのプロンプト動作」ヘルプページを参照してください。 Turn-by-Turn Transcriptionの非バーチャルエージェントアプリケーションで使用する場合、動作は説明のとおりに機能します。

次のプロンプト動作スニペットの以下の例は、各プロパティに使用する完全なオブジェクトメンバー名とサブメンバー名を示しています。

例を表示

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"
// enableSpeakerBarge is for use with VoiceBot Gateway only
ASSIGN nextPromptBehaviors.audioCollectionRules.bargeConfiguration.bargeOnUtteranceBeginRatherThanEnd="1" 
// bargeOnUtteranceBeginRatherThanEnd is for use with VoiceBot Gateway only
//ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxPostEnergySilenceMS=500
// maxPostEnergySilenceMS is not for use with VoiceBot Gateway
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.maxUtteranceMilliseconds=10000
ASSIGN nextPromptBehaviors.audioCollectionRules.utteranceConfig.trimSilence=1
ASSIGN nextPromptBehaviorsJson="{nextPromptBehaviors.asjson()}"

プロパティ	行動	詳細
audioFilePath	仮想エージェント遅延時の快適なノイズ	コンフォートノイズのオーディオファイルの場所を入力します。テナント CXone Mpower環境におけるテクニカルサポート、請求、およびグローバル設定を管理するために使用される上位レベルの組織グループのファイル構造にファイルを配置する必要があります。ファイルがフォルダーにある場合は、パス全体を含めます。他のプロンプト動作と同じようにファイル構造を強制します。以下と併用します： botResponseDelayTolerance engageComfortSequence
bargeOnUtteranceBeginRatherThanEnd	割り込む	最初の単語（複数可）が検出されたときに割り込みをトリガーできるか、完全な発話が検出されるまで割り込みをトリガーできないかどうかを制御します。このパラメーターを1に設定すると、発話中の任意の時点で割り込みが発生します。サービスが発話の終了まで待機するようにしたい場合は、0に設定します。バーチャルエージェントがVoicebot Gatewayを使用する場合、このパラメーターを1に設定します。
botResponseDelayTolerance	仮想エージェント遅延時の快適なノイズ	コンフォートノイズのオーディオファイルをトリガーする時間をミリ秒単位で入力します。以下と併用します： audioFilePath engageComfortSequence このプロパティは、コンフォートノイズ動作でのみ使用します。このプロパティは、スクリプトがuserInputTimeout分岐を取るタイミングを制御しません。 millisecondsToWaitForUserResponseは、このブランチがいつ取られるかをコントロールするプロパティです。
clearDigits	DTMFの収集	アクション開始時にDTMFトーンバッファをクリアしたい場合は、このプロパティをtrueに設定します。コンタクトが電話のキーパッドのキーを押すと、バッファはDTMFトーンをキャッシュします。このプロパティは、MenuアクションのclearDigitsプロパティに似ています。このプロパティは、detectDtmfと併用する必要があります。追加のプロパティで設定できるDTMF関連のオプションがあります。注：バーチャルエージェントは、プロバイダーの管理コンソールでDTMF入力を処理するように設定されている必要があります。 clearDigitsをtrueに設定した場合でも、バーチャルエージェントはDTMFの余分な桁や入力間の遅延によるエラーを処理できなければなりません。 VOICEBOT EXCHANGEアクションは、コンタクトから収集した入力をバーチャルエージェントに渡します。
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桁を入力するように指示する場合は、このプロパティを4に設定します。 maxDigits値に達すると、スクリプトは実行を続けます。このプロパティは、MenuアクションのMaxDigitsプロパティに似ています。このプロパティは、detectDtmfと併用する必要があります。追加のプロパティで設定できるDTMF関連のオプションがあります。
maxPostEnergySilenceMS	コンタクトタイムアウト処理	ボットがコンタクトが会話中に一時停止してから待機する時間をミリ秒単位で設定します。デフォルト値は500ミリ秒です。一時停止を長くして、ボットがコンタクトを中断する可能性を減らすことができます。一時停止時間が長いほど、インタラクションのインタラクションの待機時間が長くなります。ベストプラクティスは、コンタクトの応答が数字になることが予想される場合にのみ、この値を増やすことです。このプロパティは単独で使用できます。バーチャルエージェントがVoicebot Gatewayを使用する場合は、このプロパティを使用しないでください。
maxUtteranceMilliseconds	背景ノイズの処理コンタクトタイムアウト処理	ボットが最初にコンタクトからの音声を検出してから待機する時間をミリ秒単位で設定します。この設定は、応答の長さを定義します。 maxUtteranceMilliseconds制限に達すると、仮想エージェントはキャプチャされた音声からインテントを決定しようとします。回線のバックグラウンドノイズが多い場合に役立ちます。このプロパティの動作の詳細については、仮想エージェントのプロンプト動作ページを参照してください。このプロパティは、millisecondsToWaitForUserResponseをカスタマイズした場合でも、デフォルトでmillisecondsToWaitForUserResponseと同じ設定になります。コンタクトからの予想応答時間によっては、maxUtteranceMillisecondsの変更が必要な場合があります。たとえば、10秒(1万ミリ秒)は、yes、no、またはtechnical supportなどの短い一語の回答に適しています。予想される対応が長くなれば、より多くの時間が必要になります。最大値は5分(30万ミリ秒)です。このプロパティは、millisecondsToWaitForUserResponseと併用する必要があります。バーチャルエージェントがを使用する場合、このプロパティをVoicebot Gateway使用しないでください。
millisecondsToWaitForUserResponse	コンタクトタイムアウト処理背景ノイズの処理	アクションがタイムアウトするまでコンタクトからの応答時間を待機する時間をミリ秒単位で入力します。このタイムアウトに達すると、スクリプトはuserInputTimeoutブランチを取得します。このプロパティは単独で使用できます。ノイズの多い環境を扱うように仮想エージェントを設定する場合、このプロパティはmaxUtteranceMillisecondsと一緒に使用する必要があります。バーチャルエージェントがを使用する場合は、このプロパティをVoicebot Gateway使用しないでください。
stripTerminator	DTMFの収集	キャプチャされたDTMFトーンから終端文字の値を削除したい場合は、このプロパティをtrueに設定します。このプロパティは、detectDtmfと併用する必要があります。追加のプロパティで設定できるDTMF関連のオプションがあります。
terminationCharacters	DTMFの収集	コンタクトが数字を入力し終わったことを示すために、コンタクトに入力させたい文字を入力してください。たとえば、コンタクトが、口座番号の入力を終了したら、シャープ記号（#）を押すようにしたい場合などです。このプロパティは、MenuアクションのTerminationプロパティに似ています。このプロパティは、detectDtmfと併用する必要があります。追加のプロパティで設定できるDTMF関連のオプションがあります。
trimSilence	コンタクトタイムアウト処理	音声が仮想エージェントに送信される前に、各発話の冒頭の沈黙を削除する場合は、true に設定します。これは、各発話の処理に必要な時間を短縮するのに役立ちます。遅延の軽減に役立ちます。 trimSilenceのデフォルト値はfalseです。このプロパティは単独で使用できます。
useContinuousTranscription	割り込む	バーチャルエージェントが1でセットアップされているときに割り込みを有効にする場合は、このプロパティをVoicebot Gateway（true）に設定します。 Continuous Stream TranscriptionはVoicebot Gatewayの必須部分です。