Datos históricos de ejecución
Prerrequisitos
Versión Edge y Media Tier:
- 1.0.0.15220 o posterior. Para más información, consulte las notas de la versión de Media Tier.
Para activar o desactivar el almacenamiento de datos históricos de ejecución:
- Directorio > Organización > Administración
- Configuración > Datos de ejecución > Editar permiso
- Configuración > Datos de ejecución > Vista permiso
Para establecer el nivel de datos de ejecución histórica de los flujos para la organización:
- Arquitecto > Flujo Nivel de registro por defecto > Borrar permiso
- Arquitecto > Flujo Nivel de registro por defecto > Editar permiso
- Arquitecto > Flujo Nivel de registro por defecto > Ver permiso
Para establecer el nivel de datos históricos de ejecución para un flujo específico:
- Arquitecto > Nivel de registro de flujo > Añadir permiso
- Arquitecto > Flujo Nivel de registro > Borrar permiso
- Arquitecto > Nivel de registro de flujo > Editar permiso
- Arquitecto > Flujo Nivel de registro > Vista permiso
Para ver los datos de ejecución de un flujo:
- Arquitecto > Datos de ejecución de la instancia de flujo > Editar permiso
- Arquitecto > Datos de ejecución de la instancia de flujo > Ver permiso
Genesys Cloud ofrece acceso a completos datos históricos de ejecución para todos los tipos de flujo de Architect. Gracias a las funciones avanzadas de análisis de datos históricos, los usuarios pueden gestionar y analizar eficazmente los datos de ejecución históricos y obtener información sobre los recorridos de los usuarios para realizar mejoras y solucionar problemas. Los usuarios pueden activar o desactivar el almacenamiento de datos de ejecución y seleccionar entre cuatro niveles distintos de granularidad de los datos de ejecución:
- Base: comprender recorridos de usuario de alto nivel a través de acciones de arquitecto y menús navegados, errores y eventos.
- Notas: optimizar Arquitecto flujos utilizando valores variables (incluye el nivel Base).
- Verbose Notes: acceso contenido de la conversación con valores de comunicación (incluye el nivel Notes).
- Todos: solución de problemas a través de valores de entrada y salida de acción (incluye el nivel Verbose Notes).
Notas:
- Los datos de ejecución históricos cuentan para el límite de almacenamiento de datos de su organización según la política de uso razonable de Genesys Cloud. Para obtener más información, consulte Política de uso razonable de Genesys Cloud.
- El almacenamiento de datos de ejecución está desactivado por defecto. Para empezar a capturar datos de ejecución, debe habilitarlo y volver a publicar flujos.
Los siguientes ejemplos son posibles escenarios para los que los consumidores de datos históricos de ejecución pueden utilizar los datos de ejecución:
- 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
Genesys Cloud desactiva por defecto el almacenamiento de datos históricos de ejecución. Para activar el almacenamiento, siga estos pasos:
- Hacer clic Administración.
- Debajo Configuraciones de la cuenta, hacer clic Configuración de la organización.
- En la pestaña Configuración , desplácese hasta la sección Datos de ejecución .
- En Execution Data, utilice el conmutador para activar el almacenamiento de datos de ejecución para su organización. Aparece un mensaje de descargo de responsabilidad que le informa de que Genesys Cloud puede almacenar información confidencial.
- Haga clic en Sí para habilitar el almacenamiento.
Para navegar a Admin > Configuración de la cuenta > Configuración de la organización > Configuración desde Arquitecto, haga clic en Ayuda y seleccione Configuración de datos de ejecución.
Notas:
-
Necesita los siguientes permisos para habilitar o deshabilitar el almacenamiento de datos históricos de ejecución en Configuración de la organización:
- Directorio > Organización > Administración
- Configuración > Datos de ejecución > Editar permiso
- Configuración > Datos de ejecución > Vista permiso
- Configure los tipos de datos para los que desea almacenar datos de ejecución. Si Architect Flows está desactivado, Genesys Cloud no almacena los datos de ejecuciónde los flujos de Architect.
Para configurar los tipos de datos para los que almacenar datos históricos de ejecución, siga estos pasos:
- Hacer clic Administración.
- Debajo Configuraciones de la cuenta, hacer clic Configuración de la organización.
- En la pestaña Configuración , desplácese hasta la sección Datos de ejecución .
- En Execution Data Storage, utilice el conmutador Architect Flows para activar el almacenamiento de datos de ejecución para el tipo de datos.
Para navegar a Admin > Configuración de la cuenta > Configuración de la organización > Configuración desde Arquitecto, haga clic en Ayuda y seleccione Configuración de datos de ejecución.
Nota:
Necesita los siguientes permisos para ver y activar el conmutador Architect Flows en la Configuración de la organización :
- Arquitecto > Datos de ejecución de la instancia de flujo > Editar permiso
- Arquitecto > Datos de ejecución de la instancia de flujo > Ver permiso
{
"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 |
Fecha y hora en que finalizó la ejecución del flujo.
|
| 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 |
Un elemento de ejecución de flujo que describe:
|
| 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:
|
| 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:
|
| 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 :
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| flow:execution:endedEstadoBot | Objeto |
Un elemento de ejecución de flujo que describe
|
| flujo:ejecución:flujoFinalizado | Objeto |
El elemento de ejecución del flujo que describe
|
| 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 admite la devolución de un máximo de 200 instancias de datos de ejecución por consulta. Es importante tener en cuenta que Genesys Cloud no puede garantizar que la consulta devuelva las 200 instancias de ejecución más recientes.
- Genesys Cloud no almacena los datos históricos de ejecución de los flujos que se ejecutan durante más de tres días.
- En los flujos de llamadas, Genesys Cloud sólo informa de las primeras 4.500 ejecuciones de acciones.
- Dado que los flujos de módulos comunes están incrustados en sus flujos padre y no se ejecutan por sí solos, sólo se pueden obtener datos de ejecución para ellos como parte de los datos de ejecución históricos del flujo invocador (padre).
- Si un valor de los siguientes tipos de datos supera el límite de tamaño que Genesys Cloud puede almacenar en los datos de ejecución, Genesys Cloud informa
valueIsTooLarge:true:- JSON - máximo 1.000 caracteres
- Cadena - máximo 253 caracteres
- Tipos de datos de recogida - 20 elementos como máximo
- Genesys Cloud solo permite la generación de informes de datos en el nivel Base para instancias de ejecución de flujos seguros, por ejemplo, flujos de bots que se ejecutaron en una sesión segura, independientemente de la configuración de datos de ejecución de su organización o de los flujos de bots seguros específicos.
- No es posible consultar los datos de ejecución de los flujos por fecha de inicio o fin. Para limitar el alcance de las respuestas, Genesys Cloud recomienda que se base en conversationId en su lugar.
El siguiente vídeo muestra cómo activar y configurar los datos históricos de ejecución. El vídeo también muestra cómo utilizar los distintos ajustes de datos para la resolución avanzada de problemas.
Para obtener más información sobre cómo establecer el nivel de datos de ejecución para una organización o anular el nivel de datos de ejecución de toda la organización para un flujo individual, consulte Gestionar datos de ejecución históricos.
Funciones en Architect
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.
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.
Utilice el modo de reproducción de Architect para reproducir los datos de instancia de flujo de los flujos de Architect 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.
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.
Los datos históricos de ejecución pueden recuperarse a través de la API pública y el servicio de notificación para el acceso de terceros. Para obtener más información sobre los puntos finales relevantes de la API pública, consulte Iniciar un proceso (trabajo) para preparar una descarga de una instancia de datos de ejecución de flujo singular por Id y Obtener el estado y/o los resultados de un trabajo de recuperación de datos de ejecución de flujo asíncrono en el Centro de desarrollo de Genesys Cloud.
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.
