再生モードを使用してArchitectフローのトラブルシューティングを行う

前提条件
  • 建築家 > フローインスタンス > ビュー 許可
  • 建築家>フローインスタンス>検索許可

再生モードでは、フローの実行時に何が起こったかを確認し、トラブルシューティングやデバッグを行うことができます。

ノート:
  • フローが再生モードの場合、編集することはできません。
  • リプレイモードでサポートされるフロータイプの詳細については、以下を参照してください。過去の実行データの概要。 

画像をクリックして拡大します。 リプレイモード

建築家リプレイモード

  1. Architectホームページで、をクリックするか、 流れ メニューを選択して、希望のフロータイプを選択します。
  2. 以前実行し、デバッグとトラブルシューティングを行うフローを開きます。フローの設定ページが開きます。
  3. もしフローが読み取り専用モードで開くので、実行履歴。
  4. フローが編集モードで開かれる場合は、の横にある下矢印をなめる保存そして次のいずれかの手順を実行します。
    • フローの以前のバージョンの実行履歴を表示するには、実行履歴リストから。
    • 読み取り専用モードに入るには、次のいずれかのオプションを選択します。
      • 進行中の作業をフローの新しいバージョンとして保存するには、チェックインクリックします実行履歴。
      • フローを以前のバージョンに戻すには、元に戻すクリックします実行履歴。
  5. フロー実行履歴の結果リストから、再生するフロー インスタンスをクリックします。 フロー インスタンスが再生モードで開きます。
    画像をクリックして拡大します。 リプレイモードでのフロー実行履歴

ビジュアルツアーについては、次のビデオをご覧ください。

リプレイ モードの機能について詳しくは、次のセクションを確認してください。

フロー インスタンスをデバッグするには、再生コントロールを使用して、ページの下部にある再生タイムライン内のフロー実行項目 (アクション、タスク、またはメニュー) 間を移動します。 コントロールフロー実行履歴の任意のポイントに移動できます。 再生アクションは、ツールバーおよびカスタマイズ可能なキーボード ショートカットから利用できます。 デフォルトのキーボードショートカットを変更するには、環境設定。

リプレイコントロール

再生コマンド 説明 キーボード ショートカット
再生または一時停止

フロー インスタンスを最初から最後まで再生するか、再生を一時停止します。再生速度を選択するには、適切な速度を選択します。選択できるのは速い、デフォルト、 そして遅い。

 メモ：   すでにいくつかの項目をステップ実行している場合は、再生コマンド現在実行中のフロー実行項目から最後まで、またはブレークポイントが存在する場合は次のブレークポイントまで再生します。

 コントロール + F7
介入する  次のフロー実行項目に進み、入力して、実行をステップごとに追跡します。 F11 キー
ステップオーバー 次のフロー実行項目に進み、コンポーネント ステップを表示せずにその実行を追跡します。 F10 キー
踏みでる フロー実行項目内では、残りのコンポーネント ステップを 1 つのステップとして完了し、次のフロー実行項目に進みます。 F9 キー
戻る  前のフロー実行項目に戻って入力し、その実行をステップごとに追跡します。 コントロール + F11
一歩後ろに下がる 前のフロー実行項目に戻り、コンポーネント ステップを表示せずにその実行を追跡します。 ブレークポイントに到達すると実行の再生は停止します。 コントロール + F10
一歩踏み出す フロー実行項目内から前のフロー実行項目に戻ります。 コントロール + F9
最後までプレイ  次のブレークポイントまで、または最後までフロー実行の再生を再開します。 コントロール + F6

開始位置まで逆再生

フローの始めまで逆再生するブレークポイントが存在する場合は、前のブレークポイント。 コントロール + F4
ブレークポイントを設定またはクリアする フロー実行の再生を停止する場所にブレークポイントを挿入します。 以前に設定したブレークポイントを削除します。  
実行項目を選択 実行項目間を移動するには、上矢印と下矢印を使用します。  

