Aperçu des données d'exécution historiques
Version Edge et Media Tier :
- 1.0.0.15220 ou plus récent. Pour plus d'informations, voir Media Tier release notes.
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).
- 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 :
- Cliquez sur Admin.
- Sous Paramètres du compte, cliquez sur Paramètres de l’organisation.
- Dans l'onglet Settings , descendez jusqu'à la section Execution Data .
- 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.
- 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.
-
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 :
- Cliquez sur Admin.
- Sous Paramètres du compte, cliquez sur Paramètres de l’organisation.
- Dans l'onglet Settings , descendez jusqu'à la section Execution Data .
- 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.
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" } }
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 :
|
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:
|
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:
|
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 :
|
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:
|
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:
|
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:
|
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:
|
flow:execution:endedBotState | Objet |
Un élément d'exécution de flux qui décrit
|
flow:execution:endedFlow | Objet |
L'élément d'exécution du flux qui décrit
|
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é. |
- 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).
- Si une valeur des types de données suivants dépasse la limite de taille que Genesys Cloud peut stocker dans les données d'exécution, Genesys Cloud signale
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
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.
- 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.