過去の実行データの概要

前提条件

エッジおよびメディア層のバージョン:

1.0.0.15220 以降。詳細については、メディア層リリースノート。

履歴実行データの保存を有効または無効にするには:

ディレクトリ>組織>管理者
設定>実行データ>編集許可
設定>実行データ>ビュー許可

組織のフローの履歴実行データレベルを設定するには:

建築家>フローログレベルのデフォルト>消去許可
建築家>フローログレベルのデフォルト>編集許可
建築家>フローログレベルのデフォルト>ビュー許可

特定のフローの履歴実行データレベルを設定するには:

建築家>フローログレベル>追加許可
建築家>フローログレベル>消去許可
建築家>フローログレベル>編集許可
建築家>フローログレベル>ビュー許可

フローの実行データを表示するには:

建築家>フローインスタンス実行データ>編集許可
建築家>フローインスタンス実行データ>ビュー許可

Genesys Cloud は、すべての Architect フロータイプの包括的な実行履歴データへのアクセスを提供します。履歴データ分析の高度な機能により、ユーザーは履歴実行データを効果的に管理および分析し、ユーザージャーニーに関する洞察を得て、改善やトラブルシューティングを行うことができます。ユーザーは実行データの保存を有効または無効にし、実行データの粒度を 4 つの異なるレベルから選択できます。

ベース：理解するArchitect アクションとナビゲートされたメニュー、エラー、イベントを介した高レベルのユーザージャーニー。
ノート：最適化する建築家変数値を使用したフロー（基本レベルを含む）。
詳細なメモ:アクセスコミュニケーション価値を持つ会話コンテンツ（Notes レベルを含む）。
全て：トラブルシューティングアクションの入力値と出力値 (Verbose Notes レベルを含む)。

メモ:

過去の実行データは、Genesys Cloud 公正使用ポリシーに基づいて組織のデータストレージ制限にカウントされます。詳細については、 Genesys Cloud 公正使用ポリシー。
実行データの保存はデフォルトで無効になっています。実行データのキャプチャを開始するには、それを有効にしてフローを再公開する必要があります。

以下の例は、考えられるシナリオである。履歴実行データの消費者は、実行データを次の目的で使用できます。

フローがエラーに遭遇したときなど、特定のフローイベントをリッスンする
特定のフローのイベントを監視し、特定のフローの実行項目を分析します。たとえば、フローが特定のアクションを実行し、アクションが失敗またはタイムアウトの経路を取った場合などです。
どのフローが他より多く流れているかを確認する

実行データの保存を有効にする

Genesys Cloud は、デフォルトで履歴実行データの保存を無効にします。ストレージを有効にするには、次の手順に従います。

管理をクリックします。
アカウント設定で、組織設定をクリックします。
上の設定タブを下にスクロールして実行データセクション。
下実行データ、トグルを使用して組織の実行データストレージを有効にします。 Genesys Cloud に機密情報が保存される可能性があることを通知する免責事項メッセージが表示されます。
クリックはいストレージを有効にします。

移動するには管理者>アカウント設定>組織設定>設定から建築家、クリックヘルプ選択して実行データ設定。

メモ:

履歴実行データの保存を有効または無効にするには、次の権限が必要です。組織設定:
- ディレクトリ>組織>管理者
- 設定>実行データ>編集許可
- 設定>実行データ>ビュー許可
構成、設定実行データを保存するデータ型。もし建築家流れ無効の場合、Genesys Cloudは実行を保存しませんArchitect フローの tion データ。

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

メモ： 以下の表はサンプルデータのみの情報です。

