사용자 정의 페이로드 스니펫

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

사용자 정의 페이로드 스니펫은 customPayload 속성이 있는 작업(Voicebot Exchange 또는 Textbot Conversation등)을 사용할 때 스크립트에 필요합니다. CXone Mpower에서 가상 상담원 실제 상담원 대신 고객 인터랙션을 처리하는 소프트웨어 애플리케이션입니다. 제공자로 데이터를 전달하는 데 사용됩니다. 가상 상담원에게서 사용자 정의 데이터를 받아야 하면 customPayloadVarName (out) 변수를 사용합니다. 이 페이지의 정보를 사용하여 조직의 가상 에이전트 구현 요구 사항을 충족하는 사용자 정의 페이로드 스니펫을 만드세요.

이 스니펫은 모든 가상 상담원에 필수입니다.

Amazon Lex V1 및 Amazon Lex V2: 사용자 정의 페이로드 스니펫은 데이터를 가상 상담원에게 전달할 필요가 없어도 Lex V1 및 Lex V2에 필수입니다. 가상 상담원은 customPayload 속성을 통해 전달되는 데이터를 사용하여 Amazon 측의 SessionAttributes 속성을 채웁니다.
Google Dialogflow ES: 사용자 정의 페이로드가 Dialogflow ES 가상 상담원이 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.를 파악하는 데 사용하는 컨텍스트 정보를 전달합니다. 사용자 정의 페이로드 데이터 및 Google Dialogflow ES 통합을 위해 권장 모범 사례를 따르십시오.

기타 모든 가상 상담원에 대해서는 봇에 전달할 사용자 정의 페이로드 데이터가 있으면 스니펫만 포함하면 됩니다. Dialogflow CX를 사용하는 경우, 사용자 정의 페이로드를 포함하기 위한 모범 사례를 따르십시오. 사용자 정의 페이로드 스니펫을 포함하지 않는 경우 반드시 플레이스홀더 매개변수를 전달하세요.

자리 표시자 전달

Amazon Lex V2 또는 Amazon Lex V1과 같이 정보 전달이 필요하지 않은 가상 에이전트를 사용하는 경우 다음 예를 따르세요.

DYNAMIC customPayload 
 customPayload.placeholder=""

데이터 전달

가상 에이전트에 정보를 전달해야 하는 모든 가상 에이전트 공급자의 경우 다음 예를 따르세요. 예시의 매개 변수를 전달해야 하는 정보로 교체합니다.

DYNAMIC customPayload
ASSIGN customPayload.context.id="information"
ASSIGN customPayload.context.lifespan=1
ASSIGN customPayload.context.parameters.name="Fenrir"
ASSIGN customPayload.context.parameters.age="19"
ASSIGN customPayload.context.parameters.date="20201020"

Google Dialogflow CX 사용자 정의 페이로드

