기록 실행 데이터 개요
전제 조건
Edge 및 미디어 계층 버전:
- 1.0.0.15220 이상. 자세한 내용은 다음을 참조하세요. 미디어 계층 출시 노트 .
기록 실행 데이터 저장을 활성화하거나 비활성화하려면 다음을 수행하십시오.
- 예배 규칙서 > 조직 > 관리자
- 설정 > 실행 데이터 > 편집하다 허가
- 설정 > 실행 데이터 > 보다 허가
조직의 흐름에 대한 기록 실행 데이터 수준을 설정하려면 다음을 수행합니다.
- 건축가 > 흐름 로그 수준 기본값 > 삭제 허가
- 건축가 > 흐름 로그 수준 기본값 > 편집하다 허가
- 건축가 > 흐름 로그 수준 기본값 > 보다 허가
특정 흐름에 대한 기록 실행 데이터 수준을 설정하려면 다음 안내를 따르세요.
- 건축가 > 흐름 로그 수준 > 추가하다 허가
- 건축가 > 흐름 로그 수준 > 삭제 허가
- 건축가 > 흐름 로그 수준 > 편집하다 허가
- 건축가 > 흐름 로그 수준 > 보다 허가
흐름의 실행 데이터를 보려면 다음 안내를 따르세요.
- 건축가 > 흐름 인스턴스 실행 데이터 > 편집하다 허가
- 건축가 > 흐름 인스턴스 실행 데이터 > 보다 허가
Genesys Cloud는 모든 Architect 흐름 유형에 대한 포괄적인 과거 실행 데이터에 대한 액세스를 제공합니다. 기록 데이터 분석의 고급 기능을 통해 사용자는 기록 실행 데이터를 효과적으로 관리 및 분석하고 사용자 여정에 대한 통찰력을 얻어 개선 및 문제 해결을 수행할 수 있습니다. 사용자는 실행 데이터 저장을 활성화 또는 비활성화하고 4가지 고유한 실행 데이터 세분성 수준 중에서 선택할 수 있습니다.
- 베이스: 이해하다 Architect 작업과 탐색된 메뉴, 오류 및 이벤트를 통한 높은 수준의 사용자 여정입니다.
- 노트: 최적화하다 건축가 변수 값을 사용하는 흐름(기본 수준 포함)
- 자세한 참고사항: 입장 커뮤니케이션 가치가 있는 대화 내용(Notes 수준 포함)
- 모두: 문제를 해결하다 작업 입력 및 출력 값(Verbose Notes 수준 포함)
메모:
- 과거 실행 데이터는 Genesys Cloud 공정 사용 정책에 따라 조직의 데이터 저장 한도에 포함됩니다. 자세한 내용은 다음을 참조하세요. Genesys Cloud 공정 사용 정책 .
- 실행 데이터 저장은 기본적으로 비활성화되어 있습니다. 실행 데이터 캡처를 시작하려면 이를 활성화하고 흐름을 다시 게시해야 합니다.
다음 예는 c에서 가능한 시나리오입니다. 기록 실행 데이터의 소비자는 다음과 같은 목적으로 실행 데이터를 사용할 수 있습니다.
- 예를 들어 흐름에 오류가 발생한 경우 특정 흐름 이벤트를 수신합니다.
- 특정 흐름에 대한 이벤트를 감시하고 특정 흐름 실행 항목을 분석합니다(예: 흐름이 특정 작업을 실행하고 해당 작업이 실패 또는 시간 초과 경로를 취하는 경우).
- 다른 흐름보다 더 많이 실행되는 흐름 확인
Genesys Cloud는 기본적으로 기록 실행 데이터 저장을 비활성화합니다. 저장소를 활성화하려면 다음 단계를 따르세요.
- 딸깍 하는 소리 관리자.
- 아래에 계정 설정, 딸깍 하는 소리 조직 설정.
- 에 설정 탭에서 아래로 스크롤하여 실행 데이터 부분.
- 아래에 실행 데이터 , 토글을 사용하여 조직의 실행 데이터 저장소를 활성화합니다. Genesys Cloud가 민감한 정보를 저장할 수 있음을 알리는 고지 사항 메시지가 나타납니다.
- 딸깍 하는 소리 예 저장을 활성화합니다.
다음으로 이동하려면 관리자 > 계정 설정 > 조직 설정 > 설정 ~에서 건축가 , 클릭 돕다 그리고 선택 실행 데이터 설정 .
메모:
-
기록 실행 데이터 저장소를 활성화하거나 비활성화하려면 다음 권한이 필요합니다. 조직 설정 :
- 예배 규칙서 > 조직 > 관리자
- 설정 > 실행 데이터 > 편집하다 허가
- 설정 > 실행 데이터 > 보다 허가
- 구성 실행 데이터를 저장하려는 데이터 유형입니다. 만약에 건축가 흐름 비활성화되면 Genesys Cloud는 Execu를 저장하지 않습니다. Architect 흐름에 대한 데이터입니다.
기록 실행 데이터를 저장할 데이터 유형을 구성하려면 다음 단계를 따르세요.
- 딸깍 하는 소리 관리자.
- 아래에 계정 설정, 딸깍 하는 소리 조직 설정.
- 에 설정 탭에서 아래로 스크롤하여 실행 데이터 부분.
- 아래에 실행 데이터 저장 , 사용 건축가 흐름 데이터 유형에 대한 실행 데이터 저장을 활성화하려면 전환하세요.
다음으로 이동하려면 관리자 > 계정 설정 > 조직 설정 > 설정 ~에서 건축가 , 클릭 돕다 그리고 선택 실행 데이터 설정 .
참고:
보기 및 활성화를 위해서는 다음 권한이 필요합니다. 건축가 흐름 에서 토글 조직 설정:
- 건축가 > 흐름 인스턴스 실행 데이터 > 편집하다 허가
- 건축가 > 흐름 인스턴스 실행 데이터 > 보다 허가
{
"flow": {
"conversationId": "49dbd0ea-c3ee-4568-ab5b-1fac76a5b81c",
"division": {
"id": "d62836e8-ff2a-43ee-bcf6-dc9d8b9e89a0"
},
"endDateTime": "2023-10-12T09:09:50.495Z",
"execution": [
{
"startedFlow": {
"dateTime": "2023-10-12T09:09:17.642Z",
"languageTag": "en-us",
"variables": []
}
},
{
"startedBotState": {
"dateTime": "2023-10-12T09:09:17.642Z",
"executionId": "433aad21-9b89-4c4c-aa46-3c2a23459a68",
"stateId": "26d285b4-fdc8-4978-9d33-b9eb46a10cf9",
"variables": []
}
},
{
"actionAskForIntent": {
"actionId": "c5f05c45-f683-4ea5-ab0b-93ca101c0d66",
"dateTime": "2023-10-12T09:09:17.642Z",
"execution": [],
"executionId": "00c0597c-7810-4425-b079-91bd680b9a8b",
"outputPathId": "b12f6d65-5f4c-4702-843a-c753885fd57b",
"outputVariables": [],
"trackingId": 11
}
},
{
"actionAskForSlot": {
"actionId": "a6846b61-7736-42ef-ada2-05643078bef5",
"dateTime": "2023-10-12T09:09:24.708Z",
"execution": [],
"executionId": "02f44452-7883-4ea4-a854-973121fb6020",
"outputPathId": "__DEFAULT__",
"outputVariables": [],
"trackingId": 12
}
},
{
"actionDecision": {
"actionId": "efa25778-0b01-4e78-ab66-b5893cbfa72c",
"dateTime": "2023-10-12T09:09:34.462Z",
"executionId": "6e39cc7f-4701-4b9e-b0d0-f2b4adf80752",
"outputPathId": "__NO__",
"trackingId": 15
}
},
{
"actionDecision": {
"actionId": "bcfc8a36-b4e4-4cb1-a9cf-f1fe9ec084cd",
"dateTime": "2023-10-12T09:09:34.462Z",
"executionId": "e6b8644a-d4ab-4743-a447-31b0e198ef60",
"outputPathId": "__NO__",
"trackingId": 23
}
},
{
"actionCommunicate": {
"actionId": "137e8a9b-de39-4641-9304-2905548d4112",
"dateTime": "2023-10-12T09:09:34.462Z",
"executionId": "a1f21445-9841-43fb-8bf0-ba9111bb27b5",
"trackingId": 17
}
},
{
"actionClearSlot": {
"actionId": "768304ea-6aae-4a29-9f17-a708dcaba087",
"dateTime": "2023-10-12T09:09:34.900Z",
"executionId": "809640f3-5d0e-461e-9a6a-468e6afcc9c3",
"outputVariables": [],
"trackingId": 22
}
},
{
"actionLoopAnythingElse": {
"actionId": "a6b6d035-f291-4c4b-bf8f-d6a9becc43e8",
"dateTime": "2023-10-12T09:09:34.900Z",
"execution": [],
"executionId": "7a18178e-a65e-4bb4-abd7-5c2cf5ad78a7",
"outputPathId": "__LOOP__",
"outputVariables": [],
"trackingId": 18
}
},
{
"actionCommunicate": {
"actionId": "4bb7d902-57ad-4183-924d-02e03a03c1f3",
"dateTime": "2023-10-12T09:09:50.229Z",
"executionId": "b1574b6a-cc2b-4a56-87ad-46b1430c2f0b",
"trackingId": 19
}
},
{
"actionExitBotFlow": {
"actionId": "8d2f40dc-9269-41b4-bf8e-d7ac4d631fe3",
"dateTime": "2023-10-12T09:09:50.495Z",
"executionId": "8f97d86c-cd6a-4c14-aa4b-bf5bcd60f89c",
"trackingId": 14
}
},
{
"endedBotState": {
"dateTime": "2023-10-12T09:09:50.495Z"
}
},
{
"endedFlow": {
"dateTime": "2023-10-12T09:09:50.495Z",
"flowExitReason": "FLOW_EXIT",
"naturalLanguageUnderstanding": {
"intent": {
"intentName": "Check Account Balance"
}
},
"outputVariables": []
}
}
],
"executionId": "9ce12079-8e45-42ad-8130-2f104b258777",
"flowId": "7df71c06-4d63-43ef-8db7-d90e68d037f2",
"flowIsDebug": false,
"flowName": "Bank Bot",
"flowType": "bot",
"flowVersion": "7.0",
"startDateTime": "2023-10-12T09:09:17.642Z"
}
}
참고: 다음 표에는 샘플 데이터에 대한 정보만 포함되어 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 이름 | 유형 | 설명 |
| 흐름:conversationId | 문자열 | Genesys Cloud 대화의 고유 식별자입니다. 대화에는 여러 흐름이나 에이전트가 포함될 수 있습니다. |
| 흐름:분할:ID | 문자열 |
흐름 실행이 완료된 후 Genesys Cloud가 실행 데이터를 저장할 때 흐름이 속하는 구분입니다.
|
| 흐름:endDateTime | 문자열 |
흐름 실행이 완료된 날짜 및 시간입니다.
|
| 흐름:실행 | 배열 | 흐름이 실행될 때 발생한 일을 설명하는 흐름 실행 항목의 배열입니다. |
| 흐름:실행:시작된 흐름 | 개체 | 흐름의 시작 날짜와 시간, 흐름이 실행되던 언어를 설명하는 흐름 실행 항목입니다. |
| 흐름:실행:startedBotState | 개체 |
다음을 설명하는 흐름 실행 항목:
|
| 흐름:실행:actionAskForIntent | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 인텐트 작업 요청 :
|
| 흐름:실행:actionAskForSlot | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 슬롯 작업 요청 :
|
| 흐름:실행:actionDecision | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 결정 조치 :
|
| 흐름:실행:작업통신 | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 행동을 전달하라 :
|
| 흐름:실행:actionClearSlot | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 슬롯 지우기 작업 :
|
| 흐름:실행:actionLoopAnythingElse | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 다른 건 없나요? 루프 액션 :
|
| 흐름:실행:actionExitBotFlow | 개체 |
에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 봇 흐름 종료 작업 :
|
| 흐름:실행:endedBotState | 개체 |
설명하는 흐름 실행 항목
|
| 흐름:실행:종료된 흐름 | 개체 |
설명하는 Flow 실행 항목
|
| 흐름:실행 ID | 문자열 |
실행된 Architect 흐름의 고유 인스턴스를 식별하는 고유 식별자입니다. |
| 흐름:flowId | 문자열 |
Architect의 흐름에 대한 고유 식별자입니다. |
| 흐름: flowIsDebug | 부울 |
실행된 흐름이 디버그 모드에 있었는지 여부를 지정합니다. |
| 흐름:흐름이름 | 문자열 |
실행된 흐름의 이름입니다. |
| 흐름:흐름 유형 | 문자열 |
실행된 흐름의 Architect 흐름 유형입니다. |
| 흐름:흐름버전 | 문자열 |
실행된 흐름의 버전입니다. |
| 흐름:startDateTime | 문자열 |
흐름 실행이 시작된 날짜 및 시간입니다. |
메모:
- Genesys Cloud는 10일 동안 기록 흐름 실행 데이터를 저장합니다.
- Genesys Cloud는 쿼리당 최대 200개의 실행 데이터 인스턴스 반환을 지원합니다. Genesys Cloud는 쿼리가 가장 최근의 200개 실행 인스턴스를 반환한다고 보장할 수 없다는 점에 유의하는 것이 중요합니다.
- Genesys Cloud는 3일 이상 실행된 흐름의 실행 기록 데이터를 저장하지 않습니다.
- 통화 흐름에서 Genesys Cloud는 처음 4,500개의 작업 실행만 보고합니다.
- 공통 모듈 흐름은 상위 흐름에 포함되어 있고 자체적으로 실행되지 않으므로 호출(상위) 흐름의 기록 실행 데이터의 일부로만 해당 실행 데이터를 얻을 수 있습니다.
- If a value of the following data types exceeds the size limit that Genesys Cloud can store in execution data, Genesys Cloud reports
valueIsTooLarge:true:- JSON – 최대 1,000자
- 문자열 – 최대 253자
- 컬렉션 데이터 유형 – 최대 20개 항목
- Genesys Cloud는 조직의 실행 데이터 설정이나 특정 보안 봇 흐름에 관계없이 보안 세션에서 실행된 봇 흐름과 같은 보안 흐름의 실행 인스턴스에 대한 기본 수준의 보고 데이터만 허용합니다.
- 시작 날짜 또는 종료 날짜 시간을 기준으로 흐름 인스턴스에 대한 실행 데이터를 쿼리할 수 없습니다. 응답 범위를 좁히기 위해 Genesys Cloud는 대신 ConversationId를 사용할 것을 권장합니다.
다음 비디오에서는 기록 실행 데이터를 활성화하고 구성하는 방법을 안내합니다. 또한 이 비디오에서는 고급 문제 해결을 위해 다양한 데이터 설정을 사용하는 방법을 보여줍니다.
방법에 대한 자세한 내용은 조직에 대한 실행 데이터 수준을 설정하거나 개별 흐름에 대한 조직 전체 실행 데이터 수준을 재정의합니다. 참조 실행 내역 데이터 관리 .
건축가의 기능
Architect의 쿼리 빌더를 사용하면 흐름이 시작되고 종료되는 방식이나 개별 작업에 대한 실행 기준을 기반으로 다양한 기준을 충족하는 흐름 실행 데이터를 검색할 수 있습니다. 또한 런타임 시 Architect 작업의 값이 확인되는 설정을 볼 수도 있습니다. 자세한 내용은 다음을 참조하세요. 흐름 실행 기록 쿼리 작성 그리고 쿼리 빌더에서 쿼리 관리 .
Architect의 재생 모드를 사용하여 Architect 흐름의 흐름 인스턴스 데이터를 재생하여 디버그하고 문제를 해결할 수 있습니다. 자세한 내용은 다음을 참조하세요. 재생 모드를 사용하여 Architect 흐름 문제 해결 .
Architect's Flow Insights 토글 사용 Architect 흐름에서 이전에 실행된 흐름 구성 요소의 빈도를 오버레이로 표시합니다. 자세한 내용은 다음을 참조하세요. Flow Insights를 사용하여 실행된 흐름 구성 요소의 빈도를 확인하세요. .
메모 : Flow Insights를 사용하려면 Architect 흐름에 대한 실행 데이터 저장소를 활성화할 필요가 없습니다.
과거 실행 데이터는 공개 API를 통해 검색할 수 있으며 알림 서비스 제3자 액세스를 위해. 공개 API의 관련 엔드포인트에 대한 자세한 내용은 다음을 참조하세요. Id별로 단일 플로우 실행 데이터 인스턴스의 다운로드를 준비하는 프로세스(작업)를 시작합니다. 그리고 비동기 흐름 실행 데이터 검색 작업의 상태 및/또는 결과 가져오기 Genesys 클라우드 개발자 센터에서.
메모:
- 흐름 중에 작업이 실행되는 횟수와 같은 집계 데이터는 지원되지 않습니다.
- 게시된 흐름에 대한 흐름 실행 데이터만 볼 수 있습니다. 가장 최근 실행 데이터를 캡처하려면 쿼리를 실행하기 전에 흐름을 다시 게시하고 흐름을 통해 상호 작용을 보내야 합니다.