名前	タイプ	説明
名前	タイプ	説明
フロー:conversationId	文字列	ジェネシス・クラウドにおける会話の一意の識別子。会話は複数のフローやエージェントを含むことができる。
フロー:部門:ID	文字列	フローの実行が完了した後、Genesys Cloudが実行データを保存するときにフローがいる部門。
フロー:終了日時	文字列	フロー実行が完了した日時。
フロー：実行	配列	フローが実行されたときに何が起こったかを記述するフロー実行項目の配列。
フロー:実行:開始フロー	オブジェクト	フローの開始日時、およびフローが実行された言語を記述するフロー実行項目。
フロー:実行:startedBotState	オブジェクト	以下を説明するフロー実行項目: dateTime = ボット状態が発生した開始日時。 executionId = アーキテクトフローの実行中に実行されたボット状態のインスタンスを一意に識別するアーキテクト実行識別子。 stateId = アーキテクトフローの構成内で状態を一意に識別するアーキテクト識別子。
flow:execution:actionAskForIntent（フロー:実行:アクションAskForインテント	オブジェクト	Ask for Intent アクションの実行データを保持するフロー実行項目： actionId = アーキテクトフロー構成内で、Ask for Intentアクションを一意に識別するアーキテクトアクション識別子。 dateTime = Ask for Intentアクションが開始した日時。 executionId =実行されたAsk for Intentアクションの実行インスタンスを一意に識別する、Ask for Intentアクションの実行識別子。 outputPathId = フロー実行時にAsk for Intentアクションがたどった出力パスの識別子。 trackingId = スロットを問い合わせるアクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フロー構成内の Ask for Intent アクションを一意に識別する。
flow:execution:actionAskForスロット	オブジェクト	Ask for Slot アクションの実行データを保持するフロー実行項目： actionId = アーキテクトフロー構成内でAsk for Slotアクションを一意に識別するアーキテクトアクション識別子。 dateTime = スロットの問い合わせアクションが開始された日時。 executionId =実行されたAsk for Slotアクションの実行インスタンスを一意に識別するAsk for Slotアクションの実行識別子。 outputPathId = フロー実行時にAsk for Slotアクションがたどった出力パスの識別子。 trackingId = Ask for Intentアクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フロー構成内の Ask for Slot アクションを一意に識別します。
フロー:実行:アクション決定	オブジェクト	決定アクションの実行データを保持するフロー実行項目： actionId = アーキテクトフロー構成内で決定アクションを一意に識別するアーキテクトアクション識別子。 dateTime = デシジョンアクションが開始した日時。 executionId =実行されたDecisionアクションの実行インスタンスを一意に識別する、 Decisionアクションの実行識別子。 outputPathId = フロー実行時に決定アクションがたどった出力パスの識別子。 trackingId = デシジョンアクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フロー構成内の決定アクションを一意に特定する。
flow:execution:actionコミュニケーション	オブジェクト	Communicate アクションの実行データを保持するフロー実行項目： actionId = アーキテクトのアクション識別子で、アーキテクトフロー構成内でコミュニケートアクションを一意に識別します。 dateTime = Communicateアクションが開始された日時。 executionId =実行されたCommunicateアクションの実行インスタンスを一意に識別するCommunicateアクションの実行識別子。 trackingId = Communicateアクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フロー構成内の Communicate アクションを一意に識別します。
flow:execution:actionクリアスロット	オブジェクト	クリアスロットアクションの実行データを保持するフロー実行項目： actionId = アーキテクトフロー構成内でクリアスロットアクションを一意に識別するアーキテクトアクション識別子。 dateTime = クリアスロットアクションが開始された日時。 executionId =実行されたクリアスロットアクションの実行インスタンスを一意に識別するクリアスロットアクションの実行識別子。 trackingId = スロットクリアアクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フロー構成内のクリアスロットアクションを一意に識別します。
flow:execution:actionLoopAnythingElse	オブジェクト	他に何か？ループアクション： actionId = Anything Else? アーキテクトフロー設定内でのループ動作。 dateTime = Anything Else? ループアクションが始まった。 executionId =Anything Else? の実行インスタンスを一意に識別するループアクション。実行されたループアクション。 outputPathId = Anything Else? フロー実行時に続くループアクション。 trackingId = Anything Else? ループアクション。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、Anything Else? フローのコンフィギュレーションにあるループアクション。
flow:execution:actionExitBotFlow（フロー:実行:アクションエグジットボットフロー	オブジェクト	ボットフロー終了アクションの実行データを保持するフロー実行項目： actionId = アーキテクトフロー設定内でボットフローの終了アクションを一意に識別するアーキテクトアクション識別子。 dateTime = ボットフローの終了アクションが開始された日時。 executionId =実行されたボットフロー終了アクションの実行インスタンスを一意に識別する、ボットフロー終了アクションの実行識別子。 trackingId = ボットフロー終了アクションのアーキテクトトラッキング識別子。トラッキング識別子は、フロー・コンフィギュレーション内で一意ではないかもしれない。 actionId プロパティを使用して、フローの構成でボットフローを終了するアクションを一意に識別します。
フロー:実行:endedBotState	オブジェクト	フロー実行項目。 dateTime = ボット状態が発生した終了日時。
フロー:実行:終了フロー	オブジェクト	を記述するフロー実行項目。 dateTime = フローが発生した日時。 flowExitReason =フローが終了した理由。 naturalLanguageUnderstanding = フローが終了したときの自然言語理解のためのデータ。
flow:executionId	文字列	実行されたアーキテクトフローの一意のインスタンスを識別する一意の識別子。
flow:flowId	文字列	Architectにおけるフローの一意な識別子。
flow:flowIsDebug	ブール型	実行されたフローがデバッグモードであったかどうかを指定する。
flow:flowName（フロー名	文字列	走った流れの名前。
flow:flowType（フロータイプ	文字列	実行されたフローのアーキテクトフロータイプ。
flow:フローバージョン	文字列	実行されたフローのバージョン。
フロー:開始日時	文字列	フローの実行が開始された日時。

メモ:

Genesys Cloudは、過去のフロー実行データを10日間保存します。
Genesys Cloud は、クエリごとに最大 200 個の実行データインスタンスを返すことをサポートしています。 Genesys Cloud では、クエリが最新の 200 件の実行インスタンスを返すことを保証できないことに注意してください。
Genesys Cloudは、3日間を超えるフローの実行履歴データを保存しません。
コールフローでは、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 では、代わりに conversationId を使用することをお勧めします。

次のビデオでは、履歴実行データを有効にして構成する方法について説明します。このビデオでは、高度なトラブルシューティングのためにさまざまなデータ設定を使用する方法も説明します。

詳細については、組織の実行データレベルを設定するか、個々のフローの組織全体の実行データレベルを上書きするには、過去の実行データを管理する。

注記:Flow Insights を使用するには、Architect フローの実行データストレージを有効にする必要はありません。

過去の実行データはパブリックAPI経由で取得可能で、通知サービスサードパーティのアクセス用。パブリックAPIの関連エンドポイントの詳細については、以下を参照してください。 ID による単一フロー実行データインスタンスのダウンロードを準備するプロセス (ジョブ) を開始します。そして非同期フロー実行データ取得ジョブのステータスおよび/または結果を取得します。 Genesys Cloud 開発者センターで。

メモ:

フロー中にアクションが実行された回数などの集計データはサポートされていません。
フロー実行データを表示できるのは、公開されているフローのみです。最新の実行データを確実に取得するには、クエリーを実行する前にフローを再パブリッシュし、そのフローを通じてインタラクションを送信するようにしてください。

過去の実行データの概要

実行データの保存を有効にする

Architectフローのデータストレージを有効にする

過去のフロー実行データ例

アーキテクトの特徴

フロー実行履歴

クエリービルダー

リプレイ・モード