기록 실행 데이터 개요

곧 제공될 기능: 기록 실행 데이터, Flow 실행 기록, Query Builder, Replay 모드 

전제 조건

Edge 및 미디어 계층 버전:

기록 실행 데이터 저장을 활성화하거나 비활성화하려면 다음을 수행하십시오.

  • 예배 규칙서 > 조직 > 관리자
  • 설정 > 실행 데이터 > 편집하다 허가
  • 설정 > 실행 데이터 > 보다 허가

조직의 흐름에 대한 기록 실행 데이터 수준을 설정하려면 다음을 수행합니다.

  • 건축가 > 흐름 기본 로그 수준 > 삭제 허가
  • 건축가 > 흐름 기본 로그 수준 > 편집하다 허가
  • 건축가 > 흐름 기본 로그 수준 > 보다 허가

특정 흐름에 대한 기록 실행 데이터 수준을 설정하려면 다음 안내를 따르세요.

  • 건축가 > 흐름 로그 수준 > 추가하다 허가
  • 건축가 > 흐름 로그 수준 > 삭제 허가
  • 건축가 > 흐름 로그 수준 > 편집하다 허가
  • 건축가 > 흐름 로그 수준 > 보다 허가

흐름의 실행 데이터를 보려면 다음 안내를 따르세요.

  • 건축가 > 흐름 인스턴스 실행 데이터 > 편집하다 허가
  • 건축가 > 흐름 인스턴스 실행 데이터 > 보다 허가

Genesys Cloud는 모든 Architect 흐름 유형에 대한 포괄적인 과거 실행 데이터에 대한 액세스를 제공합니다. 기록 데이터 분석의 고급 기능을 통해 사용자는 기록 실행 데이터를 효과적으로 관리 및 분석하고 사용자 여정에 대한 통찰력을 얻어 개선 및 문제 해결을 수행할 수 있습니다. 사용자는 실행 데이터 저장을 활성화 또는 비활성화하고 4가지 고유한 실행 데이터 세분성 수준 중에서 선택할 수 있습니다.

  • 베이스: 이해하다 Architect 작업과 탐색된 메뉴, 오류 및 이벤트를 통한 높은 수준의 사용자 여정입니다.
  • 노트: 최적화하다 건축가 변수 값을 사용하는 흐름(기본 수준 포함)
  • 자세한 참고사항: 입장 커뮤니케이션 가치가 있는 대화 내용(Notes 수준 포함)
  • 모두: 문제를 해결하다 작업 입력 및 출력 값(Verbose Notes 수준 포함)

메모:
  • 과거 실행 데이터는 Genesys Cloud 공정 사용 정책에 따라 조직의 데이터 저장 한도에 포함됩니다. 자세한 내용은 다음을 참조하세요. Genesys Cloud 공정 사용 정책 .
  • 실행 데이터 저장은 기본적으로 비활성화되어 있습니다. 실행 데이터 캡처를 시작하려면 이를 활성화하고 흐름을 다시 게시해야 합니다.

다음 예는 c에서 가능한 시나리오입니다. 기록 실행 데이터의 소비자는 다음과 같은 목적으로 실행 데이터를 사용할 수 있습니다.

  • 예를 들어 흐름에 오류가 발생한 경우 특정 흐름 이벤트를 수신합니다.
  • 특정 흐름에 대한 이벤트를 감시하고 특정 흐름 실행 항목을 분석합니다(예: 흐름이 특정 작업을 실행하고 해당 작업이 실패 또는 시간 초과 경로를 취하는 경우).
  • 다른 흐름보다 더 많이 실행되는 흐름 확인

Genesys Cloud는 기본적으로 기록 실행 데이터 저장을 비활성화합니다. 저장소를 활성화하려면 다음 단계를 따르세요.

  1. 딸깍 하는 소리 관리자.
  2. 아래에 계정 설정, 딸깍 하는 소리 조직 설정
  3. 설정 탭에서 아래로 스크롤하여 실행 데이터 부분.
  4. 아래에 실행 데이터 , 토글을 사용하여 조직의 실행 데이터 저장소를 활성화합니다. Genesys Cloud가 민감한 정보를 저장할 수 있음을 알리는 고지 사항 메시지가 나타납니다.
  5. 딸깍 하는 소리 저장을 활성화합니다.

