历史执行数据概览

必备

Edge 和 Media Tier 版本:

  • 1.0.0.15220 或更高版本。 有关详细信息,请参阅For more information, see媒体层发行说明

启用或禁用历史执行数据存储:

  • 目录 > 组织 > 管理员
  • 设置>执行数据>编辑允许
  • 设置>执行数据>看法允许

要设置组织流程的历史执行数据级别:

  • 建筑师>流日志级别默认>删除允许
  • 建筑师>流日志级别默认>编辑允许
  • 建筑师>流日志级别默认>看法允许

要设置特定流程的历史执行数据级别:

  • 建筑师>流日志级别>添加允许
  • 建筑师>流日志级别>删除允许
  • 建筑师>流日志级别>编辑允许
  • 建筑师>流日志级别>看法允许

要查看流程的执行数据:

  • 建筑师>流程实例执行数据>编辑允许
  • 建筑师>流程实例执行数据>看法允许

Genesys Cloud 提供所有 Architect 流程类型的全面历史执行数据。 借助历史数据分析的高级功能,用户可以有效地管理和分析历史执行数据,并深入了解用户旅程以进行改进和排除故障。 用户可以启用或禁用执行数据存储,并从四个不同的执行数据粒度级别中进行选择:

  • 根据:理解通过 Architect 操作和导航菜单、错误和事件的高级用户旅程。
  • 笔记:优化建筑师使用变量值的流程(包括基础级别)。
  • 详细说明:使用权具有沟通价值的对话内容(包括注释级别)。
  • 全部:排除故障动作输入和输出值(包括详细注释级别)。

注释:
  • 根据 Genesys Cloud 公平使用政策,历史执行数据计入您组织的数据存储限制。 有关详细信息,请参阅For more information, see Genesys Cloud 合理使用政策
  • 默认情况下,执行数据存储是禁用的。 要开始捕获执行数据,您必须启用它并重新发布流程。

以下示例是可能出现的场景历史执行数据的消费者可以将执行数据用于以下用途:

  • 监听特定的流量事件,例如,当流程遇到错误时
  • 监视特定流程的事件并分析特定的流程执行项目,例如,当流程运行特定操作而该操作采用失败或超时路径时
  • 查看哪些流程比其他流程运行得更多

Genesys Cloud 默认禁用历史执行数据存储。 要启用存储,请按照以下步骤操作:

  1. 单击 管理员
  2. 在 “ 帐户设置” 下, 单击 组织设置。 
  3. 设置选项卡,向下滚动到执行数据部分。
  4. 在下面执行数据,使用切换按钮为您的组织启用执行数据存储。 出现一条免责声明消息,通知您 Genesys Cloud 可能会存储敏感信息。
  5. 点击是的以启用存储。

导航至行政>帐号设定>组织设置>设置建筑师, 点击帮助并选择执行数据设置