ページの下部にある再生モードのタイムライン タブでは、すべてのフロー実行項目を検査およびデバッグし、項目間を移動できます。 次のリプレイアクションが利用可能です:

    • 検査するフロー実行項目 (フロー開始、アクション、タスク、メニュー、またはフロー終了) をクリックします。 Architect はフロー実行項目を再生モードで表示し、エディターまたはデザイン領域で紫色で強調表示します。 リプレイ コントロールを使用してアイテム間を移動することもできます。 詳細については、リプレイコントロールを使用する。

      画像をクリックして拡大します。

      実行項目を強調表示

    • 検査するフロー実行項目にマウスを置きます。 Architect は、検査する実行項目に応じてさまざまな情報を表示します。
      • フロー開始: Architect は、フロー実行 ID、フローの開始言語、およびフローの開始時刻を表示します。 フロー実行 ID は、実行されたフローのインスタンスを識別するために Architect が使用する一意の識別子です。 Architect は、フローが安全なセッションで実行されたかどうか、または 4,500 を超えるアクションが含まれていたためにフローが切り捨てられたかどうかも表示します。フローインスタンスは安全です
      • フロー終了: Architect はフロー終了時刻と終了理由を表示します。
      • その他の実行項目の場合、Architect は、フローによって実行されたアクションの名前とタイプ、実行時間と実行 ID、スタック実行 ID、フローがたどった出力パス、およびアクション ID を表示します。スタック実行IDは、フローの実行スタック内の実行項目の位置を示す一意の識別子です。 。 この情報のほとんどはクリップボードにコピーできます。 クリックコピーする。

        画像をクリックして拡大します。リプレイモードのタイムライン

    • フロー実行履歴ダイアログボックスを開くには、実行履歴。ダイアログボックスでは、クエリビルダーデフォルトでは、現在表示しているフロー インスタンスのフロー ID と一致するフロー ID を持つフロー インスタンスのリストが表示されます。フロー エラー コード、フロー警告コード、呼び出しフロー オブジェクト実行 ID、フロー呼び出しエラーなどの他のフロー基準に基づいてクエリを実行できます。会話 ID で履歴データをクエリすることもできます。これは、同じ会話ベースのフローのインスタンスが多数ある場合に便利です。フロー実行クエリの構築の詳細については、以下を参照してください。フロー実行履歴クエリを構築する。 
    • 再生モードで表示しているフローを呼び出したフローを開くには、呼び出しフローを開く。このオプションは、呼び出しフローの履歴実行データが利用可能な場合にのみ使用できます。Architect が呼び出しフローに対して表示するデータの量は、Genesys Cloud が呼び出しフローを記録した実行データのレベルによって異なります。サポートされるデータ型はフロー タイプによって異なります。たとえば、Genesys Cloud がフローを記録した実行データ レベルに通常そのようなデータが含まれているかどうかに関係なく、受信メッセージ フローを再生するときに通信データは表示されません。 フロータイプではデータがサポートされていません
    • 表示または非表示にするにはスタックグラフ、 クリック。
    • タイムラインのズームレベルをズームなしからズームありに調整するには小、中、そして満杯ズームするには、ズーム落ちる。
    • キーボードショートカットを変更したり、再生モードの表示をカスタマイズするには、 環境設定。

    様々なタイプの情報検索フローフィールドで:
    • 建築家GUID
    • 特定のアクション、メニュー、状態、またはタスク
    • 変数 

    アクションIDを検索

    様々な検索を絞り込むための演算子。 検索演算子を選択するには、次のいずれかの演算子を選択します。

    • 含まれるもの= Architectは、cのすべての検索結果を返します指定した文字がすべて含まれます。
    • ちょうど= Architectは、mのすべての検索結果を返します指定した文字を正確にキャッチします。
    • 始まりは= Architectは、指定した文字で始まります。

    のデータパネルにはデータフロー変数が表示されます戻った流れが流れるにつれて、そのデータ型とともに。データパネルの例

    メモ: 
    • Architect displays arrow buttons next to variables whose value changes during flow execution. See the string type variable named Slot.FamilySize in the attached example.
    • You can set a breakpoint on such variables. To set a breakpoint, click the button that indicates the data type of the variable and select Set a breakpoint. For Slot.FamilySize, the letter A that precedes the variable name.
    • If the value of a variable of the JSON, string or collection data type exceeds the size limit that Genesys Cloud can store in execution data, Architect displays ValueTooLarge. Because encrypted values can be very long, Architect often shows values of variables used in Set Secured Data actions as ValueTooLarge.  
    • For variable values in secure flows (because Genesys only reports execution data for such flows at the Base level) and values of variables used in Architect actions for secured or encrypted data, Architect displays ValueRedacted.
    • Architects displays ValueInvalid for variables whose value was, for example, set by an expression or function that failed. For example, if a string value to be converted to a DateTime type was invalid, as in ToDateTime("2009-01-10T06:30:"). 

    のコミュニケーションパネル簡単に見ることができるフロー実行時に発生した通信スレッド全体。 すべての通信を表示するか、現在選択されているフロー実行項目に関連する通信のみを表示するようにパネルを構成できます。

    のコミュニケーションパネルでは、フローと外部参加者。 例えば、顧客とチャットボット間のメッセージ交換。

    画像をクリックして拡大します。

    コミュニケーションパネルの例

    のスタックペインlフローの実行スタック内の現在の実行項目とそのタイムスタンプを表示します。 現在のフロー実行項目が実行スタック内でどの程度深くネストされているかを確認するには、オンにしますスタックグラフ。
    のフレームの詳細パネルには、選択したアクションまたはメニュー、または実行項目の詳細が表示されます。あなたは現在リプレイセッション中:の名前およびタイプののアクション、またはそれが実行されたとき。 例えば、詳細決断次の例のアクション:フレームの詳細例 

    使用ドラッグハンドルにパネルをつかんでそれを移動パネルを横に表示するか下に表示するかに応じて、パネルのリスト内で上、下、または横に移動します。リプレイモードでパネルを移動する

    フローのデフォルト言語とサポートされている言語を切り替えるには、の横にある下矢印言語フィルター表示する言語を選択します。

    リプレイモードでサポートされている言語を切り替える

    要素 ID を操作するには、次のいずれかの手順に従います。

    • 要素識別番号を表示または非表示にするには、アクション、メニュー、タスク、状態IDを表示または非表示にする。
    • 特定の要素に移動するには、ダウンメニューから「移動」を選択し、適切な ID を選択します。

    現在のフローを参照および使用するフローを検索するには、消費フローを見つける。

    再生中のフローインスタンスにセキュアデータが含まれている場合、Architectはキーアイコンアイコン。 安全なデータを参照する実行項目を検索するには、アイコンをクリックします。

    フローには安全なデータが含まれています

    実行インスタンスを再生すると、安全なコールフローによって呼び出されたボットフローの場合、Architect は再生されたフローインスタンスが安全であることを示すロックアイコンを表示します。セキュアフローインスタンス

    Architect には、Genesys Cloud がフロー インスタンスの履歴データを保存するために使用した実行データ レベルが表示されます。

    次の例では、Genesys Cloudがフロー実行時に実行データをキャプチャしたことがわかります。ベースレベル。 したがって、ユーザーは変数値データや通信データにアクセスできません。

    実行データレベルインジケーター

    基本レベルのデータ

    過去の実行データとデータ設定の詳細については、以下を参照してください。過去の実行データの概要、フローレベルで実行データを管理する、 そして過去の実行データを管理する。

    フロー実行データまたは構成データをエクスポートするには、輸出次のいずれかのオプションをクリックします。

    • 実行データのエクスポート
    • .i3xxx としてエクスポート
    • .yaml としてエクスポート

    キーボード ショートカットをカスタマイズするには、次の手順を実行します。
    1. クリック 設定。[環境設定] ダイアログ ボックスが表示されます。
    2. 選択するキーボードショートカット。
    3. 使用既存のショートカットを検索するための検索フィールド。
    4. 使用フィルター条件表示されるキーボードショートカットのリストを絞り込むフィールド:
      • フロー内でアクションを実行するために使用できるキーボードショートカットを表示するには、流れ。
      • 開くために使用できるキーボードショートカットを表示するにはキーボードショートカット表示または切り替える表現のヘルプ表示、選択グローバル。
      • 再生コマンドに使用できるキーボードショートカットを表示するには、リプレイ。
    5. ショートカットをインポートするには、 。
    6. ショートカットをエクスポートするには、 。
    7. デフォルトのキーボードショートカットを復元するには、既定値にリセット。
    8. (オプション) 任意のショートカットに対してプライマリおよびセカンダリのキーストロークを定義できます。
    9. クリック保存変更を保存するか、キャンセルそれらを破棄します。

    再生モード ビューをカスタマイズするには、次の手順を実行します。

    1. クリック 設定。[環境設定] ダイアログ ボックスが表示されます。
    2. 選択するリプレイモード。
    3. クリックローカルの値を表示フローが実行されたローカル言語で標準的に使用される値の表示形式を使用します。 たとえば、現地の言語がドイツ語、または ISO-8601 の代わりにローカルの日付と時刻の表示形式を使用して、日付と時刻に関連するデータを通信します。
    4. クリックスタックグラフを表示フローが通過したスタックのレベルを示すグラフを表示します。
    5. 優先するタイムラインのズームレベルドロップダウンから選択します。可能な値はズームオフ、ズーム小、ズーム ミディアム、ズームフル。
    6. からデータドロップダウンで、パネルを表示するかどうかを選択し、表示する場合は下部に表示するか側面に表示するかを選択します。
    7. 最初からコミュニケーションドロップダウンで、パネルを表示するかどうかを選択し、表示する場合は下部に表示するか側面に表示するかを選択します。
    8. 2番目からコミュニケーションドロップダウンで、すべてのフレームの通信を表示するか、現在のフレームの通信のみを表示するかを選択します。
    9. からスタックドロップダウンで、パネルを表示するかどうかを選択し、表示する場合は下部に表示するか側面に表示するかを選択します。
    10. からフレームの詳細ドロップダウンで、パネルを表示するかどうかを選択し、表示する場合は下部に表示するか側面に表示するかを選択します。

      リプレイモードの設定

      詳細については、リプレイコントロールを使用する。