历史执行数据概览
必备
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 默认禁用历史执行数据存储。 要启用存储，请按照以下步骤操作：
- 单击 管理员。
- 在 “ 帐户设置” 下， 单击 组织设置。
- 点击菜单>帐户>组织设置。
- 在设置选项卡，向下滚动到执行数据部分。
- 在下面执行数据，使用切换按钮为您的组织启用执行数据存储。 出现一条免责声明消息，通知您 Genesys Cloud 可能会存储敏感信息。
- 点击是的以启用存储。
导航至行政>帐户设置>组织设置>设置从建筑师菜单>帐户>组织设置>设置， 点击帮助并选择执行数据设置。
注释：
-
您需要以下权限才能启用或禁用历史执行数据存储组织设置：
- 目录 > 组织 > 管理员
- 设置>执行数据>编辑允许
- 设置>执行数据>看法允许
- 配置您想要存储执行数据的数据类型。如果建筑师流程已禁用，Genesys Cloud 不会存储执行Architect 流程的数据。
要配置存储历史执行数据的数据类型，请按照以下步骤操作：
- 单击 管理员。
- 在 “ 帐户设置” 下， 单击 组织设置。
- 点击菜单>帐户>组织。
- 在设置选项卡，向下滚动到执行数据部分。
- 在下面执行数据存储， 使用架构流程切换以启用该数据类型的执行数据存储。
导航至行政>帐户设置>组织设置>设置菜单>帐户>组织>设置从建筑师， 点击帮助并选择执行数据设置。
注意：
您需要以下权限才能查看和启用架构流程切换至组织设置：
- 建筑师>流程实例执行数据>编辑允许
- 建筑师>流程实例执行数据>看法允许
{
"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: 执行：已启动的机器人状态 | 对象 |
描述以下内容的流程执行项：
|
| Flow: 执行：ActionAskForIntent | 对象 |
保存 “询问意图” 操作的执行数据的流程执行项目：
|
| 流程：执行：ActionaskforSlot | 对象 |
保存 As k for Slot 操作执行数据的流程执行项目：
|
| 流程：执行：行动决策 | 对象 |
|
| 流程：执行：操作通信 | 对象 |
保存 “通信” 操作执行数据的流程执行项目：
|
| Flow: 执行:操作清除插槽 | 对象 |
保存 Clea r Slot 操作执行数据的流程执行项目：
|
| Flow: Execution: actionLoop 其他任何东西 | 对象 |
保存其他任何执行数据的流程执行项目？ 循环操作：
|
| Flow: Execution: ActionexitBot | 对象 |
|
| Flow: 执行:endedBotState | 对象 |
一个流程执行项目，用于描述
|
| 流:执行:结束流 | 对象 |
描述的流程执行项目
|
| 流程:执行 ID | 字符串 |
唯一标识符，用于标识已运行的架构师流程的唯一实例。 |
| 流量:flowid | 字符串 |
架构师中流程的唯一标识符。 |
| 流程：fl owisDebug | 布尔值 |
它指定执行的流程是否处于调试模式。 |
| 流:流程名称 | 字符串 |
运行的流程的名称。 |
| 流量:流量类型 | 字符串 |
运行的流程的架构师流程类型。 |
| flow:flowVersion | 字符串 |
运行的流程的版本。 |
| 流程：开始日期/时间 | 字符串 |
流程开始执行的日期和时间。 |
注释：
- Genesys 云将历史流程执行数据存储 10 天。
- Genesys Cloud 支持每个查询最多返回 200 个执行数据实例。 值得注意的是，Genesys Cloud 不能保证查询返回最近的 200 个执行实例。
- Genesys Cloud 不存储运行时间超过三天的流程的历史执行数据。
- 在呼叫流中，Genesys Cloud 仅报告前 4,500 个动作执行。
- 如果呼叫流程有超过 350 个变量，Genesys 仅在基本日志级别记录执行数据。
- 由于通用模块流嵌入在其父流中且不能自行运行，因此您只能将其执行数据作为调用（父）流的历史执行数据的一部分来获取。
- 如果以下数据类型的值超出了 Genesys Cloud 可以在执行数据中存储的大小限制，Genesys Cloud 会报告
valueIsTooLarge:true：- JSON – 最多 1,000 个字符
- 字符串 – 最多 253 个字符
- 集合数据类型 – 最多 20 个项目
- Genesys Cloud 仅允许在基础级别报告安全流程执行实例的数据，例如在安全会话中运行的机器人流，无论您的组织的执行数据设置或特定的安全机器人流如何。
- 无法按开始或结束日期时间查询流程实例的执行数据。 为了缩小响应范围，Genesys Cloud 建议您依赖 dialogueId。
以下视频将引导您了解如何启用和配置历史执行数据。 视频还演示了如何使用各种数据设置进行高级故障排除。
有关如何设置组织的执行数据级别或覆盖单个流程的组织范围的执行数据级别，请参阅管理历史执行数据。
《建筑师》中的功能
使用 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 开发人员中心。
注释：
- 不支持聚合数据，例如操作在流程期间运行的次数。
- 您只能查看已发布流程的流程执行数据。 为确保捕获最新的执行数据，请确保在运行查询之前重新发布流程并通过该流程发送交互信息。
