비활성 트리거

설정, 채널 지원, 제한 사항 및 문제 해결에 대한 지침과 함께 비활성 트리거를 구성하는 방법을 알아봅니다.

개요

OnInactivity 또는 이라고도 하는 비활성 트리거는 사용자가 지정된 기간 동안 메시지를 보내지 않을 때 자동으로 토픽을 발생시키는 Copilot Studio 시스템 트리거입니다. 서버 쪽을 실행하므로 에이전트는 타이머를 평가하고 사용자의 클라이언트가 유휴 상태인 경우에도 토픽을 실행합니다.

일반 사용 사례는 다음과 같습니다.

• 사용자가 여전히 있는지 묻는 미리 알림을 보냅니다.
• 유휴 대화를 자동으로 닫아 에이전트 용량 확보
• 세션이 종료되기 전에 피드백 수집(예: 고객 만족도 설문 조사)
• 중단된 대화에 대한 세션 상태 정리

비활성 트리거의 작동 방식

이 섹션에서는 Copilot Studio 비활성 트리거를 평가하고, 타이머를 예약하고, 대화가 유휴 상태일 때 토픽을 실행하는 방법을 설명합니다.

아키텍처 개요

1. 사용자가 메시지를 보냅니다.

2. 런타임은 모든 OnInactivity 트리거를 평가합니다.

3. 런타임 그룹은 기간별로 트리거되고 기간 계층당 하나를 선택합니다. 우선 순위가 가장 낮은 숫자가 승리합니다. 가장 빠른 생성 날짜가 동점을 해결합니다.

4. 런타임은 선택한 트리거를 가장 짧은 기간부터 정렬합니다.

5. 런타임은 Azure Service Bus의 다음 트리거를 위한 타이머를 설정합니다. 한 번에 하나의 타이머만 활성화됩니다.

6. 사용자가 구성된 기간 동안 비활성 상태입니다.

7. 타이머가 실행되고 비활성 이벤트가 런타임으로 전송됩니다.

8. 런타임은 비활성 토픽을 일치시키고 실행합니다.

9. 런타임은 다음 트리거까지 남은 시간을 계산하고 새 타이머를 설정합니다.

주요 동작

• 타이머는 모든 사용자 메시지에서 다시 설정됩니다.

  사용자가 메시지를 보낼 때마다 시스템은 모든 비활성 트리거를 다시 평가하고 다음 트리거를 무기화합니다(가장 짧은 기간 먼저). 한 번에 하나의 타이머만 활성화됩니다.

• 여러 트리거가 지원됩니다.

  여러 기간(예: 5분 및 10분)에 여러 OnInactivity 트리거를 가질 수 있습니다. 시스템은 지속 시간의 오름차순으로 처리합니다. 기간 계층당 하나의 트리거만 선택됩니다. 두 트리거의 지속 시간이 같으면 더 작은 Priority 번호를 가진 트리거가 작동합니다. 여전히 동점이 있다면 먼저 생성된 트리거가 선택됩니다. 시스템은 동일한 기간에 다른 트리거를 삭제합니다.

• 트리거는 병렬로 실행되지 않고 큐에 대기됩니다.

  한 번에 하나의 타이머만 활성화됩니다. 현재 트리거가 실행된 후, 런타임은 다음 트리거까지의 남은 시간을 계산하고 그 차이만큼 새 타이머를 설정합니다. 최종 결과는 트리거가 원래 비활성 지점에서 올바른 오프셋으로 발동하게 되며, 트리거 실행에 상당한 시간이 소요될 경우 약간의 드리프트가 발생할 수 있다는 것입니다.

• 백그라운드 실행.

  비활성 이벤트는 백그라운드 트리거입니다. 사용자 상호 작용 없이도 실행됩니다.

• 대본 녹음.

  시스템은 대화 내용에 비활성 이벤트를 기록합니다. 비활성 상태인 30분 후에 새 대본 레코드가 만들어집니다.

