상태 핸들러

상태 핸들러는 간단히 줄여서 핸들러라고도 불리며, 최종 사용자를 위한 응답을 만들거나 현재 페이지를 전환하여 대화를 제어하는 데 사용됩니다. 각 대화 차례에서 핸들러가 평가되어 세션에 영향을 줄 수 있습니다. 핸들러에는 세 가지 일반적인 유형의 데이터가 있습니다.

용어 정의
핸들러 요구사항 핸들러가 세션에 영향을 미치기 위해 충족해야 하는 요구사항입니다. 핸들러가 요구사항을 충족하여 어떤 방식으로든 세션에 영향을 줄 때 호출된다고 칭합니다.
핸들러 fulfillment 핸들러가 호출되면 최종 사용자의 응답을 만들기 위해 선택적 fulfillment가 사용됩니다. 이러한 응답은 정적 에이전트 데이터에 정의되거나 웹훅 서비스에서 동적으로 검색됩니다.
핸들러 전환 타겟 핸들러가 호출되면 선택적 전환 타겟이 현재 페이지를 변경하는 데 사용됩니다. 다음 페이지는 흐름 시작 페이지이거나 현재 활성화된 흐름 내의 페이지일 수 있습니다.

핸들러 요구사항이 다른 두 가지 유형의 상태 핸들러가 있습니다.

용어 정의
경로 경로는 최종 사용자 입력이 인텐트 또는 세션 상태의 일부 조건과 일치하면 호출됩니다. 인텐트 요구사항이 있는 경로를 인텐트 경로라고도 합니다. 조건 요구사항만 있는 경로를 조건 경로라고도 합니다.
이벤트 핸들러 이벤트 핸들러이벤트 호출 시 호출됩니다. 일부 기본 제공 이벤트는 예기치 않은 최종 사용자 입력이 수신되거나 웹훅 오류가 발생할 때 트리거됩니다. 또한 대화 외부에서 발생하는 상황에서 호출하는 커스텀 이벤트를 정의할 수 있습니다.

상태 핸들러를 처리하는 세 가지 단계가 있습니다.

용어 정의
1. 범위 핸들러가 세션에 영향을 주려면 범위에 있어야 합니다. 범위는 핸들러가 흐름, 페이지 또는 양식 매개변수에 적용되는지와 연결된 흐름이 활성 상태인지, 연결된 페이지가 활성 상태인지 또는 현재 에이전트가 연결된 양식 매개변수를 채우려고 하는지에 따라 결정됩니다.
2. 평가 범위의 각 핸들러는 순서대로 평가됩니다. 핸들러 요구사항이 충족되면 평가를 통과합니다.
3. 호출 핸들러가 범위 내에 있고 평가를 통과하면 핸들러가 호출됩니다. 연결된 fulfillment가 호출되고, 연결된 전환 타겟이 세션에 적용됩니다.

범위

핸들러가 평가되려면 범위내에 있어야 합니다. 핸들러 범위는 대화를 제어하는 데 도움이 되는 중요하고 강력한 도구입니다. 핸들러의 범위를 제어하여 다음을 제어할 수 있습니다.

X 항목
인텐트를 일치시킬 수 있는 경우
조건을 확인해야 하는 경우
특정 이벤트를 처리할 수 있는 경우
페이지 전환이 발생할 수 있는 경우
정적 fulfillment 응답이 제공되는 경우
동적 응답에 웹훅 사용 fulfillment가 호출되는 경우

범위는 핸들러가 흐름, 페이지 또는 양식 매개변수에 적용되는지와 연결된 흐름이 활성 상태인지, 연결된 페이지가 활성 상태인지 또는 현재 에이전트가 연결된 양식 매개변수를 채우려고 하는지에 따라 결정됩니다.

