다음을 통해 공유

항목 전체에서 변수 재사용

  • 아티클

변수는 에이전트의 질문에 대한 고객의 응답을 저장합니다. 예를 들어, 고객 이름을 UserName이라는 변수에 저장할 수 있습니다. 그러면 에이전트는 대화가 계속됨에 따라 이름으로 고객을 지칭할 수 있습니다.

기본적으로 변수 값은 변수가 생성되는 토픽에서만 사용할 수 있습니다. 그러나 토픽 간에 동일한 값을 재사용할 수 있습니다. 예를 들어 시작 토픽 봇은 고객의 이름과 이메일 주소를 요청합니다. 약속 예약 항목에서 에이전트가 고객이 입력한 내용을 기억하고 다시 묻지 않도록 할 수 있습니다.

변수를 재사용하는 한 가지 방법은 토픽 간에 변수를 전달하는 것입니다. 다른 방법은 변수를 전역 범위로 만드는 것이며 이 문서에서 다루는 내용입니다. 전역 변수는 전체 에이전트의 모든 주제에서 사용할 수 있기 때문에 그렇게 불립니다.

전역 변수는 단일 사용자 세션 중에 적용됩니다. 토픽 수준 변수와 구별하기 위해 전역 변수인 변수를 지정합니다.

전역 변수 만들기

토픽 변수의 범위를 변경하여 전역 변수를 생성합니다.

  1. 변수를 만들거나 변수 창을 사용하여 기존 변수를 엽니다.

  2. 변수 속성 패널에서 전역(모든 토픽이 액세스할 수 있음)을 선택합니다.

    변수 이름에는 주제 수준 변수와 구별하기 위해 접두사 Global.이 지정됩니다. 예를 들어, 변수 UserName은 Global.UserName과 같이 표시됩니다.

  3. 토픽을 저장합니다.

    전역 변수의 이름은 모든 토픽에서 고유해야 합니다.

글로벌 변수 사용

메시지 노드 또는 질문 노드에서 메시지를 작성할 때 {x} 아이콘을 선택하면 해당 토픽에서 사용할 수 있는 변수를 볼 수 있습니다. 전역 변수는 토픽 변수와 함께 사용자 정의 탭에 나타납니다. 변수는 알파벳순으로 나열됩니다.

전역 변수를 사용하여 모든 토픽 찾기

전역 변수가 정의된 위치와 이를 사용하는 다른 항목을 찾을 수 있습니다. 이 기능은 새로운 에이전트에서 작업하거나 여러 변수가 있고 복잡한 토픽 분기가 있을 때 유용합니다.

  1. 제작 캔버스나 변수 패널에서 원하는 전역 변수를 선택합니다.

  2. 변수 속성 패널의 참조 섹션에서 모든 참조 보기를 선택합니다.

  3. 기타 탭으로 전환하고 변수를 사용하여 해당 토픽과 노드로 직접 이동하는 토픽을 선택합니다.

전역 변수의 수명 주기

기본적으로 전역 변수의 값은 세션이 종료될 때까지 지속됩니다. 변수 값 지우기 노드는 전역 변수 값을 재설정하며 대화 재설정 시스템 토픽에서 사용됩니다. 해당 항목은 리디렉션을 통해 트리거되거나 사용자가 "다시 시작"과 같은 트리거 문구를 입력할 때 트리거될 수 있습니다. 이 경우 모든 전역 변수가 재설정됩니다.

외부 소스에서 전역 변수 값 설정

에이전트가 일부 컨텍스트로 대화를 시작하도록 하려면 외부 소스로 전역 변수를 초기화할 수 있습니다. 사이트에서 사용자가 로그인해야 한다고 가정해 보겠습니다. 에이전트는 이미 사용자의 이름을 알고 있으므로 고객이 첫 번째 질문을 입력하기 전에 이름으로 인사할 수 있습니다.

  1. 전역 변수를 선택합니다.

  2. 변수 속성 창에서 외부 소스에서 값을 설정할 수 있음을 선택합니다.

내장된 에이전트에서 전역 변수 설정

간단한 웹 페이지에 에이전트를 포함시키는 경우 에이전트의 URL에 변수와 해당 정의를 추가할 수 있습니다. 또는 좀 더 제어하기를 원하면 <script> 코드 블록을 사용하여 프로그래밍 방식으로 변수를 호출하고 사용할 수 있습니다.

URL의 쿼리 문자열의 변수 이름은 Global. 접두사가 없는 전역 변수 이름과 일치해야 합니다. 예를 들어 전역 변수 Global.UserName은 쿼리에서 UserName으로 참조됩니다.

이어지는 예제에서는 변수에 대한 기본 선언을 사용합니다. 프로덕션 시나리오에서는 사용자 이름을 이미 저장한 다른 변수를 쿼리 매개 변수 또는 변수 정의로 전달할 수 있습니다(예: 로그인 스크립트의 사용자 이름이 있는 경우).

변수와 그 정의를 에이전트의 URL에 botURL?variableName1=variableDefinition1&variableName2=variableDefinition2 형식의 쿼리 문자열 매개 변수로 추가합니다.

예:

매개 변수 이름은 대소문자를 구분하지 않습니다. 이 예에서는 username=Ana도 작동합니다.

사용자 지정 캔버스에 전역 변수 추가

사용자 지정 캔버스에 변수를 추가할 수도 있습니다.

  1. 에이전트가 있는 페이지의 <script> 섹션에서 변수 이름을 Global. 접두사 없이 variableName1으로, 정의를 variableDefinition1으로 대체하여 다음과 같이 변수를 정의합니다. 여러 변수를 쉼표(,)로 구분하세요.

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

  2. <script> 섹션에서 에이전트를 내장할 때 store를 호출합니다. 다음 예에서 store는 styleOptions가 호출되기 바로 전에 호출됩니다(BOT_ID를 에이전트의 ID로 바꿔야 함).

    const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));

관련 콘텐츠