타임라인 예제(여러 트리거)

사용자가 4:30에 메시지를 보내면 두 타이머가 모두 다시 설정됩니다. 9:30에 트리거 A가 발생하고, 트리거 B는 14:30에 발생합니다.

비활성 트리거 구성

이 섹션에서는 Copilot Studio 비활성 타이머를 시작, 다시 설정 및 실행하는 방법을 보여 줍니다. 따라서 대화가 유휴 상태가 되면 어떻게 되는지 예측할 수 있습니다.

비활성 트리거 토픽 만들기

1. Copilot Studio Topics> 항목 추가>From blank로 이동합니다.

2. 트리거 문구를 선택합니다. 구 대신 "비활성 기간 후"를 선택합니다.

3. 비활성 기간 속성을 설정합니다. 수동 입력 모드의 드롭다운에서 미리 설정(15분, 30분, 45분 또는 1시간)을 선택합니다. 사용자 지정 값(초) 또는 Power Fx 수식(예 Global.TimeoutSeconds: )을 입력하려면 모드 선택기를 수식 으로 전환하고 값을 직접 입력합니다.

4. 토픽 흐름을 디자인합니다(메시지 보내기, 질문하기, 대화 종료 등).

5. 에이전트를 저장 및 게시합니다.

참조 기간

예: 단일 경고 트리거

[OnInactivity - 600초]

메시지: "당신은 여전히 거기 있습니까? 계속하려면 회신하세요."

주제 종료

예: 5분 경고 및 10분 자동 종료

이 패턴이 가장 일반적입니다. 두 가지 비활성 토픽을 만듭니다.

항목 1: 비활성 경고(5분)

• 트리거: 비활성 기간 후
• durationInSeconds: 300
• 작업: 메시지를 보냅니다. "당신은 여전히 거기에 있습니까? 응답이 없으면 이 대화가 5분 후에 종료됩니다."

항목 2: 자동 닫힘(10분)

• 트리거: 비활성 기간 후
• durationInSeconds: 600
• Actions:
  1. 설정 Global.DeactivateInactivity = true (가드 변수 - 모범 사례 참조)
  2. "이 대화는 비활성으로 인해 닫힙니다."라는 메시지를 보냅니다.
  3. 대화 종료

예: 피드백 컬렉션

• 트리거: 비활성 기간 후
• 초 단위 지속 시간: 120
• Actions:
  1. "가기 전에 경험을 평가하시겠습니까? (1-5)"
  2. 응답 저장
  3. 대화 종료

트리거에 조건 추가

특정 상황에서만 실행되도록 트리거 바로 앞에 조건 노드를 추가합니다.

• 특정 채널에서만 실행합니다. =Activity.ChannelId = "msteams"
• 가드 변수가 설정되지 않은 경우에만 경고를 발생시킵니다: =Global.DeactivateInactivity = false

여러 트리거에 권장되는 패턴(공유 토픽)

질문 노드가 있는 트리거가 여러 대 있는 경우 공유 항목을 사용하여 대화 상자 누적 문제를 방지합니다.

1. 다음과 같은 공유 토픽을 만듭니다 HandleInactivity.

   • 전역 변수 Global.InactivityStage 추가(텍스트)
   • 해당 값을 확인합니다.
     • "warning" → 질문 노드가 있는 경고 메시지 보내기("계속?" / "종료?")
     • "close" → 닫는 메시지 보내기 및 대화 종료

2. 첫 번째 OnInactivity 트리거(300초):

   • Global.InactivityStage = "warning"를 설정
   • HandleInactivity로 리디렉션합니다

3. 두 번째 OnInactivity 트리거(600초):

   • Global.InactivityStage = "close"를 설정
   • HandleInactivity로 리디렉션합니다

이 방법은 질문 노드가 프롬프트 루프를 쌓고 만드는 것을 방지합니다.