자세한 범위 지정 규칙은 다음과 같습니다.

  • 활성 흐름에 적용된 경로:
    • 현재 페이지가 흐름 시작 페이지인 경우 범위 내에 있는 것입니다.
    • 현재 페이지가 흐름 시작 페이지가 아닌 경우에는 인텐트 요구사항이 있는 경우에만 범위 내에 있는 것입니다.
  • 현재 페이지에 적용된 경로가 범위 내에 있습니다.
  • 활성 흐름에 적용된 이벤트 핸들러가 범위 내에 있습니다.
  • 현재 페이지에 적용된 이벤트 핸들러가 범위 내에 있습니다.
  • 에이전트가 현재 채우기를 시도하는 양식 매개변수에 적용된 이벤트 핸들러가 범위 내에 있습니다.

경로

경로에는 두 가지 요구사항이 있으며 이 중 하나 또는 둘 모두를 제공해야 합니다. 두 가지 요구사항이 모두 제공되는 경우, 경로를 호출하기 위해서는 두 가지 요구사항을 모두 충족해야 합니다.

용어 정의
인텐트 요구사항 현재 대화 차례의 최종 사용자 입력과 일치해야 하는 인 텐트입니다. 경로에 인텐트 요구사항이 있으면 이를 인텐트 경로라고 합니다.
조건 요구사항 충족해야 하는 조건입니다. 경로에 조건 요구사항이 있으면 이를 조건 경로라고 합니다.

흐름(흐름 수준 경로) 및 페이지(페이지 수준 경로)에 경로를 적용할 수 있습니다. 예를 들어 다음과 같은 상황에서 경로를 사용할 수 있습니다.

X 항목
최종 사용자 입력이 인텐트와 일치하면 일치가 정적 fulfillment 응답을 트리거해야 합니다.
최종 사용자 입력이 인텐트와 일치하면 일치가 동적 응답에 대한 웹훅 사용 fulfillment를 트리거해야 합니다.
최종 사용자 입력이 최종 필수 양식 매개변수를 제공하면 조건 확인이 세션을 다른 페이지로 전환합니다.
최종 사용자 입력이 특정 양식 매개변수를 제공하면 조건 확인이 정적 fulfillment 응답을 트리거합니다.
조건 확인이 true로 설정되어 페이지가 강제로 전환됩니다.

인텐트 전파

일반적으로 일치하는 인텐트로 인해 경로가 호출되면 인텐트가 소비됩니다. 새로운 최종 사용자 입력이 새로운 인텐트 일치를 트리거하지 않는 한 소비된 인텐트는 다시 일치시킬 수 없습니다. 그러나 다음 시나리오에서는 인텐트 일치를 하나의 흐름에서 다른 흐름으로 전파할 수 있습니다.

  • flow F1의 경로는 intent I1을 요구사항으로, flow F2를 전환 타겟으로 합니다.
  • Flow F2에는 intent I1도 요구사항으로 하는 경로가 있습니다.

이 경우 flow F1의 경로가 호출되면 intent I1이 단일 최종 사용자 입력에 대해 두 번 일치되며 두 경로가 모두 호출됩니다.

인텐트 전파는 다음과 같은 경우에 유용합니다.

X 항목
현재 페이지를 다른 흐름의 특정 페이지로 변경하는 경우(전환 타겟 흐름의 경로에는 특정 전환 타겟 페이지가 있음)
흐름의 시작 페이지에 대한 항목 메시지를 만드는 경우(전환 타겟 흐름의 경로에 fulfillment가 있음).

경로 그룹

에이전트를 빌드할 때 많은 페이지에 공통적인 경로 집합이 있을 수 있습니다. 경로를 다시 사용 가능하게 하려면 경로 그룹을 정의합니다. 흐름 또는 전체 에이전트 내에서 이러한 재사용 가능한 그룹 리소스를 만들 수 있습니다.

예를 들어 흐름에서 '피자에 토핑을 추가하고 싶습니다' 및 '음료 사이즈를 변경하고 싶습니다'와 같은 최종 사용자 입력을 처리하기를 원할 수 있습니다. 이러한 입력은 흐름의 여러 페이지 중 하나가 활성 상태일 때 처리되어야 합니다. 모든 관련 페이지에 대해 이러한 입력을 처리하기 위해 인텐트가 있는 두 개의 경로를 정의할 수 있지만 이는 많은 중복 작업입니다. 대신 경로 그룹을 한 번 정의하고 모든 관련 페이지에서 그룹에 대한 참조를 추가할 수 있습니다.

