Historical execution data overview - Genesys Cloud Resource Center

Característica próximamente: Historical execution data, Flow execution history, Query Builder, Replay Mode

Prerrequisitos

Edge and Media Tier version:

1.0.0.15220 or later. For more information, see Media Tier release notes.

To enable or disable historical execution data storage:

Directorio > Organización > Administración
Settings > Execution Data > Edit permission
Settings > Execution Data > View permission

To set the historical execution data level for flows for the organization:

Architect > Flow Default Log Level > Delete permission
Architect > Flow Default Log Level > Edit permission
Architect > Flow Default Log Level > View permission

To set the historical execution data level for a specific flow:

Architect > Flow Log Level > Add permission
Architect > Flow Log Level > Delete permission
Architect > Flow Log Level > Edit permission
Architect > Flow Log Level > View permission

To see execution data for a flow:

Architect > Flow Instance Execution Data > Edit permission
Architect > Flow Instance Execution Data > View permission

Genesys Cloud offers access to comprehensive historical execution data for all Architect flow types. With advanced capabilities in historical data analysis, users can manage and analyze historical execution data effectively, and gain insights into user journeys to make improvements and troubleshoot. Users can enable or disable execution data storage and select from four distinct levels of execution data granularity:

Base: understand high-level user journeys through Architect actions and navigated menus, errors, and events.
Notes: optimize Architect flows using variable values (includes the Base level).
Verbose Notes: access conversation content with communication values (includes the Notes level).
All: troubleshoot through action input and output values (includes the Verbose Notes level).

Notas:

Historical execution data counts toward your organization’s data storage limit under the Genesys Cloud fair use policy. For more information, see Genesys Cloud fair use policy.
Execution data storage is disabled by default. To start capturing execution data, you must enable it and republish flows.

The following examples are possible scenarios that consumers of historical execution data can use the execution data for:

Escuchar eventos de flujo específicos, por ejemplo, cuando los flujos se encuentran con un error.
Observar los eventos de un flujo específico y analizar elementos específicos de la ejecución del flujo, por ejemplo, cuando un flujo ejecuta una acción determinada y la acción toma la ruta de fallo o de tiempo de espera.
Ver qué flujos se ejecutan más que otros

Enable execution data storage

Genesys Cloud disables historical execution data storage by default. To enable storage, follow these steps:

Hacer clic Administración.
Debajo Configuraciones de la cuenta, hacer clic Configuración de la organización.
On the Settings tab, scroll down to the Execution Data section.
Under Execution Data, use the toggle to enable execution data storage for your organization.
A disclaimer message appears that informs you that Genesys Cloud may store sensitive information. Click Yes to enable storage.

To navigate to Admin > Account Settings > Organization Settings > Settings from Architect, click Help and select Execution Data Settings.

Nota: Configure what data types you want to store execution data for. If Architect Flows are disabled, Genesys Cloud does not store execution data for Architect flows.

Enable data storage for Architect flows

To configure what data types to store historical execution data for, follow these steps:

Hacer clic Administración.
Debajo Configuraciones de la cuenta, hacer clic Configuración de la organización.
On the Settings tab, scroll down to the Execution Data section.
Under Execution Data Storage, use the Architect Flows toggle to enable execution data storage for the data type.

To navigate to Admin > Account Settings > Organization Settings > Settings from Architect, click Help and select Execution Data Settings.

Muestra de datos históricos de ejecución de flujos

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

Nota: La siguiente tabla sólo incluye información sobre los datos de la muestra.