채널별 구성

채널 지원 매트릭스

Teams 설정

Teams는 영구적 단일 대화 모델을 사용합니다. 대화는 Teams의 관점에서 결코 진정으로 "끝나지 않습니다". 이 모델은 사용자가 대화를 완료한 것으로 간주한 후에도 비활성화가 계속 재발화되는 것을 의미합니다.

권장되는 Teams 패턴:

1. 전역 변수 Global.IsConversationClosed 를 만듭니다(부울, 기본값: false).

2. 비활성 항목의 시작 부분에 다음을 확인 If Global.IsConversationClosed = true 합니다. → 종료 항목(즉시 종료).

3. 대화가 논리적으로 종료되면(사용자가 "안녕"이라고 말함), 고객 만족도가 완료되는 등) 설정합니다 Global.IsConversationClosed = true.

4. 비활성 트리거는 계속 실행될 수 있지만 메시지를 표시하지 않고 즉시 종료됩니다.

Dynamics 365 Customer Service 구성

• 대화는 기본 설정으로 30분 동안 비활성 상태일 경우 자동으로 종료됩니다.
• EndConversation을 단독으로 호출해도 Dynamics 365 Customer Service 세션이 닫히지 않습니다. 에이전트 용량이 해제되지 않습니다.
• 대화를 완전히 종료하려면 CloseOmnichannelConversation 컨텍스트 변수를 Power Automate 플로우로 true에 설정한 후, 상담원에게 전환 노드를 사용합니다.

알려진 제한

빠른 참조: 비활성 타이머를 방해할 수 있는 것은 무엇인가요?

테스트 패널에서 비활성 트리거를 지원하지 않음

Copilot Studio 테스트 패널은 비활성 트리거를 실행하지 않습니다. 이 제한은 설계상의 의도입니다. 라이브 채널(데모 웹 사이트, Teams 등)에서 에이전트를 게시하고 테스트합니다.

Microsoft 365 Copilot 비활성 메시지가 표시되지 않음

트리거는 서버 쪽을 실행하지만 출력(메시지, 카드)은 Microsoft 365 Copilot 환경에서 사용자에게 전달되지 않습니다. 해결 방법이 없습니다. Teams의 알려진 제한 사항을 참조하세요.

생성형 AI 오케스트레이션

비활성 트리거는 클래식 오케스트레이션 토픽 트리거로 구현되며 별도의 타이머 기반 이벤트 파이프라인을 사용합니다. 생성 AI 오케스트레이션이 켜져 있으면 토픽 라우팅이 더 이상 클래식 트리거 인식에 의존하지 않으므로 비활성 토픽이 모든 구성에서 안정적으로 발생하지 않을 수 있습니다. 비활성 처리가 필요한 경우 클래식 오케스트레이션은 권장되고 완전히 유효성이 검사된 구성입니다.

연결된 에이전트: 자식 에이전트의 비활성화는 지원되지 않습니다.

연결된 에이전트 구성에서 자식 에이전트의 비활성 트리거가 작동하지 않고 "잘못된 연결된 에이전트 응답"을 반환합니다. 부모 에이전트에 모든 비활성 논리를 배치합니다.

최대 기간: 7일(604,800초)

게시된 봇은 기간이 604,800초보다 긴 트리거를 자동으로 무시합니다. 오류가 나타나지 않습니다. 디자인 모드에서 오류가 나타날 수 있습니다. 최소 적용은 없습니다. 짧은 기간(약 15초 미만)은 타이머 인프라 대기 시간으로 인해 예측 불가능하게 동작할 수 있습니다.

대화 종료 시 비활성 타이머가 초기화됩니다.

토픽에서 대화 종료를 호출하면 해당 대화의 모든 비활성 타이머가 영구적으로 중단됩니다. 타이머는 완전히 지워집니다. 다시 설정되거나 일시 중지되지 않습니다. 이 작업은 이미 예약된 보류 중인 비활성 이벤트를 모두 삭제합니다.

