Aperçu des données d'exécution historiques

Conditions préalables

Version Edge et Media Tier :

Pour activer ou désactiver le stockage des données d'exécution historiques :

  • Annuaire > Organisation > Admin
  • Paramètres > Données d'exécution > Modifier autorisation
  • Paramètres > Données d'exécution > Affichage autorisation

Pour définir le niveau des données d'exécution historique des flux pour l'organisation :

  • Architecte > Niveau du journal des flux Défaut > Supprimer l'autorisation
  • Architecte > Flow Log Level Default > Edit permission
  • Architect > Flow Log Level Default > View permission

Pour définir le niveau des données d'exécution historiques pour un flux spécifique :

  • Architecte > Niveau du journal des flux > Ajouter l'autorisation
  • Architecte > Niveau du journal des flux > Supprimer l'autorisation
  • Architecte > Niveau du journal des flux > Modifier autorisation
  • Architect > Flow Log Level > View permission

Pour consulter les données d'exécution d'un flux :

  • Architecte > Flow Instance Execution Data > Edit permission
  • Architecte > Flow Instance Execution Data > View permission

Genesys Cloud permet d'accéder à un historique complet des données d'exécution pour tous les types de flux Architect. Grâce aux fonctionnalités avancées d'analyse des données historiques, les utilisateurs peuvent gérer et analyser efficacement les données d'exécution historiques et obtenir des informations sur les parcours des utilisateurs afin d'apporter des améliorations et de résoudre les problèmes. Les utilisateurs peuvent activer ou désactiver le stockage des données d'exécution et choisir parmi quatre niveaux distincts de granularité des données d'exécution :

  • Base : comprendre parcours de l'utilisateur de haut niveau à travers les actions de l'architecte et les menus navigués, les erreurs et les événements.
  • Notes : optimiser Architecte flux utilisant des valeurs variables (y compris le niveau de base).
  • Notes verbeuses : accès contenu de la conversation avec les valeurs de communication (y compris le niveau Notes).
  • Tous : dépannage par le biais de valeurs d'entrée et de sortie d'action (y compris le niveau Verbose Notes).

Remarques:
  • Les données d'exécution historiques sont prises en compte dans la limite de stockage de données de votre organisation dans le cadre de la politique d'utilisation équitable de Genesys Cloud. Pour plus d'informations, voir Politique d'utilisation équitable de Genesys Cloud.
  • Le stockage des données d'exécution est désactivé par défaut. Pour commencer à capturer des données d'exécution, vous devez l'activer et republier les flux.

Les exemples suivants sont des scénarios possibles pour lesquels les consommateurs de données d'exécution historiques peuvent utiliser les données d'exécution :

  • Écouter des événements de flux spécifiques, par exemple lorsque les flux rencontrent une erreur.
  • Observer les événements pour un flux spécifique et analyser les éléments d'exécution du flux, par exemple, lorsqu'un flux exécute une action particulière et que l'action prend la voie de l'échec ou du dépassement de délai.
  • Voir quels sont les flux qui circulent le plus

Genesys Cloud désactive par défaut le stockage des données d'exécution historiques. Pour activer le stockage, procédez comme suit :

  1. Cliquez sur Admin. 
  2. Sous Paramètres du compte, cliquez sur Paramètres de l’organisation. 
  3. Dans l'onglet Settings , descendez jusqu'à la section Execution Data .
  4. Sous Execution Data, utilisez la bascule pour activer le stockage des données d'exécution pour votre organisation. Un message d'avertissement apparaît pour vous informer que Genesys Cloud peut stocker des informations sensibles.
  5. Cliquez sur Yes pour activer le stockage.

Pour accéder à Admin > Account Settings > Organization Settings > Settings à partir de Architect, cliquez sur Help et sélectionnez Execution Data Settings.

Remarques:

  • Vous devez disposer des autorisations suivantes pour activer ou désactiver le stockage des données d'exécution historiques dans les paramètres de l'organisation :

    • Annuaire > Organisation > Admin
    • Paramètres > Données d'exécution > Modifier autorisation
    • Paramètres > Données d'exécution > Affichage autorisation
  • Configurez les types de données pour lesquels vous souhaitez stocker les données d'exécution. Si l'option Architect Flows est désactivée, Genesys Cloud ne stocke pas les données d'exécution des flux Architect.