Nombre	Escribe	Descripción
Nombre	Escribe	Descripción
flow:conversationId	Cuerda	El identificador único de una conversación en Genesys Cloud. En una conversación pueden intervenir varios flujos o agentes.
flujo:división:id	Cuerda	La división en la que se encuentra el flujo cuando Genesys Cloud guarda los datos de ejecución una vez finalizada la ejecución del flujo.
flow:endDateTime	Cuerda	The date and time when the flow execution was completed.
flujo:ejecución	Formación	Una matriz de elementos de ejecución del flujo que describen lo que ocurrió cuando se ejecutó el flujo.
flujo:ejecución:flujoiniciado	Objeto	Elemento de ejecución del flujo que describe la fecha y hora de inicio del flujo y el idioma en el que se estaba ejecutando.
flujo:ejecución:estadoBotiniciado	Objeto	A flow execution item that describes: dateTime = la fecha y hora iniciales en las que se produjo el estado del bot. executionId = el identificador de ejecución de Architect que identifica de forma exclusiva la instancia del estado del bot que se ejecutó durante la ejecución del flujo de Architect. stateId = el identificador de Architect que identifica de forma exclusiva el estado dentro de la configuración del flujo de Architect.
flujo:ejecución:acciónPreguntarParaIntentar	Objeto	El elemento de ejecución de flujo que contiene los datos de ejecución de la acción Ask for Intent: actionId = el identificador de acción de Architect que identifica de forma exclusiva la acción de solicitud de intención dentro de la configuración del flujo de Architect. dateTime = la fecha y hora en que se inició la acción de solicitud de intención. executionId = el identificador de ejecución de la acción de solicitud de intención que identifica de forma exclusiva la instancia de ejecución de la acción de solicitud de intención que se ejecutó. outputPathId = El identificador de la ruta de salida que siguió la acción Ask for Intent en tiempo de ejecución del flujo. trackingId = el identificador de seguimiento de Architect para la acción Solicitar franja horaria. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar unívocamente la acción Pedir Intención en la configuración del flujo.
flujo:ejecución:acciónPedirRanura	Objeto	El elemento de ejecución del flujo que contiene los datos de ejecución de la acción Ask for Slot: actionId = el identificador de acción de Architect que identifica de forma exclusiva la acción Ask for Slot dentro de la configuración del flujo de Architect. dateTime = la fecha y hora en que se inició la acción Pedir franja horaria. executionId = el identificador de ejecución de la acción Ask for Slot que identifica de forma única la instancia de ejecución de la acción Ask for Slot que se ejecutó. outputPathId = Identificador de la ruta de salida que siguió la acción Ask for Slot en tiempo de ejecución del flujo. trackingId = el identificador de seguimiento de Architect para la acción de solicitud de intención. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar unívocamente la acción Ask for Slot en la configuración del flujo.
flujo:ejecución:acciónDecisión	Objeto	Elemento de ejecución del flujo que contiene los datos de ejecución de la acción de decisión : actionId = el identificador de la acción de Architect que identifica de forma exclusiva la acción de Decisión dentro de la configuración del flujo de Architect. dateTime = fecha y hora de inicio de la acción de Decisión. executionId = el identificador de ejecución de la acción de Decisión que identifica de forma única la instancia de ejecución de la acción de Decisión que se ejecutó. outputPathId = El identificador de la ruta de salida que siguió la acción de Decisión en tiempo de ejecución del flujo. trackingId = el identificador de seguimiento del Arquitecto para la acción de Decisión. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar unívocamente la acción Decisión en la configuración del flujo.
flujo:ejecución:acciónComunicar	Objeto	El elemento de ejecución del flujo que contiene los datos de ejecución de la acción Communicate: actionId = el identificador de acción de Architect que identifica de forma exclusiva la acción Comunicar dentro de la configuración del flujo de Architect. dateTime = fecha y hora de inicio de la acción Comunicar. executionId = el identificador de ejecución de la acción Communicate que identifica de forma única la instancia de ejecución de la acción Communicate que se ejecutó. trackingId = el identificador de seguimiento del Arquitecto para la acción Comunicar. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar unívocamente la acción Communicate en la configuración del flujo.
flujo:ejecución:acciónBorrarRanura	Objeto	El elemento de ejecución de flujo que contiene los datos de ejecución de la acción Clear Slot: actionId = el identificador de acción de Architect que identifica de forma exclusiva la acción Borrar ranura dentro de la configuración de flujo de Architect. dateTime = la fecha y hora en que se inició la acción Borrar ranura. executionId = el identificador de ejecución de la acción Clear Slot que identifica de forma única la instancia de ejecución de la acción Clear Slot que se ejecutó. trackingId = el identificador de seguimiento del arquitecto para la acción Borrar ranura. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar de forma única la acción Clear Slot en la configuración del flujo.
flujo:ejecución:actionLoopAnythingElse	Objeto	El elemento de ejecución del flujo que contiene los datos de ejecución de ¿Algo más? Acción en bucle: actionId = el identificador de la acción del arquitecto que identifica de forma exclusiva la acción Anything Else? Acción de bucle dentro de la configuración del flujo Architect. dateTime = la fecha y la hora en que se produjo el evento Anything Else? Acción de bucle iniciada. executionId = el identificador de ejecución para el archivo Anything Else? Acción de bucle que identifica de forma única la instancia de ejecución de la acción ¿Cualquier otra cosa? Acción de bucle que se ejecutó. outputPathId = El identificador de la ruta de salida que la aplicación Anything Else? Acción de bucle seguida en tiempo de ejecución del flujo. trackingId = el identificador de seguimiento del arquitecto para el archivo Anything Else? Acción en bucle. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar de forma unívoca la acción Anything Else? Acción de bucle en la configuración del flujo.
flujo:ejecucion:accionSalirBotFlujo	Objeto	El elemento de ejecución del flujo que contiene los datos de ejecución de la acción Exit Bot Flow: actionId = el identificador de acción de Architect que identifica de forma exclusiva la acción Exit Bot Flow dentro de la configuración del flujo de Architect. dateTime = la fecha y hora en que se inició la acción Salir del flujo de bots. executionId = el identificador de ejecución de la acción Exit Bot Flow que identifica de manera única la instancia de ejecución de la acción Exit Bot Flow que se ejecutó. trackingId = el identificador de seguimiento Architect para la acción Exit Bot Flow. Un identificador de seguimiento puede no ser único dentro de la configuración del flujo. Utilice la propiedad actionId para identificar unívocamente la acción Exit Bot Flow en la configuración del flujo.
flow:execution:endedEstadoBot	Objeto	Un elemento de ejecución de flujo que describe dateTime = la fecha y hora finales en las que se produjo el estado del bot.
flujo:ejecución:flujoFinalizado	Objeto	El elemento de ejecución del flujo que describe dateTime = la fecha y hora en que se produjo el flujo. flowExitReason = la razón por la que finalizó un flujo. naturalLanguageUnderstanding = los datos de comprensión del lenguaje natural para cuando finalizó el flujo.
flujo:executionId	Cuerda	El identificador único que identifica una instancia única de un flujo de Arquitectura que se ejecutó.
flujo:flowId	Cuerda	Identificador único del flujo en Architect.
flujo:flujoIsDebug	Booleano	Especifica si el flujo ejecutado estaba en modo depuración.
flujo:nombreDelFlujo	Cuerda	El nombre del flujo que se ejecutó.
flujo:tipoDeFlujo	Cuerda	El tipo de flujo Architect del flujo que se ha ejecutado.
flujo:flujoVersión	Cuerda	La versión del flujo que se ejecutó.
flujo:startDateTime	Cuerda	Fecha y hora de inicio de la ejecución del flujo.