비활성 타이머를 중단 하지 않고 토픽 흐름을 종료하려면 대체 작업 중 하나를 사용합니다.

가드 변수를 사용하여 리피어링을 방지하는 것이 권장되는 방어 연습으로 남아 있습니다.

에이전트 에스컬레이션이 발생한 후 트리거 작동

시스템이 고객 서비스 담당자에게 대화를 전송한 후 비활성 트리거는 활성 상태로 유지됩니다. 사용자 에이전트 대화 중에 실행되고 에이전트 메시지를 예기치 않게 보낼 수 있습니다. 전송하기 전에 항상 EndConversation을 호출하거나 가드 변수를 사용합니다.

대화가 종료된 후 대화 내용에 트리거 메시지가 표시될 수 있음

대화가 종료된 후에도 트리거가 계속 실행될 수 있으며 해당 메시지는 대본에 기록됩니다. 이 조건은 사용자 환경에 영향을 주지 않지만 분석에 나타날 수 있습니다.

전화, 음성 및 IVR 채널

비활성 트리거는 전화 및 음성 채널에 사용할 수 없습니다. 대신 OnSilence 트리거를 사용합니다.

일반적인 잘못된 구성

이 섹션을 사용하여 비활성 트리거가 예상대로 작동하지 않도록 방지할 수 있는 일반적인 구성 문제를 식별하고 해결합니다.

비활성 항목에서 대화 종료(루프 위험)

문제: 비활성 토픽에서 End 대화를 호출하면 모든 비활성 타이머를 지웁니다. 그러나 지속적인 대화(특히 Teams)가 있는 채널에서는 기본 대화가 활성 상태로 유지됩니다. 일부 구성에서는 트리거가 다시 실행되어 반복되는 "세션 종료" 메시지가 발생할 수 있습니다.

솔루션(방어 연습으로 권장): 가드 변수 사용:

1. Global.DeactivateInactivity을(를) 생성합니다 (Boolean, 기본값: false).

2. 모든 비활성 항목의 맨 위에 "조건: Global.DeactivateInactivity = false인 경우에만 진행"을 추가합니다.

3. EndConversation을 호출Global.DeactivateInactivity = true 설정합니다.

잘못된 값으로 설정된 기간

문제:durationInSeconds 가 초 단위입니다. 값 60000 은 60초가 아닌 약 16.7시간입니다.

솔루션: 섹션 3의 참조 테이블에 대해 값을 다시 확인합니다.

여러 비활성화 주제의 질문 노드(프롬프트 스태킹)

문제: 각 트리거에 질문 노드가 여러 개 있는 경우 두 번째 트리거의 질문 노드는 첫 번째 트리거를 중단합니다. 사용자가 대답하면 첫 번째 질문 노드가 다시 시작되고 다시 시작되어 루프가 만들어집니다.

솔루션:공유 토픽 패턴을 사용합니다. 질문 노드 논리를 단일 토픽으로 통합하거나 하나의 트리거에 질문 노드만 있는지 확인합니다.

비활성 항목에서 전역 변수 지우기

문제: 비활성 항목이 전역 변수를 지우면 에이전트는 모든 대화 컨텍스트를 잃고 사용자가 반환될 때 응답하지 않는 것처럼 표시됩니다.

솔루션: 전체 대화 상태가 아닌 비활성 특정 변수만 다시 설정합니다.

Teams에서 비활성 트리거를 제어하지 않음

문제: Teams에서 영구 대화 모델은 트리거가 무기한 발생한다는 것을 의미합니다. 사용자는 몇 시간 또는 며칠 후에 반복되는 "여전히 존재합니까?" 메시지를 받습니다.

해결책: 항상 Teams에서 gating 변수 패턴을 사용합니다.

closeOmnichannelConversation을 호출하지 않음

