Extrait de code Comportement de l’invite suivante par défaut

Les informations contenues dans cette page d’aide s’appliquent à la fois à Studio et à Desktop Studio.

L’extrait de code Comportement de l’invite suivante par défaut vous permet de personnaliser les comportements par défaut pour tous les tours de la conversation. Si vous souhaitez personnaliser les comportements pour un tour en particulier, utilisez un extrait de code Comportements de l’invite suivante . 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 les temporisations, ainsi que l'intervention. Vous pouvez en savoir plus sur ces comportements sur la page d'aide Prompt Behaviors.

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

Ajouter un Extrait de code Comportements de l’invite suivante par défaut

Ouvrez votre script dans Studio.
Ajoutez une action Snippet à votre script. L’emplacement dépend de votre cas d’utilisation :
- Agent virtuel sans Voicebot Gateway : placez l’Snippet avant la première Voicebot Exchange action.
- Agent virtuel avec Voicebot Gateway : placez l’Snippet avant la première action Continuous Transcription action.
- Cas d’utilisation sans agent virtuel : placez l’Snippet avant l’action Transcription dans le nuage action.
Connectez les actions.

Ajoutez la déclaration d’objet suivante à l’extrait de code :

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

Ajoutez les comportements que vous souhaitez voir apparaître par défaut dans ce script en utilisant 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. Consultez l’exemple de code de l’extrait de code dans la section suivante pour plus d’informations.
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 le code d’exemple, il s’agit de defaultNextPromptBehaviorsOutJson. Si vous travaillez avec un Voicebot

propriétés pour le Comportement des invites

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 d'invite suivante par défaut. Les comportements sont entièrement décrits dans la page d'aide Virtual Agent Prompt Behaviors. Les comportements fonctionnent comme décrit lorsqu'ils sont utilisés avec des applications d'Agent virtuel non virtuelles de Turn-by-Turn Transcription.

