Extrait de Comportement par défaut du Prompt suivant

Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.

Le snippet Comportement d’invite suivante par défaut permet de personnaliser les comportements par défaut pour toutes les étapes de la conversation. Si vous souhaitez personnaliser les comportements pour un tour spécifique, utilisez un extrait Next Prompt Behaviors snippet. Les comportements que vous pouvez définir sont le bruit de confort, la détection DTMF Tonalités de signalisation générées lorsqu’un contact appuie sur une touche du clavier téléphonique., les délais et temporisations, ainsi que l'intervention. Vous pouvez en savoir plus sur ces comportements sur la page d'aide Prompt Behaviors.

Utilisez cet extrait avec les actions qui possèdent la propriété nextPromptBehavior, telles que le Cloud Transcribeaction ou le Voicebot Exchange action. Vous pouvez également utiliser cet extrait avec le CONTINUOUS TRANSCRIPTION action lorsque votre agent virtuel est configuré pour utiliser Voicebot Gateway. Vous devez créer cet extrait dans votre script.

Ajout d’un snippet Comportement d’invite suivante par défaut

Ouvrez le script dans Studio.
Ajoutez une action Extrait à votre script. L'emplacement dépend de votre cas d'utilisation :
- Agent virtuel sans Voicebot Gateway : placez l'Extrait avant la première Échange voicebot action.
- Agent virtuel avec Voicebot Gateway : Placez l'Extrait avant la première Continu Transcription action.
- Cas d'utilisation sans agent virtuel : placez l'Extrait avant la Transcription cloudaction.
Connectez les actions.

Ajoutez la déclaration d’objet suivante au snippet :

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

Ajoutez les comportements par défaut que vous voulez définir pour ce script en respectant la syntaxe suivante :

ASSIGN defaultNextPromptBehaviors.[behavior] = [value]

Dans cette syntaxe, [behavior] inclut le nom de la propriété ainsi que tous les noms de membres et de sous-membres associés. Pour plus d'informations, consultez l'exemple de code d'extrait dans la section suivante.
Configurez la propriété nextPromptBehavior de l'action Voicebot Exchange ou Cloud Transcribe avec la variable utilisée pour contenir le contenu JSON de l'objet defaultNextPromptBehaviors. Dans l’exemple de code, il s’agit de defaultNextPromptBehaviorsOutJson. Si vous travaillez avec un Voicebot

Propriétés du Comportement de Prompt

Le tableau suivant décrit les propriétés disponibles pour les extraits Default Next Prompt Behavior . Les propriétés vous permettent de configurer les Comportements de prompt suivant par défaut. Les comportements sont entièrement décrits sur la page d'aide Virtual Agent Prompt Behaviors. Les comportements fonctionnent comme décrit lorsqu'ils sont utilisés avec des applications autres que l'Agent virtuel de Turn-by-Turn Transcription.

L'exemple suivant de l'extrait Comportement par défaut du Prompt suivant montre les noms complets des membres et sous-membres de l'objet à utiliser pour chaque propriété.

Voir l’exemple

DYNAMIC defaultNextPromptBehaviors
ASSIGN defaultNextPromptBehaviors.silenceRules.engageComfortSequence = "false"
ASSIGN defaultNextPromptBehaviors.silenceRules.botResponseDelayTolerance = 1000 
//botResponseDelayTolerance is not related to userInputTimeout. 
ASSIGN defaultNextPromptBehaviors.silenceRules.comfortPromptSequence.prompts[1].audioFilePath = "comfortDEV.wav"
ASSIGN defaultNextPromptBehaviors.silenceRules.millisecondsToWaitForUserResponse = 10000
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.collectionType = "SEND_UTTERANCE_AUDIO"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.detectDtmf = false
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.clearDigits = "true"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.terminationCharacters = "#"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.stripTerminator = true
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.interDigitTimeoutMilliseconds = 5000
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.dtmfRules.maxDigits = 10
// enableSpeakerBarge is for use with VoiceBot Gateway only
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.bargeConfiguration.enableSpeakerBarge = "true" 
// maxPostEnergySilenceMS is not for use with VoiceBot Gateway
// ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.maxPostEnergySilenceMS = "500" 
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.maxUtteranceMilliseconds = "10000" 
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.trimSilence = "false"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.useContinuousTranscription = "1"
// bargeOnUtteranceBeginRatherThanEnd is for use with VoiceBot Gateway only
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.bargeConfiguration.bargeOnUtteranceBeginRatherThanEnd = "1"
// The next three parameters are only for use in the Default Next Prompt Behaviors snippet.
// Parameters that affect transcription cannot be changed after transcription has started unless you stop and restart it.
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.continuousTranscriptionUtteranceConfig.maxUtteranceMilliseconds = 6000
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.continuousTranscriptionUtteranceConfig.maxPostSilenceMS=1
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.continuousTranscriptionUtteranceConfig.numberOfWordsToTrigger
UtteranceBegin = 3
ASSIGN defaultNextPromptBehaviorsOutjson="{defaultNextPromptBehaviors.asjson()}"