Problem: Dynamics 365 Customer Service 에이전트의 경우 EndConversation만 호출해도 Dynamics 365 Customer Service 세션이 닫히지 않습니다. 대화가 에이전트 큐에 쌓입니다.

Solution: 비활성 주제에서 Power Automate를 통해 CloseOmnichannelConversation을 true로 설정합니다.

초기화되지 않은 변수의 동적 기간

문제: 기간과 같은 =Environment.InactivityTimeout Power Fx 식을 사용하면 작동하지만 변수가 초기화되지 않거나 null이면 트리거가 자동으로 제외됩니다.

솔루션: 트리거 조건 및 기간 식에 사용되는 모든 변수에 유효한 기본값이 있는지 확인합니다.

에이전트 에스컬레이션 후 트리거가 작동할 것으로 예상

문제: 시스템이 고객 서비스 담당자에게 전송된 후 트리거는 원래 에이전트 대화에서 실행되고 사용자 에이전트 세션 중에 메시지를 보냅니다.

솔루션: 에스컬레이션 시 에이전트 대화를 종료하거나 가드 변수 Global.IsEscalated = true 를 사용하여 비활성 항목의 시작 부분에 확인합니다.

비활성 트리거가 작동하지 않는 경우 문제 해결

이 의사 결정 트리를 사용하여 문제를 진단합니다.

1. 테스트하는 위치는 어디인가요?

   • 테스트 패널을 사용하는 경우 중지합니다. 테스트 패널은 비활성 트리거를 지원하지 않습니다. 라이브 채널에 게시하고 테스트합니다.

2. 어떤 채널을 사용하고 있나요?

   • Microsoft 365 Copilot? 이 채널에는 알려진 제한 사항이 있습니다. 트리거가 작동하지만 메시지가 배달되지 않습니다. 해결 방법이 없습니다.
   • 전화 통신/IVR? 이 채널은 지원되지 않습니다. 대신 OnSilence 트리거를 사용합니다.

3. 생성 AI 오케스트레이션이 사용하도록 설정되어 있나요?

   • 비활성 트리거는 인식 기반 라우팅과 별도의 타이머 파이프라인을 사용합니다. 그러나 생성 AI 오케스트레이션을 사용하는 동작은 완전히 검증되지 않습니다. 비활성 처리가 중요한 경우 클래식 오케스트레이션이 권장되는 구성입니다.

4. durationInSeconds 604,800보다 큰가요?

   • 그렇다면 트리거는 자동으로 무시됩니다. 604,800 이하로 줄입니다.

5. 에이전트가 연결된 에이전트 환경의 하위 에이전트인가요?

   • 그렇다면 자식 에이전트 비활성 트리거는 지원되지 않습니다. 논리를 부모 에이전트로 이동합니다.

6. 비활성 트리거가 여러 대 있나요?

   • 기간 순서대로 실행됩니다(가장 짧은 것 먼저). 충분히 오래 기다리고 있는지 확인합니다. 모든 사용자 메시지는 모든 타이머를 다시 설정합니다.

7. 트리거에 초기화되지 않은 변수를 참조하는 조건이 있나요?

   • 조건이 아직 설정되지 않은 변수를 참조하는 경우 트리거는 자동으로 제외됩니다. 모든 조건 변수에 기본값이 있는지 확인합니다.

8. 대화가 시작된 후 에이전트가 다시 게시되었나요?

   • 다시 게시는 활성 세션에 대한 비활성 타이머를 다시 설정할 수 있습니다. 새 대화를 시작하고 다시 테스트합니다.

비활성 트리거가 여전히 작동하지 않는 경우 다음 옵션을 시도합니다.

• 비활성화된 주제 활동과 관련된 대화 대본을 확인합니다. 주제가 나타나지만 사용자가 메시지를 보지 못한 경우, 이는 특정 채널의 전달 문제입니다.
• 토픽이 사용 중지되거나 보관되지 않았는지 확인합니다.
• 트리거 유형이 "비활성 기간 후"인지, 구문 트리거가 아닌지 확인합니다.

