過去のフロー実行データの概要
近日公開予定の機能:
Genesys Cloud により、顧客はフロー実行履歴データにアクセスできるようになります。 実行履歴データは、以前のフローのパフォーマンスについてのより詳細な洞察を得るのに役立ちます。 データを使用してフローの最適化、デバッグ、トラブルシューティングを行い、ユーザー ジャーニーの高度な理解を得ることができます。
以下の例は、過去のフロー実行データの消費者が実行データを使用できる可能性のあるシナリオである：
- フローがエラーに遭遇したときなど、特定のフローイベントをリッスンする
- 特定のフローのイベントを監視し、特定のフローの実行項目を分析します。たとえば、フローが特定のアクションを実行し、アクションが失敗またはタイムアウトの経路を取った場合などです。
- どのフローが他より多く流れているかを確認する
Genesys Cloudは、以下のフロータイプの履歴フロー実行データを提供します：
{
"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は、1フローあたり最大50回の実行履歴データを保存します。 これはローリング制限なので、フローの51番目の実行を作成すると、Genesys Cloudはフローの最も古い実行データを削除します。
- Genesys Cloudは、3日間を超えるフローの実行履歴データを保存しません。
- 現在、開始日または終了日時にフロー インスタンスの実行データをクエリすることはできません。 応答の範囲を狭めるために、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クラウド開発者センター内。
メモ:
- フロー中にアクションが実行された回数などの集計データはサポートされていません。
- セキュア変数に保存したデータは、検索できません。 アーキテクトは、セキュアなデータを再編集します。
- フロー実行データを表示できるのは、公開されているフローのみです。 最新の実行データを確実に取得するには、クエリーを実行する前にフローを再パブリッシュし、そのフローを通じてインタラクションを送信するようにしてください。
