過去の実行データの概要
近日公開予定の機能: 履歴実行データ、フロー実行履歴、クエリビルダー、リプレイモード
前提条件
エッジおよびメディア層のバージョン:
- 1.0.0.15220 以降。 詳細については、メディア層リリースノート。
履歴実行データの保存を有効または無効にするには:
- ディレクトリ>組織>管理者
- 設定>実行データ>編集許可
- 設定>実行データ>ビュー許可
組織のフローの履歴実行データ レベルを設定するには:
- 建築家>フローのデフォルトログレベル>消去許可
- 建築家>フローのデフォルトログレベル>編集許可
- 建築家>フローのデフォルトログレベル>ビュー許可
特定のフローの履歴実行データ レベルを設定するには:
- 建築家>フローログレベル>追加許可
- 建築家>フローログレベル>消去許可
- 建築家>フローログレベル>編集許可
- 建築家>フローログレベル>ビュー許可
フローの実行データを表示するには:
- 建築家>フローインスタンス実行データ>編集許可
- 建築家>フローインスタンス実行データ>ビュー許可
Genesys Cloud は、すべての Architect フロー タイプの包括的な実行履歴データへのアクセスを提供します。 履歴データ分析の高度な機能により、ユーザーは履歴実行データを効果的に管理および分析し、ユーザー ジャーニーに関する洞察を得て、改善やトラブルシューティングを行うことができます。 ユーザーは実行データの保存を有効または無効にし、実行データの粒度を 4 つの異なるレベルから選択できます。
- ベース：理解するArchitect アクションとナビゲートされたメニュー、エラー、イベントを介した高レベルのユーザー ジャーニー。
- ノート：最適化する建築家変数値を使用したフロー（基本レベルを含む）。
- 詳細なメモ:アクセスコミュニケーション価値を持つ会話コンテンツ（Notes レベルを含む）。
- 全て：トラブルシューティングアクションの入力値と出力値 (Verbose Notes レベルを含む)。
メモ:
- 過去の実行データは、Genesys Cloud 公正使用ポリシーに基づいて組織のデータ ストレージ制限にカウントされます。 詳細については、 Genesys Cloud 公正使用ポリシー。
- 実行データの保存はデフォルトで無効になっています。 実行データのキャプチャを開始するには、それを有効にしてフローを再公開する必要があります。
以下の例は、考えられるシナリオである。履歴実行データの消費者は、実行データを次の目的で使用できます。
- フローがエラーに遭遇したときなど、特定のフローイベントをリッスンする
- 特定のフローのイベントを監視し、特定のフローの実行項目を分析します。たとえば、フローが特定のアクションを実行し、アクションが失敗またはタイムアウトの経路を取った場合などです。
- どのフローが他より多く流れているかを確認する
Genesys Cloud は、デフォルトで履歴実行データの保存を無効にします。 ストレージを有効にするには、次の手順に従います。
- 管理をクリックします。
- アカウント設定で、組織設定をクリックします。
- 上の設定タブを下にスクロールして実行データセクション。
- 下実行データ、トグルを使用して組織の実行データ ストレージを有効にします。 Genesys Cloud に機密情報が保存される可能性があることを通知する免責事項メッセージが表示されます。
- クリックはいストレージを有効にします。
移動するには管理者>アカウント設定>組織設定>設定から建築家、 クリックヘルプ選択して実行データ設定。
メモ： 構成、設定実行データを保存するデータ型。 もし建築家流れ無効の場合、Genesys Cloudは実行を保存しませんArchitect フローの tion データ。
実行履歴データを保存するデータ タイプを構成するには、次の手順に従います。
- 管理をクリックします。
- アカウント設定で、組織設定をクリックします。
- 上の設定タブを下にスクロールして実行データセクション。
- 下実行データ保存、 使用フローを設計する切り替えると、データ型の実行データ ストレージが有効になります。
移動するには管理者>アカウント設定>組織設定>設定から建築家、 クリックヘルプ選択して実行データ設定。
{
"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 | オブジェクト |
以下を説明するフロー実行項目:
|
| flow:execution:actionAskForIntent（フロー:実行:アクションAskForインテント | オブジェクト |
Ask for Intent アクション の実行データを保持するフロー実行項目：
|
| flow:execution:actionAskForスロット | オブジェクト |
Ask for Slot アクション の実行データを保持するフロー実行項目：
|
| フロー:実行:アクション決定 | オブジェクト |
決定アクション の実行データを保持するフロー実行項目：
|
| flow:execution:actionコミュニケーション | オブジェクト |
Communicate アクション の実行データを保持するフロー実行項目：
|
| flow:execution:actionクリアスロット | オブジェクト |
クリアスロットアクション の実行データを保持するフロー実行項目：
|
| flow:execution:actionLoopAnythingElse | オブジェクト |
|
| flow:execution:actionExitBotFlow（フロー:実行:アクションエグジットボットフロー | オブジェクト |
ボットフロー終了アクション の実行データを保持するフロー実行項目：
|
| フロー:実行:endedBotState | オブジェクト |
フロー実行項目。
|
| フロー:実行:終了フロー | オブジェクト |
を記述するフロー実行項目。
|
| 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 件のアクション実行のみを報告します。
- 以下のデータ型の値がGenesys Cloudが実行データに保存できるサイズ制限を超える場合、Genesys Cloudはレポートします。
値が大きすぎる:true:- JSON – 最大1,000文字
- 文字列 – 最大 253 文字
- コレクションデータの種類 – 最大 20 項目
- Genesys Cloud は現在、セキュア コール フローの実行データを報告しません。 Genesys Cloud では、組織の実行データ設定や特定のセキュア ボット フローに関係なく、セキュア フローの実行インスタンス (セキュア セッションで実行されたボット フローなど) についてのみ、ベース レベルでデータをレポートできます。
- フロー インスタンスの実行データを開始日時または終了日時で照会することはできません。 応答の範囲を絞り込むために、Genesys Cloud では、代わりに conversationId を使用することをお勧めします。
次のビデオでは、履歴実行データを有効にして構成する方法について説明します。 このビデオでは、高度なトラブルシューティングのためにさまざまなデータ設定を使用する方法も説明します。
アーキテクトの特徴
アーキテクトのクエリビルダを使用して、フローの開始方法と終了方法に基づいて、または個々のアクションの実行条件に基づいて、異なる条件を満たすフロー実行データを検索します。 また、実行時にアーキテクト・アクションの値が解決した設定を表示することもできます。 詳細については、Build a flow execution history query およびManage a query in Query Builder を参照してください。
アーキテクトのリプレイ・モードを使用して、ボットまたはデジタル・ボット・フローのフロー・インスタンス・データを再生し、デバッグとトラブルシューティングを行います。 詳細については、リプレイ・モードを使用したアーキテクト・フローのトラブルシューティング を参照してください。
Architect の Flow Insights を使用する切り替え Genesys Dialog Engine Bot FlowまたはGenesys Digital Bot Flowのフロー洞察オーバーレイとして、以前に実行されたアクションの頻度を表示します。 詳細については、「」を参照してください。 Flow Insights を使用して、実行されたボット フロー アクションの頻度を表示する。
過去の実行データはパブリックAPI経由で取得可能で、通知サービスサードパーティのアクセス用。 パブリックAPIの関連エンドポイントの詳細については、以下を参照してください。 ID による単一フロー実行データ インスタンスのダウンロードを準備するプロセス (ジョブ) を開始します。そして非同期フロー実行データ取得ジョブのステータスおよび/または結果を取得します。 Genesys Cloud 開発者センターで。
メモ:
- フロー中にアクションが実行された回数などの集計データはサポートされていません。
- フロー実行データを表示できるのは、公開されているフローのみです。 最新の実行データを確実に取得するには、クエリーを実行する前にフローを再パブリッシュし、そのフローを通じてインタラクションを送信するようにしてください。