L'exemple suivant d'un extrait Default Next Prompt Behavior montre les noms complets des membres et sous-membres d'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 de fichiers du locataire 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	Barge	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 être déclenchée que lorsqu'un énoncé complet est détecté. Réglez ce paramètre à 1 pour permettre à l'intervention de se produire à tout moment pendant l'énoncé, ou à 0 si vous voulez que le service attende la fin d'un énoncé. Si votre agent virtuel utilise Voicebot Gateway, réglez ce paramètre à 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é est uniquement destinée au comportement de bruit de confort. Elle ne contrôle pas quand le script emprunte la branche userInputTimeout. millisecondsToWaitForUserResponse est la propriété qui contrôle quand cette branche est empruntée.
clearDigits	Collection DTMF	Réglez cette propriété à true si vous voulez vider la mémoire tampon des tonalités Dtmf au début de l'Action. 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 Action. Cette propriété doit être utilisée avec detectDtmf. Il existe des options supplémentaires liées à Dtmf que vous pouvez configurer avec des 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 réglé clearDigits à true, votre agent virtuel doit pouvoir gérer les erreurs dues à des chiffres Dtmf supplémentaires ou à des délais entre les entrées. L'Action VOICEBOT EXCHANGE transmet la saisie qu'elle recueille auprès du contact à l'agent virtuel.
detectDtmf	Collection DTMF	Définissez cette propriété sur vrai si vous souhaitez que l'action capture les entrées DTMF. Cette propriété active la collecte des 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 (intervenir pendant un appel)	Définissez cette propriété à true pour activer l'intervention. Cette propriété devrait être activée (true) pour la plupart des interactions avec le robot, mais elle peut être désactivée (false) lorsque l'audio contient des informations que l'appelant doit entendre, comme des avis juridiques. Cette propriété peut être utilisée seule.
engageComfortSequence	Bruit de confort pendant les retards de l’Agent virtuel	Réglez la propriété sur true si vous souhaitez activer le bruit de confort pour cette action. Réglez-le sur false si vous ne souhaitez pas que cette action utilise un bruit de confort. À utiliser avec : botResponseDelayTolerance audioFilePath
interDigitTimeoutMilliseconds	Collection DTMF gestion du délai d’attente des contacts	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 semblable à la propriété InterDigitTimeout de l'Menu action. Cette propriété doit être utilisée avec detectDtmf. Il existe des options supplémentaires liées au DTMF que vous pouvez configurer à l'aide de propriétés supplémentaires.
maxDigits	Collection DTMF	Entrez le nombre maximum de chiffres que le contact peut saisir pour l'invite de cette action. Par exemple, si l'invite demande au contact de saisir les quatre derniers chiffres de son numéro d'identification, réglez cette propriété à 4. Lorsque la valeur maxDigits est atteinte, le script continue de s'exécuter. Cette propriété est semblable à la propriété MaxDigits de l'Menu action. Cette propriété doit être utilisée avec detectDtmf. Il existe des options supplémentaires liées au DTMF que vous pouvez configurer à l'aide de propriétés supplémentaires.
maxPostSilenceMS	Spacing 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 se prolonge trop longtemps peut sembler lente ou amener les contacts à craindre que l'interaction ait été interrompue. Remarque : Cette propriété peut être définie uniquement dans l'extrait Comportements de l'invite suivante par défaut. Cela s'explique par le fait que les paramètres de script qui touchent la transcription ne peuvent pas être modifiés après le début de Continuous Stream Transcription.
maxPostEnergySilenceMS	gestion du délai d’attente des contacts	Configurez la durée, en millisecondes, pendant laquelle le robot attend après que le contact fait une pause en parlant. La valeur par défaut est de 500 millisecondes. Vous pouvez augmenter la durée de la pause pour réduire les risques que le robot interrompe les contacts. plus la pause est longue, plus les échanges de l'interaction auront de latence. La pratique exemplaire consiste à augmenter cette valeur uniquement lorsque vous vous attendez à ce que la réponse du contact soit composée de chiffres. Cette propriété peut être utilisée seule. N'utilisez pas cette propriété si votre agent virtuel utilise Voicebot Gateway.
maxUtteranceMilliseconds (utteranceConfig)	Traitement du bruit de fond gestion du délai d’attente des contacts	Pour utteranceConfig.maxUtteranceMilliseconds uniquement. Configurez la durée, en millisecondes, pendant laquelle l'agent virtuel attend après avoir détecté pour la première fois l'audio provenant 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 de l'audio capturé. Ceci est utile s'il y a beaucoup de bruit de fond sur la ligne. Pour plus de détails sur le fonctionnement de cette propriété, consultez la page Comportements des invites de l'Agent virtuel. Cette propriété est définie par défaut comme millisecondsToWaitForUserResponse, même si vous avez personnalisé millisecondsToWaitForUserResponse. Il se peut que vous deviez modifier maxUtteranceMilliseconds, selon la durée prévue de la réponse 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 plus de temps. La valeur maximale est de cinq minutes (300 000 millisecondes). Cette propriété doit être utilisée avec millisecondsToWaitForUserResponse. N'utilisez pas cette propriété si votre agent virtuel utilise Voicebot Gateway.
maxUtteranceMilliseconds (continuousTranscriptionUtteranceConfig)	Rambler interruption	Pour continuousTranscriptionUtteranceConfig. maxUtteranceMilliseconds uniquement. Configurez la durée, en millisecondes, pendant laquelle l'agent virtuel attend pendant que le contact parle. Lorsque cette limite est atteinte, le robot interrompt le contact. Cela vous permet d'empêcher le contact de parler trop longtemps. Par exemple, si vous définissez cette propriété à 120000, le contact peut parler pendant deux minutes avant que l'agent virtuel n'agisse. La plage de cette propriété va de 1000 millisecondes (une seconde) à 180000 millisecondes (trois minutes). La valeur par défaut est 6000. Remarque : Cette propriété peut être définie uniquement dans l'extrait Comportements de l'invite suivante par défaut. Cela s'explique par le fait que les paramètres de script qui touchent la transcription ne peuvent pas être modifiés après le début de Continuous Stream Transcription.
millisecondsToWait ForUserResponse	gestion du délai d’attente des contacts Traitement du bruit de fond	Entrez la durée en millisecondes pendant laquelle l'action attend une réponse du contact avant d'atteindre le dépassement de délai. Lorsque ce dépassement de délai est atteint, le script emprunte la branche userInputTimeout. Cette propriété peut être utilisée seule. Lorsque vous configurez votre agent virtuel pour gérer les 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 emprunter la branche userInputTimeout.
numberOfWordsTo TriggerUtteranceBegin	Barge	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 à 3 et que le contact dit « Attendez, je suis confus », l'agent virtuel cessera 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 à 0. Remarque : Cette propriété peut être définie uniquement dans l'extrait Comportements de l'invite suivante par défaut. Cela s'explique par le fait que les paramètres de script qui touchent la transcription ne peuvent pas être modifiés après le début de Continuous Stream Transcription.
stripTerminator	Collection 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. Il existe des options supplémentaires liées au DTMF que vous pouvez configurer avec des propriétés supplémentaires.
terminationCharacters	Collection DTMF	Entrez le caractère que vous souhaitez que les contacts saisissent pour indiquer qu'ils ont terminé de saisir des chiffres. Par exemple, vous pouvez souhaiter que les contacts appuient sur le signe dièse (#) lorsqu'ils ont terminé de saisir un numéro de compte. Cette propriété est semblable à la propriété Termination dans l'Menu Action. Cette propriété doit être utilisée avec detectDtmf. Il existe des options supplémentaires liées au DTMF que vous pouvez configurer avec des propriétés supplémentaires.
trimSilence	gestion du délai d’attente des contacts	Réglez sur true si vous souhaitez 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 pour traiter chaque énoncé. Cela peut contribuer à réduire la latence. La valeur par défaut de trimSilence est faux. Cette propriété peut être utilisée seule.
useContinuousTranscription	Intervention	Définissez cette propriété à 1 (vrai) 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.