전역 변수 작업

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

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

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

3. 토픽을 저장합니다.

1. 원하는 변수를 선택하십시오.

2. 변수 속성 패널의 사용 아래에서 봇(모든 토픽에 액세스할 수 있음)을 선택합니다.

3. 변수 이름에는 접두사 bot.이 붙어서 토픽 수준 변수와 구별됩니다. 예를 들어, 변수 UserEmail은 이제 bot.UserEmail로 표시됩니다.

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

메시지 노드 또는 질문 노드에서 메시지를 작성할 때 {x} 아이콘을 선택하면 해당 토픽에서 사용할 수 있는 변수를 볼 수 있습니다. 변수는 알파벳순으로 나열되어 있으며, 모든 전역 변수는 bot.로 시작하기 때문에 함께 나타납니다.

조건 노드, 흐름 작업 노드 또는 기술 노드를 사용하면 여기에서 사용 가능한 전역 변수도 볼 수 있습니다.

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

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

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

제작 캔버스에서 원하는 변수를 선택합니다. 변수 속성 패널이 나타납니다.

• 전역 변수가 생성된 노드로 직접 이동하려면 소스로 이동을 선택합니다.

• 이 변수를 사용하는 토픽으로 이동하려면 사용 대상 섹션에서 원하는 토픽을 선택합니다.

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

전역 변수는 모든 토픽에서 접근할 수 있으며, 해당 값은 세션 동안 유지됩니다.

이 값은 에이전트 사용자가 다시 시작 토픽으로 리디렉션되거나 사용자가 이 토픽을 직접 트리거하는 경우(예: "다시 시작" 입력)에만 지워집니다. 이 경우 모든 전역 변수가 재설정되고 값이 없습니다.

전역 변수 초기화

전역 변수가 초기화(또는 "채워짐")되기 전에 트리거되는 경우 에이전트는 원래 토픽으로 돌아가기 전에 전역 변수가 처음 정의된 토픽의 일부를 자동으로 트리거합니다(다른 토픽에 있는 경우에도 해당). 이 동작을 통해 에이전트는 대화를 중단하지 않고 모든 변수를 채울 수 있습니다.

예를 들어 고객이 "약속 예약" 토픽에서 대화를 시작합니다. 여기서 전역 변수 bot.UserName이 사용됩니다. 그러나, bot.UserName 변수는 "시작" 토픽에서 먼저 정의됩니다.

대화가 bot.UserName이 참조된 "약속 예약" 토픽의 지점에 도달하면 에이전트가 bot.UserName이 먼저 정의된 질문 노드로 원활하게 피벗됩니다.

고객이 질문에 대답하면 에이전트는 "약속 예약" 토픽을 재개합니다.

Power Automate 흐름 또는 기술을 통해 작업을 구현할 때 전역 변수 동작

때로는 흐름이나 기술을 사용하여 변수를 초기화하거나 채울 수 있습니다.

그러나 사용자가 에이전트와 상호 작용할 때 대화의 이전 지점에서 변수가 채워지거나 이미 외부에서 변수를 설정했을 수 있습니다.

이 상황에서는 흐름 또는 기술은 계속 실행되고 변수를 채우며 이전에 변수에 저장된 모든 것을 덮어 씁니다.

에이전트가 일부 컨텍스트로 대화를 시작하도록 하려면 전역 변수를 사용하고 외부 소스에서 해당 값을 설정할 수 있습니다. 사이트에서 사용자가 로그인해야 한다고 가정해 보겠습니다. 사용자 이름을 전역 변수에 저장하고 에이전트에게 전달하면 에이전트는 고객이 첫 번째 질문을 입력하기 전에 이름을 부르며 인사할 수 있습니다. 또 다른 예제 시나리오는 Dynamics 365 Customer Service에서 에이전트에게 컨텍스트를 전달하여 고객이 달성하고자 하는 것에 대한 지식으로 대화를 시작할 수 있도록 하는 것입니다.

바람직하지 않은 지연 시간을 방지하기 위해 에이전트가 값을 기다릴 수 있는 시간을 지정할 수 있습니다. 외부 소스가 적시에 응답하지 않을 때 사용할 기본값을 설정할 수도 있습니다.

1. 외부 소스에서 설정하려는 모든 변수에 대한 구성을 저장할 전용 토픽을 만듭니다. 예를 들어 이 토픽의 이름을 "컨텍스트 변수 설정"으로 지정할 수 있습니다. 이 토픽은 다른 용도로 사용되지 않으므로 트리거 문구를 설정할 필요가 없습니다.

2. 변수 값 설정 노드를 전용 토픽에 추가합니다.