Dialogflow CX는 Dialogflow ES처럼 Dialogflow 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.로 데이터를 전달하기 위해 컨텍스트를 사용하지 않습니다.
사용자 정의 데이터는 JSON 키-값 쌍을 사용하여 Dialogflow CX로 전달할 수 있습니다. 스크립트의 Snippet action 작업에서 동적 customPayload 개체를 생성하고 이 개체에 키-값 쌍을 추가합니다. 예:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
스크립트의 Exchange 작업에서 값에 customPayload 함수 asJSON()가 있는 변수로 속성을 구성합니다. 이 변수는 customPayload 개체에서 찾을 수 있습니다.
QueryParameters의 Payload 속성을 사용하여 가상 상담원에게 customPayload JSON을 전달합니다. Google Dialogflow CX의 QueryParameters 에 대해 Google 설명서를 참조하십시오.
QueryParameters을(를) 통해 전달된 데이터는 Dialogflow CX에서 웹후크가 수신합니다. 전달된 데이터를 처리하기 위해 Dialogflow CX 콘솔에서 코드를 작성할 수 있습니다.
customPayload 개체 안에 개체를 중첩하지 마십시오. 중첩된 개체는 리터럴 문자열로 전송됩니다.
자신의 Dialogflow CX 가상 상담원에서 스크립트로 사용자 정의 데이터를 다시 전달하려면 Dialogflow CX 콘솔의 사용자 정의 페이로드 필드를 사용합니다. CXone Mpower와(과) 사용 중인 가상 상담원의 콘솔인지 확인합니다. 스크립트의 customPayloadVarName (out)또는 VOICEBOT EXCHANGE TEXTBOT EXCHANGE 작업에서 Studio 변수를 사용하여 이것을 스크립트에 매핑하세요. 예를 들어 이를 사용하여 다음 프롬프트의 행동을 설정할 수 있습니다.
스크립트에서 Dialogflow CX로 사용자 정의 데이터를 전달하려면 session_params 작업의 customPayload 개체에서 Snippet을 사용합니다. 예:
```
DYNAMIC customPayload
customPayload.session_params.name = "Winnie le Pooh" 
customPayload.session_params.job = "Food critic" 
customPayload.session_params.location = "Hundred Acre Wood"	
```
다음 구문을 사용해 Dialogflow CX 상담원 의도의 세션 매개변수에 액세스:
```
$session.params.name = Winnie Le Pooh
$session.params.job = Food critic
$session.params.location = 100 Acre Wood
                
```
세션 매개변수는 Dialogflow CX 가상 상담원에만 사용됩니다. Dialogflow ES에서 유사한 결과를 얻으려면 컨텍스트를 사용하십시오.
음성 컨텍스트 힌트와 사용자 지정 대화 ID를 구성하여 Dialogflow사용자 지정 페이로드스니펫에서 대화를 다른 CX 가상 에이전트로 전송합니다.
VOICEBOT EXCHANGE사용 시: 말하는 중 컨택이 일시 중지 상태가 될 때 가상 상담원이 대기하는 시간을 구성하려면 또는 maxPostEnergySilenceMS 작업에 Next Prompt Behaviors Default Next Prompt Behaviors매개 변수Snippet를 추가합니다.

Dialogflow CX에 대한 음성 컨텍스트 힌트

음성 컨텍스트 힌트는 Custom Payload 스니펫에서 speechContexts 매개변수로 전달될 수 있습니다. speechContexts.phrases의 값은 제공하려는 힌트에 대한 Google 클래스 토큰 중앙에서 오른쪽 상단 모서리를 향하는 화살표가 있는 정사각형입니다. 이어야 합니다. 토큰은 컨택의 언어 및 지역과 일치해야 합니다. 예:

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10

다음과 같이 이러한 매개변수를 구성하세요.

speechContexts.phrases: 제공하려는 힌트에 대한 Google 클래스 토큰 . 토큰은 컨택의 언어 및 지역과 일치해야 합니다. 여러 토큰을 추가하려면 각 토큰에 대해 speechContexts.phrases 매개변수를 추가합니다.
speechContexts.boost: 지정된 phrase에 대한 1-20 사이의 가중치 숫자 값. 대화 기록 서비스는 오디오 데이터의 단어에 대해 가능한 대화 기록을 선택할 때 이 값을 사용합니다. 값이 높을수록 대화 기록 서비스가 대안들 중에서 그 단어나 문구를 선택할 가능성이 커집니다.

Studio 추적 및 애플리케이션 로그에서 이 매개변수의 내용을 볼 수 있습니다.

Dialogflow CX 가상 에이전트 간 연락처 전송

한 CX 가상 에이전트에서 다른 CX 가상 에이전트로 연락처를 전송하도록 설정하려면 사용자 지정 페이로드 스니펫에 다음 줄을 포함합니다.DialogflowDialogflow custom_value을 대화 ID를 보관하는 변수 이름으로 바꾸세요.

{
  “cxone_override_conversation“: {custom_value} 
}

이 매개변수와 함께 사용하는 변수를 채우도록 스크립트를 설정해야 합니다.

스크립트는 신중하게 설정해야 합니다.

cxone_override_conversation 매개변수는 Bot Session State 스니펫에 설정된 봇 세션 상태 ID와 유사합니다. 두 가지 모두 가상 에이전트가 각 턴 사이에 대화의 맥락을 유지하는 데 도움이 됩니다. 봇 세션 상태 ID와 대화 ID 값이 올바른 위치에 나타나도록 스크립트를 신중하게 설정해야 합니다. 봇 세션 상태는 항상 cxone_override_conversation 매개변수보다 우선합니다. 스크립트를 다음과 같이 설정하세요.

