기본 다음 프롬프트 동작 스니펫

이 도움말 페이지의 정보는 CXone Studio 및 Desktop Studio에 모두 적용됩니다.

기본 다음 프롬프트 동작 스니펫을 사용하면 대화의 모든 턴에 적용되는 기본 동작을 정의할 수 있습니다. 특정 턴의 행동을 사용자 정의하려면 다음 프롬프트 동작 스니펫을 사용합니다. 정의할 수 있는 행동은 통신 소음, DTMF 사용자가 전화 키패드의 키를 누르거나 탭할 때 발생하는 신호화 톤입니다. 감지, 지연 및 타임아웃, 개입입니다. 기본 동작 도움말 페이지에서 이러한 동작에 관한 자세한 내용을 확인할 수 있습니다.

Cloud Transcribe작업 또는 Voicebot Exchange action 등의 nextPromptBehavior 속성이 있는 작업과 함께 이 스니펫을 사용합니다.

기본 다음 프롬프트 동작 스니펫 추가

Studio에서 스크립트를 엽니다.
스크립트의 첫 Voicebot Exchange action 전에 Snippet 작업을 추가합니다. 이 스니펫을 가상 상담원이 아닌 애플리케이션에 사용하는 경우 첫 번째 Cloud Transcribe action 전에 Snippet을(를) 배치합니다. 작업을 연결합니다.

스니펫에 다음 개체 선언을 추가합니다.

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

다음 구문을 사용하여 이 스크립트의 기본 동작으로 설정하려는 동작을 추가합니다.

ASSIGN defaultNextPromptBehaviors.[behavior] = [value]

[behavior]은(는) 속성 이름과 관련된 모든 멤버 및 하위 멤버 이름을 포함합니다. 자세한 정보는 다음 섹션의 스니펫 코드 예시에서 확인하십시오.
Voicebot Exchange 또는 Cloud Transcribe 작업의 nextPromptBehavior 속성을 defaultNextPromptBehaviors 개체의 JSON 콘텐츠를 보유하는 데 사용되는 변수로 구성합니다. 예시 코드에서 이는 defaultNextPromptBehaviorsOutJson입니다.

프롬프트 동작 속성

다음 표에서는 기본 Next Prompt Behavior 스니펫에 사용할 수 있는 속성에 대해 설명합니다. 속성을 통해 기본 다음 프롬프트 작업을 구성할 수 있습니다. 이러한 행동에 대한 자세한 설명은 가상 상담원 프롬프트 작업 도움말 페이지에 있습니다. 이 행동은 턴 바이 턴 대화 내용 가상이 아닌 상담원 애플리케이션과 함께 사용할 때 설명된 대로 작동합니다.

다음 Default Next Prompt Behavior 스니펫 예시에서는 각 속성에 사용할 전체 개체 멤버와 하위 멤버 이름을 보여줍니다.

예시 보기

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
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.bargeConfiguration.enableSpeakerBarge="true"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.maxPostEnergySilenceMS="500"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.maxUtteranceMilliseconds="10000"
ASSIGN defaultNextPromptBehaviors.audioCollectionRules.utteranceConfig.trimSilence="false"
ASSIGN defaultNextPromptBehaviors.userInputType=2
ASSIGN defaultNextPromptBehaviorsOutjson="{defaultNextPromptBehaviors.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	Barge	개입을 활성화하려면 이 속성을 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을(를) 변경해야 할 수도 있습니다. 예를 들어 10초(10,000밀리초)는 yes, no, 또는 technical support 등의 짧은 한 단어짜리 답변에 적합합니다. 더 긴 예상 답변에는 더 많은 시간이 필요합니다. 최댓값은 5분(300,000밀리초)입니다. 이 속성은 millisecondsToWaitForUserResponse과(와) 사용해야 합니다.
millisecondsToWaitForUserResponse	컨택 시간제한 처리 배경 음악 처리	작업이 시간 초과되기 전까지 컨택의 응답을 기다리는 시간을 밀리초로 입력합니다. 이 타임아웃에 도달하면 스크립트가 userInputTimeout 브랜치를 실행합니다. 이 속성은 단독으로 사용할 수 있습니다. 소음이 심한 환경에 가상 상담원을 구성할 때는 이 속성을 maxUtteranceMilliseconds과(와) 함께 사용해야 합니다.
stripTerminator	DTMF 수집	포착한 DTMF 신호음에서 종료 문자 값을 제거하려면 이 속성을 true(으)로 설정합니다. 이 속성은 detectDtmf과(와) 사용해야 합니다. 추가 속성으로 구성할 수 있는 DTMF 관련 옵션이 추가로 있습니다.
terminationCharacters	DTMF 수집	컨택이 숫자 입력을 완료했음을 나타낼 수 있도록 입력할 문자를 입력합니다. 예를 들어, 컨택이 계정 번호를 다 입력했을 때 우물 정자(#)를 누르도록 할 수 있습니다. 이 속성은 Menu 작업의 Termination 속성과 유사합니다. 이 속성은 detectDtmf과(와) 사용해야 합니다. 추가 속성으로 구성할 수 있는 DTMF 관련 옵션이 추가로 있습니다.
trimSilence	컨택 시간제한 처리	발화 시작 부분의 침묵을 가상 상담원에게 전송하는 오디오에서 제거하기를 원하면 true 을(를) 설정하십시오. 각 발화를 처리하는 데 필요한 시간의 길이를 줄이는 데 유용합니다. 지연 시간을 줄이는 데 도움이 됩니다. trimSilence의 기본값은 false입니다. 이 속성은 단독으로 사용할 수 있습니다.