모범 사례

• 항상 게시된 채널에서 테스트합니다. 빠른 테스트를 위해 데모 웹 사이트를 사용합니다. 테스트 창에 의존하지 마세요.

• 가드 변수를 사용하여 루프를 방지합니다. Global.DeactivateInactivity를 생성합니다 (부울, 기본값 false). EndConversation을 호출하기 전에 true로 설정하십시오. 모든 비활성 항목의 시작 부분에 확인합니다.

• 기간을 합리적으로 유지합니다. 최소 15초, 최대 604,800초(7일)

• 단위를 확인하세요. 속성은 초 단위입니다. 5분 = 300, 5가 아님.

• Dynamics 365 Customer Service의 경우: EndConversation을(를) closeOmnichannelConversation와(과) Power Automate를 통해 항상 페어링하십시오.

• 다중 트리거 시나리오의 경우: 질문 노드를 하나의 트리거로 제한하거나 공유 토픽 패턴을 사용합니다.

• 고객 서비스 담당자에게 전송하기 전에 전화를 걸어 EndConversation 비활성 트리거를 비활성화합니다.

• 배포 후 대화 기록을 모니터링하여 메시지가 예상 시간에 표시되는지 확인합니다.

FAQ

비활성 트리거가 테스트 패널에서 작동하지 않는 이유는 무엇인가요?

타이머는 테스트 패널에서 의도적으로 사용하지 않도록 설정됩니다. 에이전트를 게시하고 라이브 채널에서 테스트합니다.

동적 기간(예: 변수)을 사용할 수 있나요?

네. 기간 필드는 Power Fx 식을 허용합니다. 환경 변수 또는 계산된 값을 사용할 수 있습니다. 이 식은 타이머가 설정될 때 실행 시 계산됩니다. 변수가 초기화되고 유효한 숫자가 포함되어 있는지 확인합니다.

대화가 활성화된 동안 새 에이전트 버전을 게시하면 어떻게 되나요?

런타임이 새 버전을 적용합니다. 트리거 ID가 변경(토픽 삭제 및 다시 생성)된 경우 시스템은 기간별로 일치로 대체됩니다. ID 또는 기간별로 일치하는 트리거가 없으면 보류 중인 비활성 이벤트가 삭제됩니다.

Teams에서 비활성 트리거를 완전히 중지하려면 어떻게 해야 하나요?

플랫폼 수준에서 중지할 수 없습니다. 게이팅 변수 패턴을 사용합니다: 대화가 논리적으로 끝날 때 불리언을 설정하고 비활성 주제 시작 시 확인하여 일찍 종료할 수 있습니다.

비활성 트리거가 인증에서 작동하나요?

예, 하지만 긴 세션 시간 제한(예: 24시간)의 경우 트리거가 실행되기 전에 사용자의 인증 토큰이 만료될 수 있습니다. 에이전트가 재인증 작업을 정상적으로 처리하는지 확인합니다.

비활성 토픽에서 시간이 오래 걸리는 커넥터를 호출하면 어떻게 되나요?

커넥터 호출에는 시간 제한(기본값 30초, 최대 60초)이 있습니다. 커넥터를 최적화하거나 시간 제한을 정상적으로 처리합니다.

관련 콘텐츠

• 토픽 트리거 설정
• 시스템 변수 - InactivityTimer.Continue, InactivityTimer.Count
• Copilot Studio에서 Power Fx 사용
• Dynamics 365 Customer Service 핸드오프 구성
• 음성 구성 및 무음 감지
• Teams에 에이전트 배포
• 연결된 에이전트
• Copilot Studio의 대화 내용 기록
• 옴니채널 대화 자동 닫기
• Microsoft 365 Copilot