注释:
  • 您需要以下权限才能启用或禁用历史执行数据存储组织设置

    • 目录 > 组织 > 管理员
    • 设置>执行数据>编辑允许
    • 设置>执行数据>看法允许
  • 配置您想要存储执行数据的数据类型。如果建筑师流程已禁用,Genesys Cloud 不会存储执行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"
            }
        }
        

        注意: 下表仅包含有关示例数据的信息。

        姓名 类型 描述
        姓名 类型 描述
        流程:对话 ID 字符串 Genesys 云中对话的唯一标识符。 对话可能涉及多个流程或代理。
        flow: division: id 字符串
        流程执行完成后 Genesys Cloud 保存执行数据时,流程所处的划分。
        流程:结束日期时间 字符串
        流程执行完成的日期和时间。
        流程:执行 阵列 描述流程运行时发生的事情的流程执行项数组。
        流程:执行:已启动流程 对象 流程执行项目,描述流程的开始日期和时间以及流程运行时使用的语言。
        Flow: 执行:已启动的机器人状态 对象

        描述以下内容的流程执行项:

        • DateTime = 机器人状态出现的开始日期和时间。
        • executionID = 架构师执行标识符,用于唯一标识在执行架构师流程期间运行的机器人状态实例。
        • StateID = 架构师标识符,用于唯一标识架构师流程配置中的状态。
        Flow: 执行:ActionAskForIntent 对象

        保存 “询问意图” 操作的执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于唯一标识架构师流程配置中的 “询问意图” 操作。
        • DateTime = “询问意向” 操作开始的日期和时间。
        • executionId = “意向请求” 操作的执行标识符,用于唯一标识已运行的 “意向请求” 操作的执行实例。
        • outputPathID = 流程运行时 “询问意图” 操作所遵循的输出路径的标识符。
        • trackingID = Ask for Slot 操作的架构师追踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性在流程配置中唯一标识 “意向询问” 操作。
        流程:执行:ActionaskforSlot 对象

        保存 As k for Slot 操作执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于在架构师流程配置中唯一标识 Ask for Slot 操作。
        • 日期时间 = “询问时段” 操作开始的日期和时间。
        • executionID = Ask for Slot 操作的执行标识符,用于唯一标识已运行的 Ask for Slot 操作的执行实例。
        • outputPathID = 流程运行时 “询问时段” 操作所遵循的输出路径的标识符。
        • trackingID = “询问意图” 操作的架构师追踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性在流程配置中唯一标识 Ask for Slot 操作。
        流程:执行:行动决策 对象

        保存决策操作执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于在架构师流程配置中唯一标识决策操作。
        • 日期时间 = 决策操作开始的日期和时间。
        • executionID = 决策操作的执行标识符,用于唯一标识已运行的决策操作的执行实例。
        • outputPathID = 决策操作在流程运行时遵循的输出路径的标识符。
        • trackingID = 决策操作的架构师追踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性在流程的配置中唯一标识决策操作。
        流程:执行:操作通信 对象

        保存 “通信” 操作执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于唯一标识架构师流程配置中的通信操作。
        • 日期时间 = 通信操作开始的日期和时间。
        • executionID = 通信操作的执行标识符,用于唯一标识已运行的通信操作的执行实例。
        • trackingID = 沟通操作的架构师追踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 A ctionID 属性在流程配置中唯一标识通信操作。
        Flow: 执行:操作清除插槽 对象

        保存 Clea r Slot 操作执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于在架构师流程配置中唯一标识 Clear Slot 操作。
        • 日期时间 = “清除时段” 操作开始的日期和时间。
        • executionID = 清除时隙操作的执行标识符,用于唯一标识已运行的 “清除时段” 操作的执行实例。
        • trackingID = “清除时段” 操作的架构师追踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性在流程的配置中唯一标识 “清除插槽” 操作。
        Flow: Execution: actionLoop 其他任何东西 对象

        保存其他任何执行数据的流程执行项目? 循环操作

        • ActionID = 唯一标识还有什么?的架构师操作标识符 在 Architect 流程配置中循环操作。
        • DateTime = 其他任何事物的日期和时间? 循环操作已开始。
        • executionID = 还有其他的执行标识符? 唯一标识 “还有什么?” 的执行实例的循环操作? 已运行的循环操作。
        • outputPathID = 输出路径的标识符还有别的吗? 在流程运行时执行循环操作。
        • trackingID = 其他任何东西的建筑师追踪标识符? 循环操作。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性来唯一标识 “还有什么? 流程配置中的循环操作。
        Flow: Execution: ActionexitBot 对象

        保存 “退出机器人流程” 操作的执行数据的流程执行项目

        • ActionID = 架构师操作标识符,用于在架构师流程配置中唯一标识 “退出机器人流” 操作。
        • DateTime = 退出机器人流程操作开始的日期和时间。
        • executionId = 退出机器人流程操作的执行标识符,用于唯一标识已运行的退出机器人流程操作的执行实例。
        • trackingID = Exit Bot Flow 操作的架构师跟踪标识符。 在流程配置中,跟踪标识符可能不是唯一的。 使用 ActionID 属性在流程配置中唯一标识 “退出机器人流” 操作。
        Flow: 执行:endedBotState 对象

        一个流程执行项目,用于描述

        • DateTime = 机器人状态出现的结束日期和时间。
        流:执行:结束流 对象

        描述的流程执行项目

        • 日期时间 = 流量发生的日期和时间。
        • FlowExitReas on = 流程结束的原因。
        • 自然语言理解 = 流程结束时用于自然语言理解的数据。
        流程:执行 ID 字符串

        唯一标识符,用于标识已运行的架构师流程的唯一实例。

        流量:flowid 字符串

        架构师中流程的唯一标识符。

        流程:fl owisDebug 布尔值

        它指定执行的流程是否处于调试模式。

        流:流程名称 字符串

        运行的流程的名称。

        流量:流量类型 字符串

        运行的流程的架构师流程类型。

        Flow: flowV 字符串

        运行的流程的版本。

        流程:开始日期/时间 字符串

        流程开始执行的日期和时间。

        注释:
        • Genesys 云将历史流程执行数据存储 10 天。
        • Genesys Cloud 支持每个查询最多返回 200 个执行数据实例。 值得注意的是,Genesys Cloud 不能保证查询返回最近的 200 个执行实例。
        • Genesys Cloud 不存储运行时间超过三天的流程的历史执行数据。
        • 在呼叫流中,Genesys Cloud 仅报告前 4,500 个动作执行。
        • 由于通用模块流嵌入在其父流中且不能自行运行,因此您只能将其执行数据作为调用(父)流的历史执行数据的一部分来获取。
        • 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 – 最多 1,000 个字符
          • 字符串 – 最多 253 个字符
          • 集合数据类型 – 最多 20 个项目
        • Genesys Cloud 仅允许在基础级别报告安全流程执行实例的数据,例如在安全会话中运行的机器人流,无论您的组织的执行数据设置或特定的安全机器人流如何。
        • 无法按开始或结束日期时间查询流程实例的执行数据。 为了缩小响应范围,Genesys Cloud 建议您依赖 dialogueId。

        以下视频将引导您了解如何启用和配置历史执行数据。 视频还演示了如何使用各种数据设置进行高级故障排除。

        有关如何设置组织的执行数据级别或覆盖单个流程的组织范围的执行数据级别,请参阅管理历史执行数据

        《建筑师》中的功能

        使用 Architect 的流程执行历史记录来查看先前执行的流程的详细状态。 有关更多信息,请参阅流程执行历史记录
        使用 Architect 的查询生成器,根据流程的开始和结束方式或基于单个操作的执行标准,搜索符合不同条件的流程执行数据。 您还可以查看运行时将 Architect 操作的值解析为的设置。 有关更多信息,请参见生成流程执行历史记录查询和在查询生成器中管理查询
        使用 Architect 的重放模式回放 Architect 流程的流程实例数据以进行调试和故障排除。有关详细信息,请参阅For more information, see使用重放模式对 Architect 流程进行故障排除。 

        使用 Architect 的 Flow Insights 切换在 Architect 流程中以覆盖形式查看先前执行的流程组件的频率。有关详细信息,请参阅For more information, see使用 Flow Insights 查看执行流程组件的频率

        笔记:您无需为 Architect 流程启用执行数据存储即可使用 Flow Insights。

        历史执行数据可通过公共 API 和通知服务供第三方访问。 有关公共 API 中相关端点的更多信息,请参阅启动一个流程(作业),准备通过 Id 下载单个流程执行数据实例获取异步流程执行数据检索作业的状态和/或结果在 Genesys Cloud 开发人员中心。

        注释:
        • 不支持聚合数据,例如操作在流程期间运行的次数。
        • 您只能查看已发布流程的流程执行数据。 为确保捕获最新的执行数据,请确保在运行查询之前重新发布流程并通过该流程发送交互信息。