3. 변수 설정에서 변수 선택기를 열고 새 변수 만들기를 선택합니다.

4. 새 변수의 기본 이름을 선택합니다. 변수 속성 패널이 나타납니다.

5. 기본 이름을 외부 시스템에서 전달되는 변수의 이름과 정확히 일치하는 이름으로 바꿉니다.

6. 사용에서 전역(모든 토픽에서 액세스 가능)과 외부 소스에서 값을 설정할 수 있음을 선택합니다.

7. 참조에서 오른쪽 위 모서리에 있는 자세히 아이콘(⋮)을 선택하고 비어 있는 경우 이 노드에서 값 가져오기를 선택합니다.

8. (선택 사항) 제한 시간 지연을 밀리초 단위로 설정합니다. 이 값은 외부 소스에 의해 변수가 설정되기를 기다리는 동안 에이전트가 타임아웃되기 전까지 기다릴 수 있는 시간을 결정하며, 타임아웃 후에는 변수 값 설정 노드에서 설정한 기본값으로 계속 진행합니다. 이 설정은 변수가 장기 실행 또는 비동기 프로세스에 의존하는 시나리오와 관련이 있지만 에이전트는 좋은 사용자 경험을 보장하기 위해 최대 대기 시간을 준수해야 합니다.

   Customer Service용 옴니채널에서 오는 변수의 경우 최대 대기 시간으로 10초(10,000ms) 값을 제안합니다.

9. 변수 값 설정 노드에 제한 시간에 도달할 경우 사용할 기본값을 입력합니다. 런타임 시 에이전트는 동일한 데이터 유형의 값을 예상합니다. 이 기본값을 빈 문자열로 만들려면 Text("")를 수식으로 사용합니다.

   

10. 외부 시스템에서 가져올 것으로 예상되는 다른 값의 경우 전용 토픽에 변수 값 설정 노드를 추가하고 동일한 방식으로 필요한 전역 변수를 구성합니다.

따라서 에이전트를 테스트할 준비가 되었습니다. 에이전트가 호출되면 모든 변수가 채워질 때까지 무한정 기다리는 대신 에이전트는 전달되는 변수에 종속되지 않는 모든 메시지를 즉시 보내기 시작할 수 있습니다. 에이전트가 외부에서 설정되는 변수에 액세스하려고 하면 값이 도착하거나 시간 초과가 발생할 때까지 일시 중지됩니다. 대기 시간을 최소화하기 위한 에이전트 최적화에 대해 자세히 알아보세요.

외부 소스에서 초기화되도록 전역 변수를 설정할 수 있습니다. 이 작업을 통해 에이전트는 일부 컨텍스트를 사용하여 대화를 시작할 수 있습니다.

예를 들어, 고객이 웹 사이트에서 에이전트 채팅을 불러오면 사이트는 이미 고객의 이름을 알고 있습니다. 대화를 시작하기 전에 에이전트에게 사용자 이름을 알려 주면 에이전트는 고객의 이름을 다시 묻지 않고도 고객과 보다 지능적인 대화를 할 수 있습니다.

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

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

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

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

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

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

예:

• Global.UserName이라는 전역 변수가 있습니다.
• 에이전트의 URL은 https://web.powerva.microsoft.com/webchat/bots/12345입니다.
• 웹 사이트에서 에이전트 대화를 시작할 때 사용자 이름을 전달하려면 UserName= 쿼리 문자열을 https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana로 첨부하세요.

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

단순히 간단한 웹 페이지에 에이전트을 포함하는 경우 변수와 그 정의만 추가하거나 <script> 코드 블록을 사용하여 프로그래밍 방식으로 변수를 호출하여 사용할 수 있습니다.

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

1. 변수와 그 정의를 에이전트의 URL에 형식의 botURL?variableName1=variableDefinition1&variableName2=variableDefinition2로 추가합니다. 예로 들면 다음과 같습니다.

   • bot.UserEmail이라는 전역 변수가 있습니다.
   • 에이전트의 URL은 https://web.powerva.microsoft.com/webchat/bots/12345입니다.
   • 웹 사이트에서 에이전트 대화를 시작할 때 사용자 이름을 전달하려면 UserEmail= 쿼리 문자열을 다음으로 연결해야 합니다. https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. 매개 변수 이름은 대소문자를 구분하지 않습니다. 즉, 이 예제에서 useremail=Ana@contoso.com도 작동합니다.

1. 에이전트가 있는 페이지의 <script> 섹션에서 변수 이름을 variableName1 접두사 없이 Global.으로, 정의를 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));
   

1. 에이전트가 있는 페이지의 <script> 섹션에서 변수 이름을 variableName1 접두사 없이 bot.으로, 정의를 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));