Pour configurer les types de données pour lesquels stocker les données d'exécution historiques, procédez comme suit :

  1. Cliquez sur Admin. 
  2. Sous Paramètres du compte, cliquez sur Paramètres de l’organisation. 
  3. Dans l'onglet Settings , descendez jusqu'à la section Execution Data .
  4. Sous Execution Data Storage, utilisez le bouton Architect Flows pour activer le stockage des données d'exécution pour le type de données.

Pour accéder à Admin > Account Settings > Organization Settings > Settings à partir de Architect, cliquez sur Help et sélectionnez Execution Data Settings.

Remarque :

Vous devez disposer des autorisations suivantes pour afficher et activer la bascule Architect Flows dans Organization Settings :

  • Architecte > Flow Instance Execution Data > Edit permission
  • Architecte > Flow Instance Execution Data > View permission

        {
    "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"
    }
}

        Remarque :  Le tableau suivant contient uniquement des informations sur les données de l'échantillon.

        Nom Type Description
        Nom Type Description
        flow:conversationId Chaîne L'identifiant unique d'une conversation dans Genesys Cloud. Une conversation peut impliquer plusieurs flux ou agents.
        flux:division:id Chaîne
        La division dans laquelle se trouve le flux lorsque Genesys Cloud enregistre les données d'exécution après la fin de l'exécution du flux.
        flow:endDateTime Chaîne
        La date et l'heure auxquelles l'exécution du flux s'est achevée.
        flux:exécution Tableau Tableau d'éléments d'exécution du flux décrivant ce qui s'est passé lors de l'exécution du flux.
        flow:execution:startedFlow Objet Élément d'exécution du flux qui décrit la date et l'heure de début du flux et la langue dans laquelle le flux a été exécuté.
        flow:execution:startedBotState Objet

        Un élément d'exécution de flux qui décrit :

        • dateTime = la date et l'heure de début de l'état du robot.
        • executionId = l'identifiant d'exécution de l'architecte qui identifie de manière unique l'instance de l'état du bot qui s'est déroulée pendant l'exécution du flux de l'architecte.
        • stateId = l'identifiant de l'architecte qui identifie de manière unique l'état dans la configuration du flux de l'architecte.
        flow:execution:actionAskForIntent Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action Ask for Intent:

        • actionId = l'identifiant de l'action Architect qui identifie de manière unique l'action Ask for Intent dans la configuration du flux Architect.
        • dateTime = la date et l'heure auxquelles l'action Ask for Intent a commencé.
        • executionId = l'identifiant d'exécution de l'action Ask for Intent qui identifie de manière unique l'instance d'exécution de l'action Ask for Intent qui s'est déroulée.
        • outputPathId = L'identifiant du chemin de sortie suivi par l'action Ask for Intent lors de l'exécution du flux.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action Ask for Slot. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Ask for Intent dans la configuration du flux.
        flow:execution:actionAskForSlot Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action Ask for Slot:

        • actionId = l'identifiant de l'action Architect qui identifie de manière unique l'action Ask for Slot dans la configuration du flux Architect.
        • dateTime = la date et l'heure auxquelles l'action Ask for Slot a commencé.
        • executionId = l'identifiant d'exécution de l'action Ask for Slot qui identifie de manière unique l'instance d'exécution de l'action Ask for Slot qui s'est déroulée.
        • outputPathId = L'identifiant du chemin de sortie suivi par l'action Ask for Slot lors de l'exécution du flux.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action Ask for Intent. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Ask for Slot dans la configuration du flux.
        flux:exécution:actionDécision Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action de décision :

        • actionId = l'identifiant de l'action de l'architecte qui identifie de manière unique l'action de décision dans la configuration du flux de l'architecte.
        • dateTime = la date et l'heure du début de l'action décisionnelle.
        • executionId = l'identifiant d'exécution de l'action de décision qui identifie de manière unique l'instance d'exécution de l'action de décision qui s'est déroulée.
        • outputPathId = Identifiant du chemin de sortie suivi par l'action de décision au moment de l'exécution du flux.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action de décision. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action de décision dans la configuration du flux.
        flux:exécution:actionCommuniquer Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action Communiquer:

        • actionId = l'identifiant de l'action Architect qui identifie de manière unique l'action Communicate dans la configuration du flux Architect.
        • dateTime = la date et l'heure de début de l'action de communication.
        • executionId = l'identifiant d'exécution de l'action de communication qui identifie de manière unique l'instance d'exécution de l'action de communication qui s'est déroulée.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action Communiquer. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Communicate dans la configuration du flux.
        flow:execution:actionClearSlot Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action Clear Slot:

        • actionId = l'identifiant de l'action Architect qui identifie de manière unique l'action Clear Slot dans la configuration du flux Architect.
        • dateTime = la date et l'heure auxquelles l'action Clear Slot a commencé.
        • executionId = l'identifiant d'exécution de l'action Clear Slot qui identifie de manière unique l'instance d'exécution de l'action Clear Slot qui s'est déroulée.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action Clear Slot. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Clear Slot dans la configuration du flux.
        flow:execution:actionLoopAnythingElse Objet

        L'élément d'exécution du flux qui contient les données d'exécution pour le site Anything Else ? Action en boucle:

        • actionId = l'identifiant de l'action de l'architecte qui identifie de manière unique l'action Anything Else ? Action en boucle dans la configuration du flux d'architecture.
        • dateTime = la date et l'heure auxquelles le Anything Else ? L'action en boucle a commencé.
        • executionId = l'identifiant d'exécution de l'action Anything Else ? Action de boucle qui identifie de manière unique l'instance d'exécution de l'action Anything Else ? Action en boucle qui a fonctionné.
        • outputPathId = L'identifiant du chemin de sortie que le logiciel Anything Else ? Action en boucle suivie au moment de l'exécution du flux.
        • trackingId = l'identifiant de suivi de l'architecte pour le site Anything Else ? Action en boucle. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Anything Else ? Action en boucle dans la configuration du flux.
        flow:execution:actionExitBotFlow Objet

        L'élément d'exécution du flux qui contient les données d'exécution de l'action Exit Bot Flow:

        • actionId = l'identifiant de l'action Architect qui identifie de manière unique l'action Exit Bot Flow dans la configuration du flux Architect.
        • dateTime = la date et l'heure auxquelles l'action Exit Bot Flow a commencé.
        • executionId = l'identifiant d'exécution de l'action Exit Bot Flow qui identifie de manière unique l'instance d'exécution de l'action Exit Bot Flow qui s'est exécutée.
        • trackingId = l'identifiant de suivi de l'architecte pour l'action Exit Bot Flow. Un identifiant de suivi peut ne pas être unique dans la configuration du flux. Utilisez la propriété actionId pour identifier de manière unique l'action Exit Bot Flow dans la configuration du flux.
        flow:execution:endedBotState Objet

        Un élément d'exécution de flux qui décrit

        • dateTime = la date et l'heure de fin de l'état du robot.
        flow:execution:endedFlow Objet

        L'élément d'exécution du flux qui décrit

        • dateTime = date et heure auxquelles le flux s'est produit.
        • flowExitReason = la raison pour laquelle un flux s'est terminé.
        • naturalLanguageUnderstanding = les données relatives à la compréhension du langage naturel pour le moment où le flux s'est terminé.
        flow:executionId Chaîne

        L'identifiant unique qui identifie une instance unique d'un flux d'architecture qui s'est déroulé.
        flow:flowId Chaîne

        L'identifiant unique du flux dans Architect.

        flow :flowIsDebug Booléen

        Il indique si le flux exécuté était en mode débogage.
        flow:flowName Chaîne

        Le nom du flux qui s'est déroulé.
        flow:flowType Chaîne

        Le type de flux Architect du flux qui a été exécuté.
        flow:flowVersion Chaîne

        La version du flux qui a fonctionné.
        flow:startDateTime Chaîne

        La date et l'heure auxquelles l'exécution du flux a commencé.

        Remarques:
        • Genesys Cloud stocke les données historiques d'exécution des flux pendant 10 jours.
        • Genesys Cloud permet de renvoyer un maximum de 200 instances de données d'exécution par requête. Il est important de noter que Genesys Cloud ne peut pas garantir que la requête renvoie les 200 instances d'exécution les plus récentes.
        • Genesys Cloud ne stocke pas les données d'exécution historiques des flux qui durent plus de trois jours.
        • Dans les flux d'appels, Genesys Cloud ne rapporte que les 4 500 premières exécutions d'actions.
        • Comme les flux de modules communs sont intégrés dans leurs flux parents et ne s'exécutent pas seuls, vous ne pouvez obtenir des données d'exécution pour eux que dans le cadre des données d'exécution historiques du flux invoqué (parent).
        • 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 - maximum 1 000 caractères
          • Chaîne - 253 caractères maximum
          • Types de données de la collection - 20 éléments au maximum
        • Genesys Cloud autorise uniquement les données de reporting au niveau de la base pour les instances d'exécution des flux sécurisés, par exemple les flux de robots qui s'exécutent dans une session sécurisée, quel que soit le paramétrage des données d'exécution de votre organisation ou les flux de robots sécurisés spécifiques.
        • Il n'est pas possible d'interroger les données d'exécution des instances de flux par date de début ou de fin. Pour réduire la portée des réponses, Genesys Cloud recommande d'utiliser plutôt conversationId.

        La vidéo suivante vous explique comment activer et configurer les données d'exécution historiques. La vidéo montre également comment utiliser les différents paramètres de données pour un dépannage avancé.

        Pour plus d'informations sur la manière de définir le niveau des données d'exécution pour une organisation ou de remplacer le niveau des données d'exécution à l'échelle de l'organisation pour un flux individuel, voir Gérer les données d'exécution historiques.

        Caractéristiques de l'architecte

        L'historique d'exécution des flux d'Architect permet de consulter l'état détaillé des flux exécutés précédemment. Pour plus d'informations, voir Historique de l'exécution des flux.
        Utilisez le générateur de requêtes d'Architect pour rechercher des données d'exécution de flux répondant à différents critères, en fonction de la façon dont un flux a commencé et s'est terminé, ou en fonction de critères d'exécution pour des actions individuelles. Vous pouvez également visualiser le paramètre auquel les valeurs d'une action d'architecture ont été résolues au moment de l'exécution. Pour plus d'informations, voir Construire une requête sur l'historique de l'exécution du flux et Gérer une requête dans le générateur de requêtes.
        Utilisez le mode Replay d'Architect pour lire les données d'instance des flux Architect afin de les déboguer et de les dépanner. Pour plus d'informations, voir Utiliser le mode de relecture pour dépanner un flux d'architecture. 

        Utilisez la bascule Flow Insights d'Architect pour afficher la fréquence des composants de flux précédemment exécutés sous forme de superposition dans les flux d'Architect. Pour plus d'informations, voir Utilisez Flow Insights pour afficher la fréquence des composants de flux exécutés.

        Note: Il n'est pas nécessaire d'activer le stockage des données d'exécution pour les flux Architect afin d'utiliser Flow Insights.

        Les données d'exécution historiques sont accessibles via l'API publique et le service de notification pour l'accès des tiers. Pour plus d'informations sur les points de terminaison pertinents de l'API publique, voir Start a process (job) to prepare a download of a singular flow execution data instance by Id et Get the status and/or results of an asynchronous flow execution data retrieval job dans le Genesys Cloud Developer Center.

        Remarques:
        • Les données agrégées, telles que le nombre de fois qu'une action est exécutée au cours d'un flux, ne sont pas prises en charge.
        • Vous ne pouvez consulter les données d'exécution des flux que pour les flux publiés. Pour vous assurer de capturer les données d'exécution les plus récentes, veillez à republier le flux et à y envoyer une interaction avant d'exécuter une requête.