흐름 수준 경로 그룹

흐름 수준 경로 그룹은 흐름을 상위 요소로 사용하여 생성된 경로 그룹 리소스입니다. 이것들은 흐름 내에서 재사용할 수 있습니다.

에이전트 수준 경로 그룹

에이전트 수준 경로 그룹은 에이전트를 상위로 사용하여 생성된 경로 그룹 리소스입니다. 이것들은 전체 에이전트 내에서 재사용 가능하지만 비기호 페이지로 전환되는 경로를 대상으로 허용하지 않습니다.

흐름 수준 경로

흐름 수준 경로는 흐름 시작 페이지에 추가하면 흐름에 적용되는 경로입니다. 이러한 유형의 핸들러에는 다음과 같은 사용 사례가 있습니다.

X 항목
인텐트 또는 조건 요구사항이 흐름 시작 페이지 범위에 있는 핸들러
인텐트 요구사항이 흐름 내 모든 페이지 범위 내에 있는 핸들러

콘솔에서 흐름 수준 경로를 만들려면 다음 안내를 따르세요.

  1. 흐름 시작 페이지를 엽니다.
  2. 경로 제목에서 추가 버튼을 클릭합니다.
  3. 경로 수정 패널이 열립니다.
  4. 경로 필드를 제공합니다.
  5. 저장을 클릭합니다.

콘솔에서 흐름 수준 경로를 재정렬하려면 다음 안내를 따르세요.

  1. 흐름 시작 페이지를 엽니다.
  2. 경로 제목을 클릭합니다.
  3. 경로 목록 패널이 열립니다.
  4. 원하는 순서로 경로를 드래그합니다. 또는 옵션 메뉴를 클릭한 후 이동을 선택합니다.

콘솔에서 흐름 수준 경로를 삭제하려면 다음 안내를 따르세요.

  1. 흐름 시작 페이지를 엽니다.
  2. 경로 제목을 클릭합니다.
  3. 경로 목록 패널이 열립니다.
  4. 옵션 메뉴를 클릭합니다.
  5. 삭제를 선택합니다.

페이지 수준 경로

페이지 수준 경로는 페이지에 적용되는 경로입니다. 이러한 유형의 핸들러에는 다음과 같은 사용 사례가 있습니다.

X 항목
특정 페이지가 활성 상태일 때 범위 내에 인텐트 또는 조건 요구사항이 있는 핸들러

콘솔에서 페이지 수준 경로를 만들려면 다음 안내를 따르세요.

  1. 페이지를 엽니다(흐름 시작 페이지 아님).
  2. 경로 제목에서 추가 버튼을 클릭합니다.
  3. 경로 수정 패널이 열립니다.
  4. 경로 필드를 제공합니다.
  5. 저장을 클릭합니다.

콘솔에서 페이지 수준 경로를 재정렬하려면 다음 안내를 따르세요.

  1. 페이지를 엽니다(흐름 시작 페이지 아님).
  2. 경로 제목을 클릭합니다.
  3. 경로 목록 패널이 열립니다.
  4. 원하는 순서로 경로를 드래그합니다. 또는 옵션 메뉴를 클릭한 후 이동을 선택합니다.

콘솔에서 페이지 수준 경로를 삭제하려면 다음 안내를 따르세요.

  1. 페이지를 엽니다(흐름 시작 페이지 아님).
  2. 경로 제목을 클릭합니다.
  3. 경로 목록 패널이 열립니다.
  4. 옵션 메뉴를 클릭합니다.
  5. 삭제를 선택합니다.

이벤트 핸들러

이벤트 핸들러를 호출하려면 한 가지 요구사항이 있습니다.

용어 정의
이벤트 요구사항 호출해야 하는 이벤트입니다. 이벤트는 이름으로 식별됩니다. 일부 기본 제공 이벤트는 예기치 않은 최종 사용자 입력이 수신되거나 웹훅 오류가 발생할 때 호출됩니다. 또한 대화 외부에서 발생하는 상황에서 호출하는 커스텀 이벤트를 정의할 수 있습니다.