Propriété	Comportement	Détails
audioFilePath	Bruit de confort pendant les retards de l'Agent virtuel	Entrez l'emplacement du fichier audio de bruit de confort. Le fichier doit se trouver dans la structure du fichiertenant Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone.. Incluez le chemin complet si le fichier se trouve dans un dossier. La structure du fichier est appliquée comme elle le serait pour tout autre comportement d'invite. À utiliser avec : botResponseDelayTolerance engageComfortSequence
bargeOnUtteranceBeginRatherThanEnd	Intervention	Contrôle si l'intervention peut être déclenchée dès le premier mot ou les premiers mots détectés, ou si elle ne peut pas être déclenchée avant qu'un énoncé complet soit détecté. Définissez ce paramètre sur 1 pour permettre à l'intervention de se produire à tout moment pendant l'énonciation, ou sur 0 si vous souhaitez que le service attende la fin d'une énonciation. Si votre agent virtuel utilise Voicebot Gateway, définissez ce paramètre sur 1.
botResponseDelayTolerance	Bruit de confort pendant les retards de l'Agent virtuel	Entrez la durée en millisecondes qui déclenche le fichier audio de bruit de confort. À utiliser avec : audioFilePath engageComfortSequence Cette propriété ne peut être utilisée qu'avec le comportement de bruit de confort. Il ne contrôle pas le moment où le script prend la branche userInputTimeout. millisecondsToWaitForUserResponse est la propriété qui contrôle le moment où cette branche est suivie.
clearDigits	Collecte DTMF	Définissez cette propriété sur vrai si vous souhaitez effacer le tampon de tonalité DTMF lorsque l'action commence. La mémoire tampon met en cache les tonalités DTMF lorsque le contact appuie sur une touche du clavier de son téléphone. Cette propriété est similaire à la propriété clearDigits de l'action Menu. Cette propriété doit être utilisée avec detectDtmf. Vous pouvez configurer d'autres options liées au DTMF à l'aide de propriétés supplémentaires. Remarque : votre agent virtuel doit être configuré pour gérer les Entrées dtmf dans la console de gestion du fournisseur. Même si vous avez défini clearDigits sur true, votre agent virtuel doit être capable de gérer les erreurs dues à des chiffres Dtmf supplémentaires ou à des délais entre les saisies. L'action VOICEBOT EXCHANGE transmet la saisie qu'elle collecte auprès du contact à l'agent virtuel.
detectDtmf	Collecte DTMF	Définissez cette propriété sur vrai si vous souhaitez que l'action capture les entrées dtmf. Cette propriété permet la collecte de tonalités DTMF. Pour configurer d'autres options liées à DTMF, vous devez inclure d'autres propriétés : clearDigits terminationCharacters stripTerminator interDigitTimeoutMilliseconds maxDigits
enableSpeakerBarge	Intervention	Définissez cette propriété sur vrai pour activer la barge. Cette propriété doit être activée (vrai) pour la plupart des interactions avec le bot, mais peut être désactivé (faux ) lorsque l'audio contient des informations que l'appelant doit entendre, telles que des clauses de non-responsabilité. Cette propriété peut être utilisée de manière autonome.
engageComfortSequence	Bruit de confort pendant les retards de l'Agent virtuel	Définissez la propriété sur vrai si vous souhaitez activer le bruit de confort pour cette action. Réglez-le sur faux si vous ne souhaitez pas que cette action utilise un bruit de confort. À utiliser avec : botResponseDelayTolerance audioFilePath
interDigitTimeoutMilliseconds	Collecte DTMF Traitement du Dépassement DE délai du contact	Entrez la durée en millisecondes pendant laquelle le système attend après qu'un contact a saisi un chiffre pour déterminer si le contact entrera un autre chiffre. Cette propriété est similaire à la propriété InterDigitTimeout de l'action Menu. Cette propriété doit être utilisée avec detectDtmf. Vous pouvez configurer d'autres options liées au DTMF à l'aide de propriétés supplémentaires.
maxDigits	Collecte DTMF	Saisissez le nombre maximal de chiffres que le contact peut saisir pour l'invite de cette action. Par exemple, si l'invite demande au contact d'entrer les quatre derniers chiffres de son identifiant, définissez cette propriété sur 4. Quand la valeur maxDigits est atteinte, le script continue de s'exécuter. Cette propriété est semblable à la propriété MaxDigits de l'action Menu. Cette propriété doit être utilisée avec detectDtmf. Vous pouvez configurer d'autres options liées au DTMF à l'aide de propriétés supplémentaires.
maxPostSilenceMS	Espacement entre les tours	Configurez la durée en millisecondes pendant laquelle l'agent virtuel attend, après que le contact a fini de parler, avant de répondre. Cela vous permet d'empêcher l'agent virtuel de parler en même temps que le contact. La valeur minimum est de 100 millisecondes (1/10 de seconde) et la valeur maximum est de 1000 millisecondes (une seconde). La valeur par défaut est 100. Choisissez le paramètre qui donne à votre agent virtuel la durée de Pause qui semble la plus naturelle pour la personnalité de l'agent virtuel. Une Pause plus longue peut sembler polie, mais une Pause qui dure trop longtemps peut commencer à sembler lente ou amener les contacts à craindre que l'interaction ait été interrompue. Note : Cette propriété peut uniquement être définie dans l'extrait Comportements d’invite suivante par défaut. En effet, les paramètres de script qui affectent la transcription ne peuvent pas être modifiés après le démarrage de Continuous Stream Transcription.
maxPostEnergySilenceMS	Traitement du Dépassement DE délai du contact	Configurez la durée en millisecondes pendant laquelle le robot attend après que le contact ait mis en pause lorsqu’il parlait. La valeur par défaut est 500 millisecondes. Vous pouvez augmenter la durée de la pause pour réduire les risques d'interruption des contacts par le bot. plus la pause est longue et plus la latence des échanges de l'interaction sera importante. La meilleure pratique consiste à n’augmenter cette valeur que si vous prévoyez que la réponse du contact prenne la forme de chiffres. Cette propriété peut être utilisée de manière autonome. Ne pas utiliser cette propriété si votre agent virtuel utilise Voicebot Gateway.
maxUtteranceMilliseconds (utteranceConfig)	Traitement du bruit d'arrière-plan Traitement du Dépassement DE délai de contact	Uniquement pour utteranceConfig.maxUtteranceMilliseconds. Configurez la durée en millisecondes pendant laquelle l'agent virtuel attend après avoir détecté pour la première fois l'audio du contact. Ce paramètre définit la longueur de la réponse. Lorsque la limite maxUtteranceMilliseconds est atteinte, l'agent virtuel tente de déterminer une intention à partir du son capturé. Cela peut s’avérer utile lorsqu'il y a beaucoup de bruits de fond sur la ligne. Pour plus de détails sur le fonctionnement de cette propriété, consultez la Comportements du Prompt de l'Agent virtuel page. La valeur de cette propriété est fixée par défaut de façon similaire à millisecondsToWaitForUserResponse, même si vous avez personnalisé millisecondsToWaitForUserResponse. Il peut être nécessaire de modifier maxUtteranceMilliseconds, en fonction de la durée de la réponse attendue du contact. Par exemple, 10 secondes (10 000 millisecondes) est raisonnable pour une réponse courte d'un seul mot telle que oui, non ou soutien technique. Des réponses attendues plus longues nécessiteraient davantage de temps. La valeur maximale est de cinq minutes (300 000 secondes). Cette propriété doit être utilisée avec millisecondsToWaitForUserResponse. Veuillez ne pas utiliser cette propriété si votre agent virtuel utilise Voicebot Gateway.
maxUtteranceMilliseconds (continuousTranscriptionUtteranceConfig)	Rambler interruption	Uniquement pour continuousTranscriptionUtteranceConfig. maxUtteranceMilliseconds. Configurez la durée, en millisecondes, pendant laquelle l'agent virtuel attend que le contact parle. Lorsque cette limite est atteinte, le bot interrompt le contact. Cela vous permet d'empêcher le contact de parler trop longtemps. Par exemple, si vous définissez cette propriété sur 120000, le contact peut parler pendant deux minutes avant que l'agent virtuel n'agisse. La plage pour cette propriété est de 1000 millisecondes (une seconde) à 180000 millisecondes (trois minutes). La valeur par défaut est 6000. Note : Cette propriété peut uniquement être définie dans l'extrait Comportements d’invite suivante par défaut. En effet, les paramètres de script qui affectent la transcription ne peuvent pas être modifiés après le démarrage de Continuous Stream Transcription.
millisecondsToWait ForUserResponse	Traitement du Dépassement DE délai du contact Gestion du bruit d'arrière-plan	Entrez le délai, en millisecondes, pendant lequel l'action attend une réponse du contact avant son expiration. Lorsque ce délai d'expiration est atteint, le script suit la branche userInputTimeout. Cette propriété peut être utilisée de manière autonome. Lorsque vous configurez votre agent virtuel pour gérer des environnements bruyants, cette propriété doit être utilisée avec maxUtteranceMilliseconds. Si votre agent virtuel utilise Voicebot Gateway, lorsque le contact ne dit rien pendant la durée configurée dans cette propriété, cela déclenche l'envoi de la demande SILENCE à l'agent virtuel. Le script doit suivre la branche userInputTimeout.
numberOfWordsTo TriggerUtteranceBegin	Intervention	Configurez le nombre de mots que le contact doit prononcer avant que l'agent virtuel ne s'autorise à être interrompu. Par exemple, si cette propriété est définie sur 3 et que le contact dit « Attendez, je suis perdu », l'agent virtuel arrêtera de parler. Mais si le contact dit « Attendez », l'agent virtuel continuera de parler. La plage pour cette propriété est de 1 à 10 mots. La valeur par défaut est 1. Ce paramètre est ignoré si bargeOnUtteranceBeginRatherThanEnd est défini sur 0. Note : Cette propriété peut uniquement être définie dans l'extrait Comportements d’invite suivante par défaut. En effet, les paramètres de script qui affectent la transcription ne peuvent pas être modifiés après le démarrage de Continuous Stream Transcription.
stripTerminator	Collecte DTMF	Définissez cette propriété sur vrai si vous souhaitez supprimer la valeur du caractère de fin des tonalités DTMF capturées. Cette propriété doit être utilisée avec detectDtmf. Vous pouvez configurer d'autres options liées au DTMF à l'aide de propriétés supplémentaires.
terminationCharacters	Collecte DTMF	Saisissez le caractère que vous souhaitez que les contacts saisissent pour indiquer qu'ils ont fini de saisir les chiffres. Par exemple, vous pouvez vouloir que les contacts appuient sur la touche dièse (#) lorsqu'ils terminent la saisie d'un numéro de compte. Cette propriété est semblable à la propriété Termination dans l'action Menu. Cette propriété doit être utilisée avec detectDtmf. Vous pouvez configurer d'autres options liées au DTMF à l'aide de propriétés supplémentaires.
trimSilence	Gestion du Dépassement DE délai du contact	Donnez-lui la valeur vrai si vous voulez que le silence du début de l'énoncé soit supprimé de l'audio envoyé à l'agent virtuel. Cela permet de réduire le temps nécessaire au traitement de chaque énoncé, et ainsi de réduire la latence. La valeur par défaut de trimSilence est false. Cette propriété peut être utilisée de manière autonome.
useContinuousTranscription	Intervention	Définissez cette propriété sur 1 (true) lors de l'activation de l'intervention lorsque votre agent virtuel est configuré avec Voicebot Gateway. Continuous Stream Transcription est un élément requis de Voicebot Gateway.