会話履歴ツールは、エージェントとエンドユーザーの間の実際の本番環境での会話を閲覧および分析するためのインターフェースを提供します。これは、エージェントの機能パフォーマンスの評価や問題のデバッグに役立ちます。
フローとページの分析は、エージェントのフローグラフを使用してトラフィックとエスカレーションを理解するのに役立ちます。これにより、エージェント ビルダーはトラフィック フロー（高トラフィック パスと低トラフィック パス）を分析し、問題があるホットスポットを検出して（たとえば、エスカレーションの上位を特定する）、問題の原因となった特定のページやインテントにドリルダウンできます。フローとページの分析を会話の履歴フィルタとともに使用すると、トラフィックの関連するサブセットを柔軟に調べることができます。
制限事項
大規模なエージェントの場合、[Flow Analysis Table] ビューと [Flow Analysis Graph] ビューの読み込みが遅くなることがあります。読み込み時間を短縮するには、インテント フィルタと 1 週間の期間を使用します。
会話ごとに最大 500 ターンがログに記録されます。
必要な権限
このツールを使用するには、dialogflow.conversations 権限が必要です。この権限は、カスタムロールに追加できます。管理者のロールや他の Dialogflow ロールでも使用できます。
会話履歴を有効または無効にする
会話履歴ツールは、インタラクション ログのデータを使用します。インタラクション ロギングを有効にするエージェント設定で、会話履歴を有効または無効にできます。
retention_window_days セキュリティ設定を使用して、データの保持期間を制御することもできます。
会話の履歴を参照する
会話履歴ツールを使用するには:
- Dialogflow CX Console を開きます。
- プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [会話の履歴] をクリックします。
- 会話が表形式で表示されます。
- 必要に応じて、表の上にある [フィルタ] コントロールを使用してフィルタを適用します。
- いずれかのタブを選択します。各タブについては、このドキュメントの後半で説明します。
会話の履歴を CSV ファイルにダウンロードする
- Dialogflow CX Console を開きます。
- プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [会話の履歴] をクリックします。
- 会話セッションがテーブルに一覧表示されます。
会話セッションを選択し、[プレビュー パネルで会話を開く] ボタンをクリックします。
![[プレビューを開く] ボタンのスクリーンショット](https://cloud.google.com/static/dialogflow/cx/docs/images/open-preview.png?authuser=5&hl=ja)
[すべての会話をエクスポート] をクリックします。会話を含む CSV ファイルがパソコンに自動的にダウンロードされます。ダウンロードできる会話の最大数は 50 です。選択した会話セッション内の会話数が 50 を超える場合、ダウンロードは失敗します。
会話
会話は、会話の概要ビューと会話の詳細ビューの 2 つのビューに表示されます。
会話の概要ビュー
会話のサマリービューには、すべての会話が一覧表示されます。会話ごとに次のメタデータが提供されます。
| X | 項目 |
|---|---|
| 会話 ID | 会話の識別子 |
| Duration | やり取りの期間 |
| ターン | 会話ターンの数 |
| チャネル | チャット（テキスト）、音声、不明（会話へのエンドユーザー入力がまだ提供されていません）のいずれか |
| 言語 | 会話の言語 |
| 環境 | エージェントの環境 |
| 開始時刻 | 会話の開始時間 |
| フラグ | [ライブ対応のエージェントへの引き継ぎ]（会話が人間のエージェントにエスカレーションされた場合）、[放棄された]（エンドユーザーが未完了の会話を終了した場合）、または [TU,TD]（会話内での回答がエンドユーザーに評価された場合） |
結果は、メタデータ（環境と期間を除く）および次の追加のフィルタ オプションでフィルタできます。
| X | 項目 |
|---|---|
| インテント | 提供されたインテントが会話の任意の時点で一致しました |
| No Match | 会話ターンの一部でインテントが一致しませんでした |
| フロー | 提供されたフローは、会話ターンの末尾の最後のアクティブなフローです |
| ページング | 提供されたページは、会話ターンの末尾の最後のアクティブなページです |
| ライブ対応のエージェントへの引き継ぎ | ライブ対応のエージェントへの引き継ぎ フラグが設定されている |
| 放棄済み | 放棄された フラグが設定されている |
| 会話 ID | 特定の会話が選択されている |
| 開始時刻 | 期間が指定されている |
| エージェントの発話 | 提供されたテキストは、会話の任意の時点でエージェントが使用した発話の部分文字列です。部分文字列は、発話された単語全体（スペース文字または末尾で区切られる）を含む必要があります。 |
| ユーザーの発話 | 提供されたテキストは、会話の任意の時点でユーザーが使用した発話の部分文字列です。部分文字列は、発話された単語全体（スペース文字または末尾で区切られる）を含む必要があります。 |
| 高評価のフィードバックがあります | 会話内のレスポンスに高評価のフィードバックが提供され [TU] フラグが設定されています |
| 低評価のフィードバックがあります | 会話のレスポンスに低評価のフィードバックが提供され [TD] フラグが設定されています |
会話の詳細ビュー
特定の会話のターンバイターン ビューは、会話の詳細ビューで確認できます。各会話ターンには、エンドユーザー メッセージ、エージェント メッセージ、次のメタデータが含まれます。
| X | 項目 |
|---|---|
| インテント | 一致したインテントの表示名または不一致 |
| ページング | 最終的なアクティブなページ名 |
| フロー | 最後のアクティブなフロー名 |
| パラメータ | 会話ターン中に収集されるパラメータ |
使用例
このツールを使用すると、人間のエージェントにエスカレーションされる原因となるエージェントの問題を特定できます。会話のサマリービューから、[はい] の [ライブ対応のエージェントへの引き継ぎ] フィルタを適用できます。これらの会話のいくつかを調べて、一般的なパターンを見つけてみてください。たとえば、ほとんどの会話で、特定のページで一致しないターンのフラグがある場合があります。これは、インテント ルートを作成する必要があるか、既存のインテント ルートがスコープに含まれていない場合に表示されます。
フロー分析表
[Flow Analysis - Table] タブは、トラフィックと、フローと表形式のページの分析に使用されます。
表示される指標は次のとおりです。
| X | 項目 |
|---|---|
| フロー名 | エージェントの各フローのフロー名 |
| 相対トラフィック | このフローを通過した会話の数 |
| エスカレーション率 | このフローで行われたすべての会話のうち、人間へのエスカレーションのリクエストにつながった会話の割合 |
| 離脱率 | このフローを経由したすべての会話のうち、このフローの後に終了した会話、またはこのフローから SESSION_END に移行した会話の割合 |
リスト ボタンをクリックすると、行に関連する会話のサンプルが開きます。サンプルを読み進めることで、具体的かつ微妙な問題をより深く理解できます。たとえば、エスカレーションが発生している理由を調べることができます。サンプルの詳細を表示するには、[会話の詳細] リンクをクリックします。
フローの [Detailed Stats] をクリックすると、フローのトラフィック統計情報が開きます。これにより、選択したフローとの間のフロー遷移の統計情報が表示されます。
表示される指標は次のとおりです。
| X | 項目 |
|---|---|
| 次のフロー | 選択したフローから別のフローへの遷移に関する統計情報 |
| 以前のフロー | 別のフローから選択したフローへの遷移に関する統計情報 |
フローの行をクリックすると、そのフローを妨げているページにドリルダウンします。
表示される指標は次のとおりです。
| X | 項目 |
|---|---|
| 相対トラフィック | このページにアクセスした会話の数。 |
| エスカレーション率 | このページにアクセスしたすべての会話のうち、人間によるエスカレーションのリクエストにつながった会話の割合 |
| 離脱率 | このページを表示したすべての会話のうち、フローから離脱した会話、または、このページを表示した直後にセッションから離脱した会話（END_SESSION）の割合 |
| マッチ率なし | このページにアクセスしたすべての会話のうち、不一致になった会話の割合 |
ページの [Detailed Stats] をクリックすると、ページのトラフィック統計情報が開きます。これにより、選択したページとの間のページ遷移の統計情報が表示されます。
表示される指標は次のとおりです。
| X | 項目 |
|---|---|
| インテント | ページのインテント マッチの統計情報 |
| 次のページ | 選択したページから別のページへの遷移に関する統計情報 |
| 前のページ | 別のページから選択したページへの遷移に関する統計情報 |
フロー分析グラフ
[Flow Analysis - Graph] タブは、トラフィックと、フローとグラフ形式のページの分析に使用されます。
フローをクリックすると、そのフロー内のページのトラフィックにドリルダウンします。
ズーム スライダーを使用すると、グラフの表示の詳細レベルを変更できます。低いボリュームのパスは、可視化の下位の設定から破棄されます。大きな設定でも、ボリュームの非常に少ないパスは常に非表示になります。
指標は色分けされているため、重大度の高い問題を簡単に見つけることができます。
リスト ボタンをクリックすると、関連する会話が表示されます。
フローをクリックすると、そのフロー内のページに移動します。ここには、相対的なトラフィック、マッチ率なし、エスカレーション率、離脱率の指標が表示されます。
API を使用して会話履歴にアクセスする
API を使用して会話履歴にアクセスできます。V3beta1 リファレンス ドキュメントをご覧ください。