이벤트 핸들러를 흐름(흐름 수준 이벤트 핸들러), 페이지(페이지 수준 이벤트 핸들러), 매개변수(매개변수 수준 이벤트 핸들러)에 적용할 수 있습니다. 예를 들어 다음 상황에서 이벤트 핸들러를 사용할 수 있습니다.

X 항목
최종 사용자 입력이 인텐트와 일치하지 않는 경우 no-match 이벤트 핸들러는 특정 정적 fulfillment 응답을 제공합니다.
타이머는 시스템에서 만료되며 특정 정적 fulfillment 응답과 함께 최종 사용자에게 알림 정보를 제공하려고 합니다.

흐름 수준 이벤트 핸들러

흐름 수준 이벤트 핸들러는 흐름에 적용되는 이벤트 핸들러입니다. 이러한 유형의 핸들러에는 다음과 같은 사용 사례가 있습니다.

X 항목
이벤트 요구사항이 흐름 시작 페이지 범위 내에 있는 핸들러
이벤트 요구사항이 흐름 내 모든 페이지의 범위 내에 있는 핸들러
흐름의 모든 페이지에서 공유하는 예기치 않은 최종 사용자 입력 처리
흐름의 모든 페이지에서 공유하는 웹훅 오류 처리
시스템에서 호출하고 흐름의 모든 페이지에서 공유하는 커스텀 이벤트 처리

모든 흐름에는 no-matchno-input 기본 제공 이벤트의 이벤트 핸들러가 있습니다. 이러한 이벤트 핸들러는 흐름을 만들 때 자동으로 생성되며 삭제할 수 없습니다.

콘솔에서 흐름 수준 이벤트 핸들러를 만들려면 다음 안내를 따르세요.

  1. 흐름 시작 페이지를 엽니다.
  2. 이벤트 핸들러 제목에서 추가 버튼을 클릭합니다.
  3. 이벤트 핸들러 패널이 열립니다.
  4. 이벤트 핸들러 필드를 제공합니다.
  5. 저장을 클릭합니다.

콘솔에서 흐름 수준 이벤트 핸들러를 삭제하려면 다음 안내를 따르세요.

  1. 흐름 시작 페이지를 엽니다.
  2. 이벤트 핸들러 제목을 클릭합니다.
  3. 이벤트 핸들러 목록 패널이 열립니다.
  4. 이벤트 핸들러 위로 마우스를 가져간 다음 삭제 버튼을 클릭합니다.

페이지 수준 이벤트 핸들러

페이지 수준 이벤트 핸들러는 페이지에 적용되는 이벤트 핸들러입니다. 이러한 유형의 핸들러에는 다음과 같은 사용 사례가 있습니다.

X 항목
특정 페이지가 활성 상태일 때 이벤트 요구사항이 범위 내에 있는 핸들러
페이지별로 예기치 않은 최종 사용자 입력 처리
페이지별로 웹훅 오류를 처리
페이지별로 시스템에서 호출한 커스텀 이벤트 처리

콘솔에서 페이지 수준 이벤트 핸들러를 만들려면 다음 안내를 따르세요.

  1. 페이지를 엽니다(흐름 시작 페이지 아님).
  2. 이벤트 핸들러 제목이 없으면 상태 핸들러 추가를 클릭하고 이벤트 핸들러를 선택한 후 적용을 클릭하세요.
  3. 이벤트 핸들러 제목에서 추가 버튼을 클릭합니다.
  4. 이벤트 핸들러 패널이 열립니다.
  5. 이벤트 핸들러 필드를 제공합니다.
  6. 저장을 클릭합니다.

콘솔에서 페이지 수준 이벤트 핸들러를 삭제하려면 다음 안내를 따르세요.

  1. 페이지를 엽니다(흐름 시작 페이지 아님).
  2. 이벤트 핸들러 제목을 클릭합니다.
  3. 이벤트 핸들러 목록 패널이 열립니다.
  4. 이벤트 핸들러 위로 마우스를 가져간 다음 삭제 버튼을 클릭합니다.