다음으로 이동하려면 관리자 > 계정 설정 > 조직 설정 > 설정 ~에서 건축가 , 클릭 돕다 그리고 선택 실행 데이터 설정 .

메모:
  • 기록 실행 데이터 저장소를 활성화하거나 비활성화하려면 다음 권한이 필요합니다. 조직 설정 :

    • 예배 규칙서 > 조직 > 관리자
    • 설정 > 실행 데이터 > 편집하다 허가
    • 설정 > 실행 데이터 > 보다 허가
  • 구성 실행 데이터를 저장하려는 데이터 유형입니다. 만약에 건축가 흐름 비활성화되면 Genesys Cloud는 Execu를 저장하지 않습니다. Architect 흐름에 대한 데이터입니다.

기록 실행 데이터를 저장할 데이터 유형을 구성하려면 다음 단계를 따르세요.

  1. 딸깍 하는 소리 관리자.
  2. 아래에 계정 설정, 딸깍 하는 소리 조직 설정
  3. 설정 탭에서 아래로 스크롤하여 실행 데이터 부분.
  4. 아래에 실행 데이터 저장 , 사용 건축가 흐름 데이터 유형에 대한 실행 데이터 저장을 활성화하려면 전환하세요.

다음으로 이동하려면 관리자 > 계정 설정 > 조직 설정 > 설정 ~에서 건축가 , 클릭 돕다 그리고 선택 실행 데이터 설정 .

참고:

보기 및 활성화를 위해서는 다음 권한이 필요합니다. 건축가 흐름 에서 토글 조직 설정:

  • 건축가 > 흐름 인스턴스 실행 데이터 > 편집하다 허가
  • 건축가 > 흐름 인스턴스 실행 데이터 > 보다 허가

        {
            "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 개체

        다음을 설명하는 흐름 실행 항목:

        • 날짜 시간 = 봇 상태가 발생한 시작 날짜 및 시간입니다.
        • 실행 ID = Architect 흐름 실행 중에 실행된 봇 상태의 인스턴스를 고유하게 식별하는 Architect 실행 식별자입니다.
        • 주 ID = Architect 흐름 구성 내에서 상태를 고유하게 식별하는 Architect 식별자입니다.
        흐름:실행:actionAskForIntent 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 인텐트 작업 요청 :

        • 작업 ID = Architect 흐름 구성 내에서 Ask for Intent 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = Ask for Intent 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 Ask for Intent 작업의 실행 인스턴스를 고유하게 식별하는 Ask for Intent 작업의 실행 식별자입니다.
        • 출력 경로 ID = 흐름 런타임 시 Ask for Intent 작업이 따르는 출력 경로의 식별자입니다.
        • 추적 ID = 슬롯 요청 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 의도 요청 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:actionAskForSlot 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 슬롯 작업 요청 :

        • 작업 ID = Architect 흐름 구성 내에서 슬롯 요청 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = 슬롯 요청 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 슬롯 요청 작업의 실행 인스턴스를 고유하게 식별하는 슬롯 요청 작업의 실행 식별자입니다.
        • 출력 경로 ID = 흐름 런타임 시 슬롯 요청 작업이 따른 출력 경로의 식별자입니다.
        • 추적 ID = Ask for Intent 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 슬롯 요청 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:actionDecision 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 결정 조치 :

        • 작업 ID = Architect 흐름 구성 내에서 결정 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = 결정 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 결정 작업의 실행 인스턴스를 고유하게 식별하는 결정 작업의 실행 식별자입니다.
        • 출력 경로 ID = 흐름 런타임 시 결정 작업이 따른 출력 경로의 식별자입니다.
        • 추적 ID = 결정 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 결정 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:작업통신 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 행동을 전달하라 :

        • 작업 ID = Architect 흐름 구성 내에서 통신 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = 통신 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 통신 작업의 실행 인스턴스를 고유하게 식별하는 통신 작업의 실행 식별자입니다.
        • 추적 ID = 통신 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 통신 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:actionClearSlot 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 슬롯 지우기 작업 :

        • 작업 ID = Architect 흐름 구성 내에서 Clear Slot 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = 슬롯 지우기 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 슬롯 지우기 작업의 실행 인스턴스를 고유하게 식별하는 슬롯 지우기 작업의 실행 식별자입니다.
        • 추적 ID = 슬롯 지우기 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 슬롯 지우기 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:actionLoopAnythingElse 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 다른 건 없나요? 루프 액션 :

        • 작업 ID = Anything Else?를 고유하게 식별하는 Architect 작업 식별자입니다. Architect 흐름 구성 내의 루프 작업.
        • 날짜 시간 = Anything Else?가 발생한 날짜와 시간 루프 작업이 시작되었습니다.
        • 실행 ID = Anything Else?의 실행 식별자 Anything Else?의 실행 인스턴스를 고유하게 식별하는 루프 작업입니다. 실행된 루프 작업입니다.
        • 출력 경로 ID = Anything Else?가 실행하는 출력 경로의 식별자입니다. 흐름 런타임 시 루프 작업이 이어집니다.
        • 추적 ID = Anything Else?에 대한 건축가 추적 식별자 루프 액션. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID Anything Else?를 고유하게 식별하는 속성입니다. 흐름 구성의 루프 작업입니다.
        흐름:실행:actionExitBotFlow 개체

        에 대한 실행 데이터를 보유하는 흐름 실행 항목입니다. 봇 흐름 종료 작업 :

        • 작업 ID = Architect 흐름 구성 내에서 Bot Flow 종료 작업을 고유하게 식별하는 Architect 작업 식별자입니다.
        • 날짜 시간 = Bot Flow 종료 작업이 시작된 날짜 및 시간입니다.
        • 실행 ID = 실행된 Bot Flow 종료 작업의 실행 인스턴스를 고유하게 식별하는 Bot Flow 종료 작업의 실행 식별자입니다.
        • 추적 ID = 봇 흐름 종료 작업에 대한 설계자 추적 식별자입니다. 추적 식별자는 흐름 구성 내에서 고유하지 않을 수 있습니다. 사용 작업 ID 흐름 구성에서 Bot 흐름 종료 작업을 고유하게 식별하는 속성입니다.
        흐름:실행:endedBotState 개체

        설명하는 흐름 실행 항목

        • 날짜 시간 = 봇 상태가 발생한 종료 날짜 및 시간입니다.
        흐름:실행:종료된 흐름 개체

        설명하는 Flow 실행 항목

        • 날짜 시간 = 흐름이 발생한 날짜 및 시간입니다.
        • flowExitReason = 흐름이 종료된 이유.
        • 자연스러운언어이해 = 흐름이 종료된 시점의 자연어 이해를 위한 데이터입니다.
        흐름:실행 ID 문자열

        실행된 Architect 흐름의 고유 인스턴스를 식별하는 고유 식별자입니다.

        흐름:flowId 문자열

        Architect의 흐름에 대한 고유 식별자입니다.

        흐름: flowIsDebug 부울

        실행된 흐름이 디버그 모드에 있었는지 여부를 지정합니다.

        흐름:흐름이름 문자열

        실행된 흐름의 이름입니다.

        흐름:흐름 유형 문자열

        실행된 흐름의 Architect 흐름 유형입니다.

        흐름:흐름버전 문자열

        실행된 흐름의 버전입니다.

        흐름:startDateTime 문자열

        흐름 실행이 시작된 날짜 및 시간입니다.

        메모:
        • Genesys Cloud는 10일 동안 기록 흐름 실행 데이터를 저장합니다.
        • Genesys Cloud는 쿼리당 최대 200개의 실행 데이터 인스턴스 반환을 지원합니다. Genesys Cloud는 쿼리가 가장 최근의 200개 실행 인스턴스를 반환한다고 보장할 수 없다는 점에 유의하는 것이 중요합니다.
        • Genesys Cloud는 3일 이상 실행된 흐름의 실행 기록 데이터를 저장하지 않습니다.
        • 통화 흐름에서 Genesys Cloud는 처음 4,500개의 작업 실행만 보고합니다.
        • As common module flows are embedded in their parent flows and do not run on their own, you can get execution data for them only as part of the invoking (parent) flow’s historical execution data.
        • 다음 데이터 유형의 값이 Genesys Cloud가 실행 데이터에 저장할 수 있는 크기 제한을 초과하는 경우 Genesys Cloud는 보고합니다. valueIsTooLarge:true :
          • JSON – 최대 1,000자
          • 문자열 – 최대 253자
          • 컬렉션 데이터 유형 – 최대 20개 항목
        • Genesys Cloud는 현재 보안 통화 흐름에 대한 실행 데이터를 보고하지 않습니다. Genesys Cloud는 조직의 실행 데이터 설정이나 특정 보안 봇 흐름에 관계없이 보안 세션에서 실행된 봇 흐름과 같은 보안 흐름의 실행 인스턴스에 대한 기본 수준의 보고 데이터만 허용합니다.
        • 시작 날짜 또는 종료 날짜 시간을 기준으로 흐름 인스턴스에 대한 실행 데이터를 쿼리할 수 없습니다. 응답 범위를 좁히기 위해 Genesys Cloud는 대신 ConversationId를 사용할 것을 권장합니다.

        다음 비디오에서는 기록 실행 데이터를 활성화하고 구성하는 방법을 안내합니다. 또한 이 비디오에서는 고급 문제 해결을 위해 다양한 데이터 설정을 사용하는 방법을 보여줍니다.

        방법에 대한 자세한 내용은 조직에 대한 실행 데이터 수준을 설정하거나 개별 흐름에 대한 조직 전체 실행 데이터 수준을 재정의합니다. 참조 실행 내역 데이터 관리 .

        건축가의 기능

        Architect의 흐름 실행 내역을 사용하면 이전에 실행된 흐름의 세부 상태를 볼 수 있습니다. 자세한 내용은 다음을 참조하세요. 흐름 실행 내역 .
        Architect의 쿼리 빌더를 사용하면 흐름이 시작되고 종료되는 방식이나 개별 작업에 대한 실행 기준을 기반으로 다양한 기준을 충족하는 흐름 실행 데이터를 검색할 수 있습니다. 또한 런타임 시 Architect 작업의 값이 확인되는 설정을 볼 수도 있습니다. 자세한 내용은 다음을 참조하세요. 흐름 실행 기록 쿼리 작성 그리고 쿼리 빌더에서 쿼리 관리 .
        Architect의 재생 모드를 사용하여 봇 또는 디지털 봇 흐름의 흐름 인스턴스 데이터를 재생하여 디버깅하고 문제를 해결할 수 있습니다. 자세한 내용은 다음을 참조하세요. 재생 모드를 사용하여 Architect 흐름 문제 해결

        Architect의 Flow Insights 토글 사용 이전에 실행된 작업의 빈도를 Genesys 대화 엔진 봇 흐름 또는 Genesys 디지털 봇 흐름의 흐름 통찰력 오버레이로 확인합니다. 자세한 내용은 다음을 참조하세요. Flow Insights를 사용하여 실행된 봇 흐름 작업의 빈도를 확인하세요..

        과거 실행 데이터는 공개 API를 통해 검색할 수 있으며 알림 서비스 제3자 액세스를 위해. 공개 API의 관련 엔드포인트에 대한 자세한 내용은 다음을 참조하세요. Id별로 단일 플로우 실행 데이터 인스턴스의 다운로드를 준비하는 프로세스(작업)를 시작합니다. 그리고 비동기 흐름 실행 데이터 검색 작업의 상태 및/또는 결과 가져오기 Genesys 클라우드 개발자 센터에서.

        메모:
        • 흐름 중에 작업이 실행되는 횟수와 같은 집계 데이터는 지원되지 않습니다.
        • 게시된 흐름에 대한 흐름 실행 데이터만 볼 수 있습니다. 가장 최근 실행 데이터를 캡처하려면 쿼리를 실행하기 전에 흐름을 다시 게시하고 흐름을 통해 상호 작용을 보내야 합니다.