다음 프롬프트 동작 스니펫

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

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

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

각 대화 턴에 필요한 시간

대화의 각 턴에 필요한 시간을 꼭 계산하십시오. 예를 들어, 14자리 숫자를 말할 때 일시 중지가 없다면 8~15초가 걸리지만, 예나 아니요로 대답하는 데는 1~2초면 됩니다. 전체 숫자를 말하려면 숫자를 말하는 대화 턴이 예/아니요 턴보다 길어야 합니다.

숫자를 말한 턴에서는 maxUtteranceMilliseconds을(를) 기본 설정보다 더 길게 늘려야 합니다. 추가적으로, 해당 턴에 maxPostEnergySilenceMS을(를) 더 길게 만들고 싶을 수도 있습니다. 이렇게 하면 컨택이 전화번호를 말할 시간을 확보하는 데 도움이 됩니다.

한 턴 동안 이 값을 변경하려면 해당 턴의 Voicebot Exchange 작업 전후에 SNIPPET 작업을 배치합니다. Voicebot Exchange 앞의 SNIPPET에서 필요한 설정을 변경합니다. Voicebot Exchange 뒤의 SNIPPET에서 설정을 다시 변경합니다.

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

Studio에서 스크립트를 엽니다.
특정한 동작을 수행하기를 원하는 Voicebot Exchange 작업 전에 스크립트에 Snippet 작업을 추가합니다. 가상 상담원이 아닌 애플리케이션에 이 스니펫을 사용하는 경우 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입니다.

프롬프트 동작 속성

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

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

예시 보기

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	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입니다. 이 속성은 단독으로 사용할 수 있습니다.