매개변수 수준 이벤트 핸들러

매개변수 수준 이벤트 핸들러는 양식 매개변수에 적용되는 이벤트 핸들러입니다. 재요청 핸들러라고도 합니다. 이러한 이벤트 핸들러는 양식 작성 중에 잘못된 최종 사용자 입력을 처리하기 위한 것이므로 커스텀 이벤트를 허용하지 않습니다.

이러한 유형의 핸들러에는 다음과 같은 사용 사례가 있습니다.

X 항목
최종 사용자에게 양식 매개변수를 입력하라는 메시지가 표시되면 유효한 입력을 제공하지 않은 것입니다.

콘솔에서 매개변수 수준 이벤트 핸들러를 만들려면 다음 안내를 따르세요.

  1. 양식 매개변수가 포함된 페이지를 엽니다.
  2. 매개변수를 클릭합니다.
  3. 매개변수 패널이 열립니다.
  4. 이벤트 핸들러 재요청 섹션까지 아래로 스크롤한 후 이벤트 핸들러 추가를 클릭합니다.
  5. 이벤트 핸들러 패널이 열립니다.
  6. 이벤트 핸들러 필드를 제공합니다.
  7. 저장을 클릭합니다.

콘솔에서 매개변수 수준 이벤트 핸들러를 삭제하려면 다음 안내를 따르세요.

  1. 양식 매개변수가 포함된 페이지를 엽니다.
  2. 매개변수를 클릭합니다.
  3. 매개변수 패널이 열립니다.
  4. 이벤트 핸들러 재요청 섹션까지 아래로 스크롤합니다.
  5. 이벤트 핸들러 위로 마우스를 가져간 다음 삭제 버튼을 클릭합니다.

기본 제공 이벤트

다음 이벤트는 기본적으로 제공되며 대화형 에이전트(Dialogflow CX)에서 호출됩니다. 일부 이벤트는 특정 수준으로 제한됩니다.

이벤트 이름
흐름 수준 페이지 수준 매개변수 수준 다음과 같은 경우에 호출됩니다.
sys.no-match-default
  • 흐름 또는 페이지 수준의 경우: 최종 사용자 입력이 범위 내에 있는 핸들러의 인텐트와 일치하지 않습니다.
  • 매개변수 수준의 경우: 최종 사용자 입력이 양식 매개변수를 충족하지 않습니다.
sys.no-match-[1-6] 번호로 순서가 지정된 이러한 이벤트의 핸들러를 제공하면 sys.no-match-default 대신 호출되며 순서는 sys.no-match-1, sys.no-match-2, ...과 같이 이어집니다.
sys.no-input-default 최종 사용자 입력이 수신되지 않은 경우 이는 다음과 같은 경우에 호출될 수 있습니다.
  • 대화형 에이전트(Dialogflow CX)는 비어 있는 최종 사용자 텍스트 입력을 수신합니다.
  • 대화형 에이전트(Dialogflow CX)가 비어 있는 최종 사용자 오디오 입력을 수신하거나 입력에 인식된 음성이 없습니다.
  • 최종 사용자 오디오 입력에 인식된 음성이 포함되기 전에 음성 안내 시간 초과가 발생합니다.
