会話履歴ツールは、エージェントとエンドユーザーの間の実際の本番環境での会話を閲覧および分析するためのインターフェースを提供します。これを使用して、エージェントの機能パフォーマンスを評価したり、問題をデバッグしたりできます。
フローとページの分析では、エージェントのフローグラフを通じてトラフィックとエスカレーションを把握できます。これにより、エージェント ビルダーはトラフィック フロー（高トラフィック パスと低トラフィック パス）を分析し、問題があるホットスポットを検出して（たとえば、エスカレーションの上位を特定する）、問題の原因となった特定のページやインテントにドリルダウンできます。フローとページの分析を会話の履歴フィルタとともに使用すると、トラフィックの関連するサブセットを柔軟に調べることができます。
制限事項
大規模なエージェントの場合、フロー分析テーブルとフロー分析グラフのビューの読み込みに時間がかかることがあります。読み込み時間を短縮するには、インテント フィルタと 1 週間の日付範囲を使用します。
会話ごとに最大 500 ターンが記録されます。
必要な権限
このツールを使用するには、dialogflow.conversations 権限が必要です。この権限はカスタムロールに追加できます。また、管理者ロールと他の Dialogflow CX ロールでも使用できます。
会話履歴を有効または無効にする
会話履歴ツールには、エージェントの会話が表示されます。会話履歴を有効または無効にするには、[会話履歴を有効にする] 設定を使用します。
retention_window_days
セキュリティ設定を使用して、データの保持期間を制御することもできます。
音声再生
会話履歴では、会話の音声再生が可能です。この機能は、全般設定で有効にできます。会話を読み込む前にこの機能を有効にしないと、コンソールに音声再生が利用できないという通知が表示されます。
この機能を使用すると、署名付き URL を使用してコンソールで会話の音声を聞くことができます。音声再生では、署名付き URL を使用して、Cloud Storage バケットに保存されている音声ファイルへの認証済みの一時的なアクセスを提供します。これにより、ユーザーに Cloud Storage バケットへの直接アクセス権を付与する必要がなくなります。
音声を再生するには、署名付き音声 URL を生成する権限が必要です。また、Cloud Storage バケット内の音声ファイルを指す音声 URI を使用して、音声会話をコンソールにインポートする必要があります。
会話の履歴を参照する
会話履歴ツールを使用するには:
- 会話エージェント コンソールを開きます。
- プロジェクトを選択します。
- エージェントを選択します。
- ナビゲーション メニューで [会話履歴] を選択します。
- 表で会話を表示します。
- 必要に応じて、表の上にある [フィルタ] コントロールを使用してフィルタを適用します。
- このドキュメントの後半で説明するタブのいずれかを選択します。
会話の履歴を CSV ファイルにダウンロードする
- 左側のナビゲーションで [会話履歴] に移動します。
会話セッションを選択し、[プレビュー パネルで会話を開く] ボタンをクリックします。
![[プレビューを開く] ボタン](https://docs.cloud.google.com/static/dialogflow/cx/docs/images/open-preview.png?hl=ja)
[すべての会話をエクスポート] をクリックします。会話を含む CSV ファイルがパソコンにダウンロードされます。
会話
会話は、会話の概要ビューと会話の詳細ビューに表示されます。
会話の概要ビュー
会話の概要ビューには、すべての会話が一覧表示されます。会話ごとに次のメタデータが提供されます。
| X | 項目 |
|---|---|
| 会話 ID | 会話の識別子 |
| 所要時間 | 会話の継続時間 |
| ターン | 会話ターンの数 |
| チャンネル | チャット（テキスト）、音声、不明（会話へのエンドユーザー入力がまだ提供されていません）のいずれか |
| 言語 | 会話の言語 |
| 環境 | エージェントの環境 |
| 開始時間 | 会話の開始時間 |
| フラグ | [ライブ対応のエージェントへの引き継ぎ] フラグ（会話が人間のエージェントにエスカレーションされた場合）、Abandoned（エンドユーザーが未完了の会話を終了した場合）、または [TU,TD] フラグ（会話内での回答がエンドユーザーに評価された場合）に設定できます。 |
結果は、メタデータ（環境と期間を除く）と次の追加のフィルタ オプションでフィルタできます。
| X | 項目 |
|---|---|
| インテント | 提供されたインテントが会話の任意の時点で一致しました。 |
| No Match | 会話ターンの一部でインテントが一致しませんでした。 |
| フロー | 提供されたフローは、会話ターンの末尾の最後のアクティブなフローです。 |
| ページ | 提供されたページは、会話ターンの末尾の最後のアクティブなページです。 |
| ライブ対応のエージェントへの引き継ぎ | ライブ対応のエージェントへの引き継ぎフラグが設定されている。 |
| Is Abandoned | 放棄されたフラグが設定されている。 |
| 会話 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 リファレンス ドキュメントをご覧ください。
プライバシー
会話の履歴を有効にすると、Google が会話のデータを収集して一定期間保存した後、完全に削除します。デフォルトは 365 日ですが、SecuritySettings の retention_window_days フィールドを使用して、この期間を短縮できます。
保存中のデータは、お客様が完全に所有権を保持します。Google がお客様のデータをカスタマー サポート以外の目的で使用したり、アクセスしたりすることはありません。