Notas:

Genesys Cloud almacena los datos históricos de ejecución de flujos durante 10 días.
Genesys Cloud supports returning a maximum of 200 execution data instances per query. It is important to note that Genesys Cloud cannot guarantee that the query returns the most recent 200 execution instances.
Genesys Cloud no almacena los datos históricos de ejecución de los flujos que se ejecutan durante más de tres días.
In call flows, Genesys Cloud reports only the first 4,500 action executions.
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 characters
- String – maximum 253 characters
- Collection data types – maximum 20 items
Genesys Cloud does not currently report execution data for secure call flows. Genesys Cloud only allows reporting data at the Base level for execution instances of secure flows, for example, bot flows that ran in a secure session, regardless of the execution data setting of your organization or the specific secure bot flows.
It is not possible to query execution data for flow instances by start or end date time. To narrow the scope of responses, Genesys Cloud recommends that you rely on conversationId instead.

The following video walks you through how to enable and configure historical execution data. The video also demonstrates how you can use the various data settings for advanced troubleshooting.

Funciones en Architect

Historial de ejecución del flujo

Utilice el historial de ejecución de flujos de Architect para ver el estado detallado de los flujos ejecutados anteriormente. Para más información, consulte Historial de ejecución de flujos.

Generador de consultas

Utilice el Generador de consultas de Architect para buscar datos de ejecución de flujos que cumplan diferentes criterios, en función de cómo comenzó y terminó un flujo, o en función de los criterios de ejecución de acciones individuales. También puede ver la configuración a la que se resolvieron los valores de una acción de Architect en tiempo de ejecución. Para obtener más información, consulte Construir una consulta del historial de ejecución de flujos y Gestionar una consulta en el Generador de consultas.

Modo Repetición

Utilice el modo de reproducción de Architect para reproducir los datos de instancia de flujo de un bot o un flujo de bot digital para depurar y solucionar problemas. Para obtener más información, consulte Utilizar el modo de repetición para solucionar problemas de un flujo de Architect.

Flujo de información

Utilice el conmutador Flow Insights de Architect para ver la frecuencia de las acciones ejecutadas anteriormente como una superposición de Flow Insights en un Genesys Dialog Engine Bot Flow o un Genesys Digital Bot Flow. Para obtener más información, consulte Utilice Flow Insights para ver la frecuencia de las acciones de flujo del bot ejecutadas.

Historical execution data is retrievable via the public API and the notification service for third-party access. For more information about the relevant endpoints in the public API, see Start a process (job) to prepare a download of a singular flow execution data instance by Id and Get the status and/or results of an asynchronous flow execution data retrieval job in the Genesys Cloud Developer Center.

Notas:

No se admiten datos agregados, como el recuento del número de veces que se ejecuta una acción durante un flujo.
Sólo se pueden visualizar los datos de ejecución de los flujos publicados. Para asegurarse de que captura los datos de ejecución más recientes, asegúrese de volver a publicar el flujo y enviar una interacción a través de él antes de ejecutar una consulta.