sys.no-input-[1-6] 번호로 순서가 지정된 이러한 이벤트의 핸들러를 제공하면 sys.no-input-default 대신 호출되며 순서는 sys.no-input-1, sys.no-input-2, ...과 같이 이어집니다.
sys.invalid-parameter 웹훅 응답WebhookResponse.pageInfo.formInfo.parameterInfo.stateINVALID로 설정하여 매개변수를 무효화할 때 호출됩니다.
sys.long-utterance 최종 사용자 입력이 비생성형 인텐트 또는 매개변수와 일치하는 최대 허용 길이(256자)를 초과합니다. 제공하지 않으면 대화형 에이전트(Dialogflow CX)가 긴 사용자 발화를 no-match로 처리합니다. 스트리밍 오디오 입력의 경우 이 이벤트는 클라이언트가 오디오 스트림을 닫은 후에만 트리거됩니다.
webhook.error 웹훅 호출이 오류를 반환한 경우 이 이벤트는 1) 웹훅 오류 코드와 일치하는 미세 조정된 웹훅 이벤트 핸들러(예: webhook.error.timeout)가 없는 경우, 2) 실패한 웹훅으로 fulfillment를 호출한 원본 경로에 설정된 전환 타겟이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
webhook.error.timeout 웹훅 호출 시간이 초과된 경우 웹훅 이벤트는 실패한 웹훅으로 fulfillment를 호출한 원래 경로에 설정된 전환 대상이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
webhook.error.bad-request 웹훅에서 400 잘못된 요청을 반환했습니다. 웹훅 이벤트는 실패한 웹훅으로 fulfillment를 호출한 원래 경로에 설정된 전환 대상이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
webhook.error.rejected 웹훅에서 401 승인되지 않음 또는 403 금지됨을 반환했습니다. 웹훅 이벤트는 실패한 웹훅으로 fulfillment를 호출한 원래 경로에 설정된 전환 대상이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
webhook.error.unavailable 웹훅에서 503 서비스를 사용할 수 없음을 반환했습니다. 웹훅 이벤트는 실패한 웹훅으로 fulfillment를 호출한 원래 경로에 설정된 전환 대상이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
webhook.error.not-found 웹훅 URL에 연결할 수 없으므로 웹훅 호출이 실패했습니다. 웹훅 이벤트는 실패한 웹훅으로 fulfillment를 호출한 원래 경로에 설정된 전환 대상이 없는 경우에만 호출됩니다. 자세한 내용은 평가 순서 섹션을 참조하세요.
flow-cancelled 최종 사용자가 흐름 취소를 요청했습니다. 이 이벤트는 취소가 포함된 종료 흐름 페이지에 의해 트리거됩니다. END_FLOW_WITH_CANCELLATION 기호 전환 대상을 참조하세요.
flow-failed 이 흐름이 지정된 작업을 완료할 수 없습니다. 이 이벤트는 실패가 포함된 종료 흐름 페이지에 의해 트리거됩니다. END_FLOW_WITH_FAILURE 기호 전환 대상을 참조하세요.
flow-failed-human-escalation 최종 사용자가 사람 상담사와 대화를 요청했습니다. 이 이벤트는 사람 에스컬레이션이 포함된 최종 흐름 페이지에서 트리거됩니다. END_FLOW_WITH_HUMAN_ESCALATION 기호 전환 대상을 참고하세요.

맞춤 이벤트

커스텀 이벤트 및 이벤트 핸들러를 만들 수 있습니다. 커스텀 이벤트는 최종 사용자와의 대화 외부에서 발생하는 일을 처리하는 데 사용됩니다. 예를 들어 최종 사용자가 버튼을 클릭하거나 일정 시간이 지나거나 대화 중에 사용 가능한 인벤토리가 변경되었습니다.

이벤트는 간단하게 이름으로 식별됩니다. 기본 제공 이벤트와의 충돌을 방지하기 위해 sys. 또는 webhook.로 시작하는 이벤트 이름을 사용하지 않아야 합니다.

API를 사용하여 이벤트를 호출하려면 Session 유형의 detectIntent 메서드에 있는 queryInput.event 필드를 참조하세요.

세션 참조의 프로토콜 및 버전을 선택합니다.

프로토콜 V3 V3beta1
REST 세션 리소스 세션 리소스
RPC 세션 인터페이스 세션 인터페이스
C++ SessionsClient 해당 사항 없음
C# SessionsClient 해당 사항 없음
Go SessionsClient 해당 사항 없음
자바 SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP 없음 해당 사항 없음
Python SessionsClient SessionsClient
Ruby 없음 해당 사항 없음

평가 순서