가상 에이전트 #	회전하다 #	구성
1	1	또는 작업의 Voicebot EXCHANGEbotSessionStateTextbot EXCHANGE 속성이 비어 있습니다. 턴은 봇 세션 상태 ID를 반환하고 botSessionStateVarName (out)을 채웁니다. 이것은 봇 세션 상태 ID #1입니다.
1	이 가상 에이전트를 사용한 2회 이상 턴	스크립트는 봇 세션 상태 ID #1을 Dialogflow CX 가상 에이전트 #1로 전송합니다. 동일한 ID가 스크립트로 반환됩니다.
2	3 (이 가상 에이전트를 사용한 첫 번째)	또는 작업의 Voicebot EXCHANGEbotSessionStateTextbot EXCHANGE 속성이 비어 있습니다. 이 턴의 사용자 정의 페이로드 스니펫에는 cxone_override_conversation = [variable]가 포함되어 있습니다. 이 차례는 고유한 봇 세션 상태 ID를 반환하고 botSessionStateVarName (out)를 채워서 이미 포함된 모든 값을 재정의합니다. 이것은 봇 세션 상태 ID #2입니다.
2	4 (이 가상 에이전트와의 두 번째 턴)	스크립트는 봇 세션 상태 ID #2를 Dialogflow CX 가상 에이전트 #2로 전송합니다. 동일한 ID가 스크립트로 반환됩니다.

Dialogflow CX 인스턴스를 두 개 이상 사용하는 경우 패턴은 이전 표에 설정된 대로 계속됩니다.

가상 에이전트 간 전송 방법은 두 개 이상의 Dialogflow CX 가상 에이전트 간 전송 시에만 필요합니다. 다른 가상 에이전트 공급자 간에 전환하는 경우봇 세션 상태 ID를 사용할 수 있습니다.

Google Dialogflow ES 사용자 정의 페이로드

CustomPayload은(는) 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.를 위해 컨텍스트를 전달하기 위해 사용됩니다. 컨텍스트는 가상 상담원이 사용자의 의도를 이해하는 데 도움이 됩니다. 컨텍스트가 필수는 아니지만 가상 상담원이 발화 컨택이 말하거나 입력하는 내용입니다.와 의도를 일치시키는 데 도움이 됩니다.
스크립트의 Snippet 작업에서 REST 리소스: projects.agent.sessions.context에 대한 Google Dialogflow ES 설명서 에 설명된 형식을 따르는 customPayload 개체를 생성합니다. Studio 온라인 도움말은 동적 데이터 개체에 대한 추가 정보를 제공합니다.
또한 컨텍스트 없이 customPayload(으)로 사용자 정의 데이터를 전달할 수 있습니다. 이를 위해 동적 데이터 개체에 표준 JSON 키-값 쌍을 포함시킵니다.
음성 컨텍스트는 speech_contact 매개 변수를 통해 사용자 정의 페이로드에 전달됩니다. Studio 추적 및 애플리케이션 로그에서 이 매개 변수의 내용을 볼 수 있습니다.
스크립트 예시에서와 같이 customPayload 동적 개체는 JSON 형식의 가상 상담원 매개변수로 전달됩니다.
사용자 정의 페이로드스니펫에서 음성 컨텍스트 힌트를 구성합니다.

DialogflowES에 대한 음성 컨텍스트 힌트

DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10

다음과 같이 이러한 매개변수를 구성하세요.

speechContexts.phrases: 제공하려는 힌트에 대한 Google 클래스 토큰 . 토큰은 컨택의 언어 및 지역과 일치해야 합니다. 여러 토큰을 추가하려면 각 토큰에 대해 speechContexts.phrases 매개변수를 추가합니다.
speechContexts.boost: 지정된 phrase에 대한 1-20 사이의 가중치 숫자 값. 대화 기록 서비스는 오디오 데이터의 단어에 대해 가능한 대화 기록을 선택할 때 이 값을 사용합니다. 값이 높을수록 대화 기록 서비스가 대안들 중에서 그 단어나 문구를 선택할 가능성이 커집니다.

Studio 추적 및 애플리케이션 로그에서 이 매개변수의 내용을 볼 수 있습니다.