핸들러는 특정 순서로 평가됩니다. 다음과 같은 일반 규칙이 적용됩니다.

  1. 범위내의 핸들러만 평가됩니다.
  2. 요구사항을 충족하는 핸들러만 호출할 수 있습니다.
  3. 전환 타겟이 없는 핸들러가 호출되면 핸들러 목록 평가가 계속됩니다. 이 규칙으로 인해 여러 fulfillment가 응답 큐에 여러 메시지를 추가할 수 있습니다.
  4. 전환 대상이 있는 핸들러가 호출되면 핸들러 목록 평가가 종료됩니다.
  5. fulfillment가 있는 핸들러가 호출되고 fulfillment로 인해 웹훅 오류가 발생하는 경우:
    • 핸들러에 전환 대상이 정의되어 있으면 웹훅이 자동으로 실패합니다.
    • 이벤트 핸들러가 이벤트 범위 내에 있으면 이벤트를 처리하고 핸들러 목록의 평가가 종료됩니다.
    • 이벤트 핸들러가 이벤트 범위 내에 있지 않으면 웹훅이 자동으로 실패합니다.
  6. 인텐트 요구 사항이 충족되면 인텐트가 소비되므로 인텐트에 대해 발견된 첫 번째 경로 핸들러만 호출할 수 있습니다(예외는 인텐트 전파를 참조하세요).
  7. 조건 요건이 충족되면 조건이 사용되지 않으므로 조건이 포함된 여러 경로가 호출될 수 있습니다.
  8. 이벤트 요구사항이 충족되면 이벤트가 소비되므로 이벤트에 대해 발견된 첫 번째 이벤트 핸들러만 호출할 수 있습니다.
  9. 핸들러 호출 스택은 평가 순서에 영향을 줄 수 있습니다.

평가에는 3단계가 있습니다.

  1. 인텐트 요구사항이 있는 경로는 다음 순서로 평가됩니다.
    1. 페이지 수준: 제공된 순서대로 현재 페이지에 적용되는 개별 경로입니다.
    2. 페이지 수준 그룹: 제공된 순서대로 현재 페이지에 적용되는 경로 그룹입니다.
    3. 흐름 수준: 제공된 순서대로 활성 흐름에 적용되는 경로입니다.
    4. 흐름 수준 그룹: 제공된 순서대로 활성 흐름에 적용되는 경로 그룹입니다.
  2. 조건 요구사항만 있는 경로는 다음 순서로 평가됩니다.
    1. 페이지 수준: 제공된 순서대로 현재 페이지에 적용되는 개별 경로입니다.
    2. 페이지 수준 그룹: 제공된 순서대로 현재 페이지에 적용되는 경로 그룹입니다.
    3. 흐름 수준(현재 페이지가 흐름 시작 페이지인 경우에만): 제공된 순서대로 활성 흐름에 적용되는 경로입니다.
    4. 흐름 수준 그룹(현재 페이지가 흐름 시작 페이지인 경우에만): 활성 경로 그룹에 적용된 경로 그룹 흐름의 순서대로 표시됩니다.
  3. 이벤트 핸들러는 다음 순서대로 평가됩니다.
    1. 매개변수 수준: 에이전트가 현재 채우려고 시도하는 현재 페이지의 양식 매개변수에 다음 순서대로 적용되는 이벤트 핸들러(재요청 핸들러)
    2. 페이지 수준: 현재 페이지에 다음 순서대로 적용되는 이벤트 핸들러입니다.
    3. 흐름 수준: 활성 흐름에 다음 순서대로 적용되는 이벤트 핸들러입니다.

기호화된 전환 타겟

핸들러에 대한 전환 대상을 입력할 때는 특정 흐름 또는 페이지를 입력할 수 있지만 기호화된 전환 타겟을 입력할 수도 있습니다.

기호화된 전환 타겟
설명
START_PAGE 이름이 비슷한 활성 흐름의 시작 페이지로 전환합니다.
END_FLOW 현재 활성화 된 흐름을 종료하고 현재 흐름으로 전환한 페이지로 다시 전환합니다. 핸들러 호출 스택 및 흐름 스택 한도도 참조하세요.
END_FLOW_WITH_CANCELLATION 현재 활성화 된 흐름을 종료하고 현재 흐름으로 전환한 페이지로 다시 전환합니다. 호출 페이지는 flow-cancelled 기본 제공 이벤트를 사용하여 이러한 전환을 처리할 수 있습니다. 핸들러 호출 스택 및 흐름 스택 한도도 참조하세요.
END_FLOW_WITH_FAILURE 현재 활성화 된 흐름을 종료하고 현재 흐름으로 전환한 페이지로 다시 전환합니다. 호출 페이지는 flow-failed 기본 제공 이벤트를 사용하여 이러한 전환을 처리할 수 있습니다. 핸들러 호출 스택 및 흐름 스택 한도도 참조하세요.
END_FLOW_WITH_HUMAN_ESCALATION 현재 활성화 된 흐름을 종료하고 현재 흐름으로 전환한 페이지로 다시 전환합니다. 호출 페이지는 flow-failed-human-escalation 기본 제공 이벤트를 사용하여 이러한 전환을 처리할 수 있습니다. 핸들러 호출 스택 및 흐름 스택 한도도 참조하세요.
END_SESSION 현재 세션을 지우고 이름이 END_SESSION인 특수 페이지로 전환합니다. 다음 사용자 입력은 기본 시작 흐름시작 페이지에서 세션을 다시 시작합니다.
PREVIOUS_PAGE 현재 페이지로의 전환을 유발한 이전 페이지로 전환합니다. 이전 페이지의 페이지 상태는 전환 후 복원됩니다.
CURRENT_PAGE 현재 페이지로 다시 전환합니다. 에이전트를 통해 작업을 반복하고자 할 때 유용할 수 있습니다.

핸들러 호출 스택 및 흐름 스택 한도

세션이 특정 전환 대상을 사용하여 흐름 간에 전환되면 각 흐름이 흐름 스택으로 푸시됩니다.

핸들러 호출 스택

세션이 END_FLOW로 전환되면 완료된 흐름으로 전환된 호출 페이지로 다시 돌아갑니다. 이 경우 핸들러 호출 스택이 보존됩니다. 호출 페이지에서 이전에 평가된 모든 핸들러는 생략되고 나머지 핸들러는 순서대로 평가됩니다.

예를 들면 다음과 같습니다.

  1. P 페이지에는 순서대로 H1, H2, H3 3개의 핸들러가 있습니다.
  2. H1은 평가되었으나 전환이 발생하지는 않습니다.
  3. H2는 평가되며 F 흐름으로 전환됩니다.
  4. 흐름 F 페이지는 END_FLOW로 전환됩니다.
  5. 세션이 P페이지로 다시 돌아오면 보존된 상태로 다시 활성화됩니다.
  6. P 페이지의 핸들러 평가는 보존된 상태부터 계속되며, 따라서 H3 평가가 진행됩니다.

흐름 스택 한도

최대 흐름 스택 한도는 25개입니다. 최대 스택 한도를 초과하면 스택에서 흐름이 발생하여 END_FLOW 전환을 사용할 때 예기치 않은 동작이 발생할 수 있습니다. 이러한 잠재적 문제를 방지하려면 END_FLOW 전환 앞에 발생하는 흐름 간 전환 수를 최소화하세요.

흐름 스택이 비어 있으면 END_FLOW 전환으로 세션이 종료됩니다.

조건 설정

콘솔을 사용하여 조건을 설정하려면 세 가지 논리 옵션 중 하나로 조건 규칙을 제공합니다.

  • 최소 하나와 일치 규칙(OR)
  • 모두 일치 규칙(AND)
  • 표현식 맞춤설정

편의상 AND/OR 옵션을 사용하여 매개변수 값에 대한 단순 조건이나 복합 조건을 만들 수 있습니다.

시스템 함수부울 상수를 포함하여 모든 유형의 조건에 자유 형식 표현식 맞춤설정 옵션을 사용할 수 있습니다.

예를 들어 평가를 통과할 확률 10%의 조건을 설정하려면 표현식 맞춤설정 옵션을 선택하고 조건 필드에 $sys.func.rand() < 0.1을 입력합니다.

커스텀 조건 설정 스크린샷