スキルの会話インサイト
音声およびテキストの会話を期間別とチャネル別にトラッキングするスキルの会話レポートにより、実行パスの識別、インテント解決の正確性の判断および会話記録全体へのアクセスが可能になります。
セッション・レベルのメトリックにアクセスするには、概要レポートのメトリック・フィルタから「カバレッジ」を選択します。
Voice Insightsは、音声認識用に構成され、バージョン20.8以上のOracle Web、iOSまたはAndroid SDKで実行されているチャット・クライアントにルーティングされるスキルについて追跡されます。
レポート・タイプ
- 概要– このダッシュボードを使用して、チャネル別と期間別の音声およびテキストの会話の合計数をすばやく確認します。レポートのメトリックでは、完了、未完了および進行中の会話の数ごとにこの合計が分けられます。また、このレポートでは、棒グラフとワード・クラウドでスキルのトランザクションおよび回答のインテントの使用状況をランク付けすることで、スキルがどのように会話を完了したか、またはどのように完了に失敗したかが示されます。
- カスタム・メトリック– スキルに適用されたカスタム・ディメンションを測定できます。
- インテント– 実行メトリック(状態、会話期間、最も人気のあるパスと最も人気のあるパスおよび最も人気のないパス)のインント固有のデータおよび情報を提供します。
- パス– インテントの会話フローの視覚表現が表示されます。
- 会話– ダイアログ・フローおよびチャット・ウィンドウのコンテキストで表示される、スキルとユーザー・ダイアログの実際の記録が表示されます。
- リトレーナ– ライブ・データおよび取得したインサイトを使用して、モデレートされた自己学習によってスキルを改善する場所。
- エクスポート– Oracle Digital Assistantによって収集されたインサイト・データのCSVファイルをダウンロードできます。CSVからカスタム・インサイト・レポートを作成できます。
サマリー・メトリックおよびグラフのレビュー

このビューは、音声モードとテキスト・モードを切り替えることで調整することも、次を有効にすることで2つを比較することもできます。「テキストと音声の会話を比較」。

「テキスト」を選択すると、レポートには一連の共通メトリックが表示されます。「音声」を選択すると、レポートには音声固有のメトリックが追加で含まれます。これらのメトリックは、音声会話にのみ適用されるため、「テキストと音声の会話を比較」を選択した場合は表示されません
「モード」オプションは、音声またはテキストのメッセージの有無によって決まります。たとえば、テキスト・メッセージしかない場合は、「テキスト」オプションのみが表示されます。
共通メトリック
- 会話の合計数— 会話の合計数。完了、未完了および進行中の会話で構成されます。ステータスに関係なく、会話は1つ以上のダイアログ・ターンで構成できます。各ターンは、ユーザーとスキルの間の単一の交換です。
- 完了した会話– ユーザーの問合せに正常に回答することで終了した会話。終了フロー状態または終了フロー(暗黙的)が遷移として選択されている状態で終了する会話は、完了とみなされます。YAMLオーサリング・スキルでは、ダイアログ・フローのトラバーサルが
return
遷移で終了するか、insightsEndConversation
プロパティがある状態で終了すると、会話は完了としてカウントされます。ノート
このプロパティおよびreturn
遷移は、ビジュアル・フロー・デザイナでは使用できません。 - 未完了の会話– ユーザーがスキルを中止したために完了しなかった会話、またはシステムレベルのエラー、タイムアウトまたは無限ループのためにユーザーが完了できませんでした。
- 進行中の会話– 進行中の会話(完了もタイムアウトもしていない会話)。このメトリックは、複数ターンの会話をトラッキングします。進行中の会話は、セッションが期限切れになるとタイムアウトになります。
- 会話に費やされた平均時間– スキルの会話すべての平均時間。
- 合計ユーザー数および一意のユーザー数– ユーザー・ベース・メトリック。これは、スキルを持つユーザー数およびこれらのユーザーのうち何人がユーザーを返しているかを示します。

音声メトリック
これらのメトリックは情報提供のみを目的としており、操作はできません。
- 会話に費やされた平均時間– 音声会話の平均時間。
- 平均リアルタイム・ファクタ(RTF)–CPU時間に対するオーディオ入力の処理に要した時間の比率。たとえば、1秒のオーディオの処理にCPU時間が1秒かかる場合、RTFは1 (1/1)です。1秒のオーディオの処理に500ミリ秒の場合のRTFは.5または½です。処理がオーディオ入力より遅れないように、RTFを1未満にすることが理想的です。RTFが1を超える場合は、Oracle Supportに連絡してください。
- 平均音声レイテンシ – 発話の終わりを検出してから最終結果(またはトランスクリプション)を生成するまでの遅延(ミリ秒)。レイテンシが発生した場合は、Oracle Supportに連絡してください。
- 平均オーディオ時間– すべての音声会話の平均期間(秒単位)。
- 切り替えられた会話– 音声コマンドで開始されたが、対話を完了するためにテキストに切り替える必要があったスキルの会話の割合。このメトリックは、音声からテキストへの切替えに関連する複数の実行パスが存在したことを示します。
未完了の会話の内訳
- タイムアウト – 進行中の会話がアイドル状態になってから1時間を超えると、セッションが期限切れになり、タイムアウトがトリガーされます。
- システム処理エラー – システム処理エラーは、スキルではなくシステムによって処理されます。これらのエラーは、ダイアログ・フロー定義にエラー処理が組み込まれていない場合に発生します。
- 無限ループ – ダイアログ・フロー定義の不備(誤って定義された遷移など)によって、無限ループが発生する可能性があります。
- 取消済 - ユーザーが明示的に会話を取り消してスキルを終了した回数。

表のエラー・カテゴリまたはグラフのいずれかの部分をクリックすると、会話レポートにドリルダウンして、未完了の会話のコンテキストでこれらのエラーを確認できます。ここから会話レポートにアクセスすると、会話レポートの「結果」および「エラー」フィルタが「未完了」と選択したエラー・カテゴリに設定されます。たとえば、「無限ループ」をクリックすると、会話レポートは「未完了」および「無限ループ」でフィルタされます。レポートの「インテント」および「結果」フィルタは「すべて表示」に設定され、「ソート基準」フィールドは「最新」に設定されます。

ユーザー基準
- ユーザー数– スキルと対話したすべてのタイプのユーザー(セッション間で永続するチャネル割当IDを持つユーザー(一意のユーザー)、および自動的に割り当てられたIDが1つのセッションにのみ続くユーザー)の累積合計。
- 一意のユーザー数– スキルにアクセスしたユーザーのうち、一意のユーザーIDで識別されるユーザーの数。各チャネルには、IDをユーザーに割り当てる様々な方法があります。たとえば、Webチャネルを介してスキルとチャットするユーザーは、
userId
フィールドに定義された値によって識別されます。スキル・テスターのテスト・チャネルでは、「リセット」をクリックしてチャット・セッションを終了するたびに、新しいユーザーIDが割り当てられます。一度割り当てると、これらの一意のIDはチャット・セッション間で保持されるため、ユーザーがスキルを再訪問しても、このメトリックで集計された一意のユーザー数は増加しません。カウントは、一意のIDで割り当てられた別のユーザーがユーザープールに追加された場合にのみ増加します。ヒント:
ユーザーIDはチャネル内でのみ一意であるため(2つの異なるチャネルで同じIDを持つユーザーは2人のユーザーとしてカウントされ、1人としてカウントされません)、レポートをチャネルでフィルタ処理することでユーザー・ベースをよりよく理解できます。
新規ユーザー・トラッキングの有効化
"purgeUserData": true
を含めます。
新しいユーザー・データの収集は、この機能がリリース23.10に付属していた日付からのみ開始されます。
会話トレンド・インサイトのレビュー
- 完了– ユーザーが正常に完了した会話。終了フロー状態または終了フロー(暗黙的)が遷移として選択されている状態で終了する会話は、完了とみなされます。YAMLオーサリング・スキルでは、ダイアログ・フローのトラバーサルが
return
遷移で終了するか、insightsEndConversation
プロパティがある状態で終了すると、会話は完了としてカウントされます。ノート
このプロパティおよびreturn
遷移は、ビジュアル・フロー・デザイナでは使用できません。 - 未完了 – ユーザーがスキルを中止したために完了しなかった会話、またはシステムレベルのエラー、タイムアウトまたはスキルの設計上の不具合のためにユーザーが完了できなかった会話。
- 進行中– 進行中の会話(完了もタイムアウトもしていない会話)。このメトリックは、複数ターンの会話をトラッキングします。

インテントの使用状況の表示

すべての会話がインテントに解決するわけではありません。「インテントなし」をインテント棒グラフおよびワード・クラウドに表示すると、インテントがユーザー入力によって解決されず、遷移アクション、スキルによって開始された会話またはデジタル・アシスタントからのルーティングによって解決されたことを示します。
棒グラフの「すべてのインテント」、「回答インテント」および「トランザクション・インテント」オプションを使用して、インテント棒グラフおよびワード・クラウドをフィルタできます。
これらのオプションを使用すると、使用状況をすばやく分類できます。たとえば、混合スキル(トランザクション・インテントと回答インテントの両方を持つスキル)の場合、「回答インテント」および「トランザクション・インテント」オプションを使用して、これら2つのタイプのインテントの使用状況を表示できます。
ワード・クラウドにレンダリングされたキー・フレーズはオプションを反映しているため、たとえば、「回答インテント」を選択すると、回答インテントに関連付けられたキー・フレーズのみが表示されます。
キー・フレーズ・クラウドを使用したインテントのレビューと再トレーニング

色は、インテント解決の成功のレベルを表します:
- 緑は、リクエストの解決の平均値が高く、指定した期間内で信頼度ウィン・マージンしきい値以上であることを表します。
- 黄色は、指定した期間内で平均として信頼度ウィン・マージンしきい値を満たさないインテント解決を表します。この色は、インテントの再トレーニングが必要であることの適切な指標です。
- 赤は、unresolvedIntent用に予約されています。これは、どのインテントにも一致しなかったが、コーパスに組み込むことができるかもしれないユーザー・リクエストのコレクションです。
それ以外の場合は、実際のユーザー入力の表現であるキー・フレーズを使用して、インテント使用状況がより詳細に表示されます。英語のフレーズの場合は、リトレーナにアクセスできます(インテントに解決された英語以外のフレーズでは動作が異なります)。
キー・フレーズのレビュー
インテントをクリックすると、キー・フレーズのセットにドリルダウンできます。これらのフレーズは、元のインテントを保持する元のユーザー・メッセージの抽象化です。たとえば、キー・フレーズの「オーダーを取り消します」は、「オーダーを取り消したい」という元のメッセージからレンダリングされます。類似するメッセージは、1つのキー・フレーズ内にグループ化できます。たとえば、「オーダーを取り消したい」、「オーダーを取り消してもらえますか」、「オーダーを取り消してください」というフレーズは、「オーダーを取り消します」というキー・フレーズ内にグループ化できます。インテントと同様に、サイズは問題となっている期間のプロミネンスを表し、色は信頼度レベルを反映しています。
フレーズをクリックしてコンテキスト・メニューから「会話の表示」を選択すると、会話のコンテキスト内で実際のユーザー・メッセージ(またはキー・フレーズ内にグループ化されたメッセージ)を参照できます。
このオプションを選択すると、会話レポートが開きます。
PII匿名化を有効にすると、匿名化された値がフレーズ・クラウドに表示されます。
ワード・クラウドからの再トレーニング

このオプションにより、実際のフレーズをトレーニング・コーパスに追加できるリトレーナが開きます。

ネイティブ言語フレーズの確認
キー・フレーズ・クラウドの動作は、英語以外のフレーズではリトレーナにアクセスできないという点で、ネイティブ言語サポートのスキルによって異なります。異なる言語のフレーズが1つのインテントに解決された場合、インテントをクリックすると、キー・フレーズではなく言語がクラウドに表示されます。たとえば、unresolvedIntentをクリックした後でフランス語と英語が表示される場合は、インテントに解決できなかったフレーズが英語とフランス語の両方にあることを意味します。
英語がそれらの言語に含まれる場合は、「英語」をクリックしてキー・フレーズ・クラウドにドリルダウンできます。キー・フレーズ・クラウドから、コンテキスト・メニューの「会話の表示」および「再トレーニング」オプションを使用して、会話レポートおよびリトレーナにドリルダウンできます。ただし、英語以外の言語からドリルダウンしたときは、インテントと言語でフィルタされた会話レポートにドリルダウンします。リトレーナに直接アクセスすることはできません。unresolvedIntentの例に戻ると、「英語」をクリックした場合は、キー・フレーズ・クラウドにドリルダウンします。「フランス語」をクリックした場合は、unresolvedIntentおよびフランス語でフィルタされた会話レポートにドリルダウンします。
フレーズを会話のコンテキストでレビューした後で、そのフレーズを取り込むか再度割り当る場合は、インテント、言語(およびその他の基準)に基づいてフィルタ処理して、リトレーナから直接取り込む必要があります。
言語の使用状況のレビュー
複数言語スキルの場合、「言語」グラフのセグメントを使用して、サポートされている言語の使用状況を比較できます。各セグメントは、現在使用されている言語を表します。
グラフの言語で表される会話をレビューする場合は、セグメントまたは凡例をクリックすると、選択した言語でフィルタされた会話レポートにドリルダウンできます。
ユーザー・フィードバックおよび評点のレビュー

評価ごとの会話数に比例する平均顧客満足度スコアは、ドーナツ・チャートの中央に表示されます。範囲の各数値の会話単位での個々の合計は、発生に応じて長さが異なるユーザー評価ドーナツ・チャートの円弧としてグラフ化されます。これらのアークの1つをクリックすると、スコアでフィルタされた会話レポートが開きます。
スキルがリリース21.12より前のプラットフォームで実行されている場合は、「マスキングの有効化」をオフに切り替えて、会話記録でユーザー評価を確認する必要があります。プラットフォーム21.12以上(「マスキングの有効化」は非推奨)で実行されているスキルのトランスクリプトで実際のユーザー評価を保持するには、PII匿名化を有効にするときにPIIとして扱われるエンティティのリストからNUMBERエンティティを削除する必要があります。

デフォルトでは、正または負の反応を決定するためのユーザー・フィードバック・コンポーネントの最小しきい値は、2つ(不十分)に設定されます。ユーザー・フィードバックがコンポーネントに対して有効になっている場合、「ユーザー・フィードバック」ワード・クラウドには、マイナスの評価に付随するユーザー・コメントが表示され、頻度に応じてサイズ設定されます。これらのコメントは、しきい値未満の評価(コンポーネントのデフォルト設定ごとに1つまたは2つ)を表すユーザー評価チャートの円弧をクリックしてから、選択したスコアでフィルタされた会話レポートにドリルダウンすることで、全体的なインタラクションのコンテキストで確認できます。
ダイアログ・フローにフィードバック・コンポーネントを追加する方法
next
遷移を使用してSystem.Feedback
状態への明示的な遷移を設定する必要があります。)ダイアログ・フローは、ユーザーの反応を測るたびに、状態のユーザー・フィードバック・シーケンスに移行できます。たとえば、ユーザーがトランザクションを完了またはキャンセルした後などです。
「ユーザー・フィードバック」状態の前の状態が「回転の維持」プロパティの場合は、フローがユーザー・フィードバックに遷移する前にスキルが会話をユーザーに渡さないように、
True
に設定します。YAMLオーサリング・フローでスキルの制御を維持するには、System.Feedback
状態の前の状態でkeepTurn: true
を設定します。

above
、below
およびcancel
遷移に対応する状態を追加する必要があります。YAMLダイアログ・フローでは、これらの各状態にはreturn: done
遷移があります。
これらの状態は、「しきい値」プロパティによって決定される評価の上限と下限に対応します。これらの状態は、ユーザー評価の受信を確認するユーザー・メッセージとして追加できます。
フィードバック・タイプ | メッセージの例 |
---|---|
above |
Thank you for rating us ${system.userFeedbackRating.value} |
below |
You entered: ${system.userFeedbackText.value} We appreciate your feedback. |
cancel |
Skipped giving a rating or feedback? Maybe next time. |
systemComponent_Feedback_
キーを編集します。
カスタム・メトリックを使用したユーザー・フィードバックの測定

これらのカスタム・メトリックの設定の各状態は、ユーザー・フィードバック・コンポーネントの
above
、below
およびcancel
遷移アクションで指定された状態のいずれかに対応します。そのため、たとえば、「フィードバック・タイプ」というメトリックをカスタム・メトリック・レポートに追加する場合は、次のようにします。
- 「カスタム・メトリックの設定」状態を、ユーザー・フィードバック・コンポーネントの
above
、below
およびcancel
遷移アクションで指定された各状態の前に挿入します。 - 状態ごとに、ディメンション名としてフィードバック・タイプを入力します。
- 必要に応じて、遷移タイプ(
Canceled
、Positive
、Negative
など)に状態ごとに個別の値を追加します。フィードバック・データを記録するダイアログ・フローをインストゥルメントしたので、カスタム・メトリック・レポートの様々な値を問い合せることができます。

YAMLベースのフローでは、System.SetCustomMetrics
状態を追加してフィードバック・メトリックを追跡します。
カスタム・メトリックの確認
カスタム・メトリック・レポートでは、スキル固有のディメンションの会話データを追跡することで、インサイト・データのパースペクティブを追加できます。このレポートによって追跡されるディメンションは、カスタム・メトリックの設定コンポーネント(およびYAMLフローのSystem.SetCustomMetrics
コンポーネント)を使用してダイアログ・フロー定義に作成されます。このコンポーネントを使用して、スキルに固有のビジネスおよび開発のニーズを調べるディメンションを作成できます。たとえば、製品またはサービスの消費量(最も要求されたピザ生地または最もよく提出される経費精算書のタイプ)をレポートするディメンションを構築したり、スキルがユーザーを強制的に終了するか、ライブ・エージェントに渡すことによってユーザーに失敗するタイミングを追跡できます。



ディメンションおよびカテゴリは、ディメンションおよびカテゴリによって測定された会話が発生した場合にのみレポートに表示されます。
カスタム・メトリックのスキルの計測
カスタム・メトリック・レポートを生成するには、「カスタム・メトリックの設定」コンポーネント(YAMLダイアログで「変数」→「カスタム・メトリックの設定」または「変数」→「インサイト・カスタム・メトリックの設定」をクリックしてアクセス)を使用して、1つ以上のディメンションを定義する必要があります。
カスタム・メトリック・レポートにデータがない場合、「カスタム・メトリックの設定」状態が定義されていないか、これらの状態への遷移が正しく設定されていない可能性があります。
スキルごとに最大6つのディメンションを定義できます。
変数値のディメンションの作成
エンティティ値を追跡するには、値設定状態(コンポジット・バッグの解決状態など)の後にnext
遷移を「カスタム・メトリックの設定」状態に設定します。カスタム・メトリックの設定レポートのディメンションおよびフィルタは、カスタム・メトリックの設定コンポーネントで定義されたディメンションおよびディメンション値からレンダリングされます。
値設定状態がコンポジット・バッグ・エンティティを参照する場合、Apache Freemarker式を使用してバッグ・アイテムを追跡し、ディメンション値を定義できます。たとえば、ピザ・サイズ・ディメンションの値は、${pizza.value.pizzaSize.value}
として定義できます。この式によって返される個々の値(小、中、大)は、カスタム・メトリック・レポートのデータ・セグメントとしてレンダリングされ、フィルタとして適用することもできます。たとえば、ピザのスキルを計測した結果、サイズ、タイプおよびピザの生地別にピザのオーダーが分割されるというレポートがあります。これらの追加詳細は、Order Pizzaインテントに対してすでにレポートされているメトリックを補足します。
エンティティ値ベースのディメンションは、エンティティ値の設定後にのみカスタム・メトリック・レポートに記録されます。値が設定されていない場合、または値設定状態が「カスタム・メトリックの設定」状態に遷移しない場合、レポートのグラフは欠落しているデータを<not set>として記録します。
スキル使用を追跡するディメンションの作成
変数値に基づくディメンションに加えて、ユーザーがスキルと対話する方法だけでなく、その全体的な有効性を追跡するディメンションを作成できます。たとえば、ユーザーがライブ・エージェントに転送される頻度とその理由を示すディメンションを追加できます。
このようなディメンションは、ユーザー・エクスペリエンスを通知します。フロー全体で、同じディメンションを異なる「カスタム・メトリックの設定」状態に追加できます。「カスタム・メトリックの設定」の各状態は、異なるカテゴリ(またはディメンション値)を定義します。たとえば、2つの異なるフローにエージェント転送ディメンションがあります。1つはオーダー・ピザ・フローで、スキルがオーダーを正常に完了したときに値エージェント不要を持ち、もう1つはUnresolvedIntentフローで値「不良入力」を持ち、未解決の入力のためにスキルがいつユーザーをライブ・エージェントに転送するかを追跡します。カスタム・メトリック・レポートは、これらの状態が実行フローに含まれている場合に、これらのメトリックのデータを記録します。
エージェント転送ディメンションのカスタム・メトリック状態 | フロー | 値 | 使用 |
---|---|---|---|
setInsightsCustomMetricsNoAgent |
ピザのオーダー(コンポジット・バッグの解決状態のnext 遷移から、
|
エージェント不要 | 注文が支援なしで行われた会話の成功数を反映します。 |
setInsightsCustomMaxErrors |
ピザのオーダー(コンポジット・バッグの解決状態のcancel 遷移から)
|
最大エラー数 | ユーザーがライブ・エージェントに到達したためにライブ・エージェントに誘導された会話の数を反映します。 |
setInsightsCustomMetricsBadInput |
UnresolvedIntent | 不正な入力 | 未解決の入力によってユーザーがライブ・エージェントに転送された会話の数を反映します。 |
setInsightsCustomMetricsLiveAgent |
コールエージェント(エージェント開始シーケンス前) | エージェントがリクエストされました | ユーザーがライブ・エージェントをリクエストした会話の数を反映します。 |
カスタム・メトリック・データのエクスポート

列 | 説明 |
---|---|
CREATED_ON |
データ・エクスポートの日付。 |
USER_ID |
スキル・ユーザーのID。 |
SESSION_ID |
現在のセッションの識別子。これはランダムGUIDです。このため、このIDはUSER_IDとは異なります。 |
BOT_ID |
スキルの作成時に割り当てられたスキルID。 |
CUSTOM_METRICS |
各カスタム・メトリック・ディメンションのオブジェクトを含むJSON配列。name はディメンション名、value は会話から取得されたディメンション値です。 [{"name":"Custom Metric Name 1","value":"Custom Metric Value"},{"name":"Custom Metric Name 2","value":"Custom Metric Value"},...] 例: [{"name":"Pizza Size","value":"Large"},{"name":"Pizza Type","value":"Hot and Spicy"},{"name":"Pizza Crust","value":"regular"},{"name":"Agent Transfer","value":"No Agent Needed"}] 。
|
QUERY |
ユーザー発話またはカスタム・メトリック値を含むスキル・レスポンス。 |
CHOICES |
UIコンポーネントのメニュー選択肢。 |
COMPONENT |
カスタム・メトリックを実行するダイアログ・コンポーネントSystem.setCustomMetrics (ビジュアル・フローでのカスタム・コンポーネントの設定)
|
CHANNEL |
セッションを実施したチャネル。 |
インテント・インサイトのレビュー
このレポートは、指定された期間にスキルに定義されたインテントを返すため、その内容は様々な時点でスキルに追加、名前変更または削除されたインテントを反映するように変更される場合があります。

完了したパス

これらの統計をユーザー・エクスペリエンスのインジケータとして使用できます。たとえば、このレポートを使用して、タスクに費やされた時間が適切かどうかや、最短パスでもユーザー・エクスペリエンスが低下している(ユーザーの離脱を促進している可能性がある)かどうかを確認できます。たとえば、プロンプトや値の設定コンポーネントではなく、コンポジット・バッグ・エンティティを使用して値を入力することにより、スキルを介してユーザーをより迅速に誘導します。
未完了のパス
System.DefaultErrorHandler
など)別に未完了の会話の分布がプロットされます。これを使用すると、ダイアログ・フローの状態が継続的な障害点であるかどうか、および理由(エラー、タイムアウトまたは不正なユーザー入力)を確認できます。このレポートには未完了パスのパスまたは速度は表示されません(これらはこのユーザー入力に適用されないため)。かわりに、棒グラフでは、どのインテントにも解決できなかったメッセージ、または解決できる可能性があった(システムがインテントを推測できる)が信頼度スコアが低いために解決できなかったメッセージの数に基づいて、各インテントがランク付けされます。
「未完了状態」チャートでは、YAMLベースのフローでアンサー・インテント(静的インテント)はレンダリングされません。これは、結果がダイアログ・フロー定義の一連の状態によってではなく、
System.Intent
コンポーネントの状態によってサポートされるためです。

{}
)の場合、インサイトでは会話が不完全とみなされます。スキルがトランザクションを正常に処理した場合でも、インサイトは会話を未完了として分類し、最終状態をSystem.DefaultErrorHandler
としてチャート化します。
- 「パスの表示」をクリックすると、選択したインテントの未完了の会話でフィルタされたパス・レポートが開きます。このパスの終了状態には、ダイアログで定義された状態、または会話の終了を示す内部状態(
System.EndSession
、System.ExpiredSession
、System.MaxStatesExceededHandler
、System.DefaultErrorHandler
など)が含まれる場合があります。 - 失敗の原因となった会話のトランスクリプトにアクセスするには、「会話の表示」をクリックします。このオプションは、選択したインテントの未完了の会話でフィルタされた会話レポートを開きます。フィルタを適用することで、結果をさらに絞り込むことができます。たとえば、エラー条件でレポートをフィルタできます。
unresolvedIntent
インテント・レポートは、タスク指向インテントの期間およびルートに加えて、解決できなかったメッセージも返します。これらのメッセージを表示するには、左側のナビゲーション・バーでunresolvedIntentをクリックします。「最も近い予測」棒グラフでインテントをクリックすると、「未解決メッセージ」ウィンドウが更新され、そのインテントの未解決のメッセージが確率スコアでソートされます。


パス・インサイトのレビュー
パス・レポートでは、指定した期間にインテントの実行パスをフローした会話の数を確認できます。このレポートでは、ストップがインテントを表すことができる移動マップに似たパス、ダイアログ・フロー定義で定義された状態、および進行中として分類されていないすべての会話の開始と終了を示す内部状態がレンダリングされます。
このパスをスクロールすると、ユーザー入力の値によって会話が進んだ箇所、不正なユーザー入力、ユーザー入力がないために発生したタイムアウト、システム・エラーまたはその他の問題のために会話が行き詰った箇所を確認できます。完了したパスの最後のストップは緑色ですが、これらの問題が発生した未完了のパスではこれは赤色です。このレポートを使用すると、各状態を通じて会話の数が一定のままであった場所を特定し、値が設定されている(または設定されていない)ために会話が分岐したか、またはカスタム・コンポーネントが故障したりタイムアウトなどのその他の問題が原因で会話がデッドエンドになったかを特定できます。
パス・レポートの問合せ

問合せを入力すると、すべての実行フローがデフォルトでレンダリングされます。緑色の開始矢印

System.BeginSession
を表します。System.Intent
アイコン

不完全な会話の場合、パスは、会話を終了したエラーを表す
System.ExpiredSession
、System.MaxStatesExceededHandler
、System.DefaultErrorHandler
などの内部状態で終了することがあります。
YAMLオーサリング・フローの最終状態が空(または暗黙的)トランザクション(
{}
)を使用する場合、インサイトは、この状態をSystem.DefaultErrorHandler
状態として分類し、スキルがトランザクションを正常に処理した場合でも会話を未完了とみなします。

レポートでは、空白である(またはプレーン・テキストではない)または予期しない入力が含まれている顧客メッセージについては「Nullレスポンス」が表示されます。ポストバック・アクションであるテキスト以外のレスポンスについては、最新のアクションのペイロードが表示されます。例:
{"orderAction":"confirm""system.state":"orderSummary"}
「会話の表示」をクリックすると、パスで問い合せた会話レポートが開き、トランスクリプトのコンテキスト内で会話を終了したメッセージを確認できます。

シナリオ: パス・レポートの問合せ
財務スキルの概要レポートを見ると、不完全な会話が突然増加していることがわかります。積上げ棒グラフのオレンジ色の未完了セグメントで表される値を合計することで、スキルのSend MoneyおよびBalancesインテントの実行パスで会話が失敗していることがわかります。
インテントの失敗をさらに調査するには、パス・レポートを開き、最初の問合せ(結果が不完全なすべてのインテントをフィルタする)を入力します。パスは2つのブランチ(startPayments
で始まり、SystemDefaultErrorHandler
で終わるブランチと、startBalancesで始まり、System.DefaultErrorHandler
で終わるブランチ)でレンダリングされます。どちらのパスでも最終ノードをクリックすると、エラー数を示す詳細ペインが開き、これらのエラーが発生する前にスキルが受信したユーザー・メッセージのスニペットが表示されます。これらのスニペットをコンテキストで表示するには、詳細パネルの「会話の表示」をクリックして記録を表示します。すべての会話で、スキルは予期しないエラー・プロンプトで応答するように強制されました(Oops!I'm encountering a spot of trouble…)。これは、システム・エラーによりユーザー・リクエストを処理できなかったためです。
これらのエラーにつながる状態(およびこれらの失敗を引き起こす可能性のある役割)の詳細は、ダイアログ・フロー定義を参照して各インテントの実行パスを開始する状態を特定してください。これらの状態は、startBalances
、startTxns
、startPayments
、startTrackSpending
およびsetDate
です。
ダイアログ・フロー定義へのパスを比較すると、startPayments
フローとstartBalances
フローの両方で、パスにレンダリングされた最後の状態が、カスタム・コンポーネントを使用する状態より前であることがわかります。「コンポーネント」ページを確認すると、サービスが無効になっているため、会話を完了するために必要なアカウント情報がスキルによって取得されないことがわかります。
スキルの会話インサイトのレビュー
会話レポートを使用して、会話の実際の記録を調べて、ユーザー入力がインテント関連のパスをどのように完了したか、またはどうして完了しなかったかを確認できます。チャネル、モード(音声、テキスト、すべて)、タイプ(インテント・フローまたはLLMフロー)および期間で会話をフィルタできます。

1つのインテントの場合、会話レポートには完了した様々な会話がリストされます。ただし、YAMLオーサリング・ダイアログ・フローでは、完了は、ユーザー・メッセージおよび
return
遷移(会話を終了して会話コンテキストを破棄する)に応じて様々なことを意味します。たとえば、OrderPizzaインテントの場合、会話レポートには、正常に完了した2つの会話が表示されることがあります。そのうちの1つのみがオーダーを完了して終了します。もう1つの会話も正常に終了しますが、オーダーを処理するかわりに、間違ったユーザー入力を処理します。
音声メトリックの表示

PII匿名化
CURRENCYおよびDATE_TIME値は、数値を含む場合でも匿名化されません。また、コンポジット・バッグ・エンティティのデフォルト・プロンプト("Please select one value for...")の"one"は、数値として匿名化されます。これを回避するには、カスタム・プロンプトを追加します(「a値の選択」など)。

- PERSON
- NUMBER
- 電子メール
- PHONE_NUMBER
- URL
マスキングの有効化は、リリース21.12で非推奨になりました。インサイト・レポートおよびエクスポート・ログの数値をマスクするには、かわりにPII匿名化を使用します。21.12リリースより前に記録された会話には匿名化を適用できません。
PII匿名化の有効化
- 「設定」→「一般」をクリックします。
- 「PII匿名化の有効化」をオンにします。
- 「エンティティの追加」をクリックして、インサイト・レポートおよびログで匿名化するエンティティ値を選択します。
ノートPII値の匿名化を中止する場合、または匿名をまったく使用しない場合は、対応するエンティティを選択し、「エンティティの削除」をクリックします。エンティティを削除すると、その後の会話について、インサイト・レポート全体に実際のPII値が表示されます。しかし、その匿名化された形式は、以前の会話のために残ります。
匿名化された値は、選択したエンティティのPII値の匿名化を有効にした後にのみデータベースに保持されます。以前の会話には適用されません。インサイト・レポートまたはエクスポート・ファイルに選択した日付範囲によっては、PII値が実際のフォームと匿名フォームの両方に表示される場合があります。エクスポート・タスクを作成するときに、匿名化されていないPII値(スキルまたはデジタル・アシスタント設定で匿名化を有効にする前に発生した会話内の値を含む)に匿名化を適用できます。これらの匿名性は、エクスポートされたファイルにのみ適用され、データベースには保持されません。ノート
匿名化は永続的です(エクスポート・タスクによって適用される匿名化は、それにもかかわらず)。匿名化を有効にした後はPII値をリカバリできません。

エクスポート・ファイルのPII匿名化
エクスポートされたインサイト・ファイルの匿名化は、「設定」でスキルまたはデジタル・アシスタントのPII匿名化を有効にしたかどうか(およびいつ)によって異なります。
- 選択したエンティティに対して認識されるPII値は、匿名で置き換えられます。これらの匿名性はデータベースに保持され、ログおよびインサイト・レポートのPII値を置き換えます。この匿名化は、「設定」で匿名化を有効にした後(前ではなく)に発生する会話に適用されます。
- エクスポート・タスクの「ファイル・オプションのPII匿名化の有効化」は、デフォルトで有効になっており、「設定」で選択したエンティティに認識されるPII値が、PII匿名化が設定される前に発生した会話に適用されるようにします。PII匿名化より前の会話へのエクスポート中に適用される匿名が、エクスポート・ファイルにのみ存在します。元のPII値は、データベース、インサイト・ログおよびインサイト・レポートに残ります)。
- 「ファイルのPII匿名化の有効化」をオフにすると、「設定」で選択したエンティティに対して認識されたPII値のみが匿名化されます。ログ・ファイルには、匿名化設定がスキルまたはデジタル・アシスタントに対して有効になった後に発生した会話の匿名が含まれます。以前の会話は、元の未変更の発話として、PII値がそのまま表示されます。そのため、エクスポート・タスクの日付範囲の一部が匿名化より前である場合、エクスポート・ファイルには匿名化された会話と匿名化されていない会話の両方が含まれることがあります。
ノート
エクスポート・タスクにリリース22.04より前に発生した匿名化された会話が含まれている場合、エクスポート・タスクに対して「ファイルのPII匿名化の有効化」を選択すると、エクスポート・ファイルで22.04より前の会話に適用された匿名が変更されるか、または再匿名化されます。エクスポートされたファイル内の匿名が、22.04より前のエクスポート・ファイルの匿名またはインサイト・レポートに表示される匿名と一致しません。
- エクスポート・タスクの「ファイルのPII匿名化の有効化」オプションは、PII値を含むすべての元の未変更の発話がエクスポート・ファイルに含まれるように、デフォルトで無効になります。
- 「ファイルのPII匿名化の有効化」を選択すると、PII値は、デフォルトのエンティティであるPERSON、EMAIL、URLおよびNUMBERに対してのみ、エクスポートされたファイルで匿名化されます。PII値は、データベース、ログおよびインサイト・レポートに残ります。
リトレーナの適用

- 期間
- 言語 – ネイティブ言語サポートまたは翻訳サービスを介して有効になる複数言語機能用。デフォルトでは、レポートはプライマリ言語でフィルタされます。
- インテント – 上位2つのインテントの名前と照合し、解決に関連するプロパティ、信頼度およびウィン・マージンに対して比較演算子を使用して、フィルタします。
- チャネル – Oracle Service Cloud統合用に作成されたエージェント・チャネルを含みます。
- テキストまたは音声モード – 切り替えられた会話を含みます。


リトリーナによるインテントの更新
- ユーザー入力を追加できるのは、公開済バージョンではなく、スキルのドラフト・バージョンに属するトレーニング・コーパスのみです。
- トレーニング・コーパスにすでに存在している、またはリトレーナを使用してすでに追加したユーザー入力は追加できません。
- 公開済スキルは更新できないため、新しいデータをコーパスに追加するには、ドラフト・バージョンを作成する必要があります。
ヒント:
「すべてのバージョンの比較」をクリックするか、「最新のみ表示」トグルをオフに切り替えて、スキルのドラフト・バージョンと公開済バージョンの両方にアクセスします。
- スキルのドラフト・バージョンで、必要に応じてフィルタを適用し、「検索」をクリックします。
- ユーザー・メッセージを選択し、「インテントの選択」メニューからターゲット・インテントを選択します。スキルによって複数のネイティブ言語がサポートされている場合は、「言語の選択」メニューから言語を選択して、言語に適したトレーニング・セットに追加できます。
ヒント:
個々のインテントに発話を追加することも、複数のインテントを選択してから、表の左上にある「追加先」メニューからターゲット・インテントと、必要に応じて言語を選択することもできます。返されたすべてのリクエストをインテントに追加する場合は、「発話」(表の右上にある)を選択してから、「追加先」メニューからインテントと言語を選択します。 - 「例の追加」をクリックします。
- スキルを再トレーニングします。
- スキルを再公開します。
- 新しいスキルでデジタル・アシスタントを更新します。
- 概要レポートでメトリックに対する一定期間の変更をモニターし、スキルの様々なバージョンを比較して、新しいバージョンがスキルの全体的な成功に実際に加わったかどうかを確認します。再トレーニング・プロセスを繰り返すと、新しいバージョンごとにスキルの応答性が向上します。たとえば、Oracle Service Cloudチャットと統合されたスキルの場合、再トレーニングは、エスカレーションの下降トレンドをもたらし、これは、エージェント・ハンドオフ・インテントの使用状況の下降トレンドによって示されます。
モデレートされた自己学習
スキルに設定された信頼性しきい値の下に「上位の信頼性」フィルタを設定するか、デフォルトのフィルタである「インテントがunresolvedIntentと一致する」を使用して、インテント処理フレームワークによって作成された信頼性ランキングを使用してトレーニング・コーパスを更新できます。たとえば、unresolvedIntentの検索で「someone used my credit card」が返された場合は、これをDisputeインテントに割り当てることができます。これはモデレートされた自己学習で、スキルの整合性を保ちながらインテント解決を向上させます。
たとえば、レポートのデフォルトの検索基準では、不適切か、トピックから外れているか、スペルミスが含まれているため信頼度レベルに解決できないランダムなユーザー入力が表示されます。棒グラフを参照して、ユーザー入力を割り当てることができます。不明な内容で構成された入力を割り当てることにより、未解決インテントを処理するためのスキルのインテントを強化したり、適切なタスク指向インテントにスペルミスのあるエントリを追加できます(たとえば、Send Moneyインテントに対してsend moneey)。たとえば、スキルにWelcomeインテントがある場合は、スキルが「それについてはわかりませんが、花をオーダーするお手伝いはできます」のような応答を返すことができる、不適切でトピックから外れたメッセージを割り当てることができます。
翻訳サービスのサポート
スキルで翻訳サービスを使用すると、リトレーナにターゲット言語でユーザー・メッセージが表示されます。ただし、リトレーナは、トレーニング・コーパスに翻訳済メッセージを追加しません。かわりに、トレーニング・モデルで許容される言語である英語で追加します。をクリックすると、コーパスに追加できる可能性がある英語バージョンが表示されます。たとえば、contester (フランス語)に対してこのアイコンをクリックすると、dispute (英語)が表示されます。
データ製造ジョブの作成
インテントに発話を割り当てるかわりに、「インテント注釈」および「インテント検証」ジョブを作成することで、このタスクをクラウド・ソースにできます。これらのジョブを作成するために、会話ログをCSVにコンパイルする必要はありません。かわりに、「作成」、「データ製造ジョブ」の順にクリックします。
次に、リトレーナ・レポートでフィルタされるユーザー入力のジョブ・タイプを選択します。たとえば、unresolvedIntentに一致する上位インテントでフィルタされたレポートからインテント注釈ジョブを作成したり、インテントと一致した発話でフィルタされたレポートからインテント検証ジョブを作成できます。
ヒント:
「発話の選択」オプションを使用して、データ製造ジョブのリトレーナに適用されたフィルタによって返されるすべての結果を選択するか、発話のランダム・サンプリングを含む可能性のあるこれらの結果のサブセットからジョブを作成できます。「以前のジョブからの発話の除外」を選択すると、以前のデータ製造ジョブに対して選択された発話は後続のジョブで使用できなくなります。たとえば、1つのインテント注釈ジョブに含まれる発話は、後のインテント注釈ジョブでは使用できません。このオプションは、大規模な結果セットを確認するために複数の職務を作成する場合に使用します。
テスト・スイートの作成
リトレーナ・レポートで問い合せた結果のデータ製造ジョブと同様に、問合せによって返された発話からテスト・ケースを作成することもできます。これらのテスト・ケースのスイートは、「作成」、「テスト・スイート」の順にクリックして発話テスターに追加できます。
「テスト・スイートの作成」ダイアログの「発話の選択」オプションを使用して、テスト・スイートの発話をフィルタできます。リトレーナに適用されるフィルタによって返されるすべての発話をテスト・スイートに含めるか、発話のランダム・サンプリングを含めることができるこれらの結果のサブセットを含めることができます。「言語タグを含める」を選択して、テスト・ケースに関連付けられた言語がテスト中も同じままであることを確認します。
完成したテスト・スイートにアクセスするには、発話テスターで「テスト・ケースに移動」をクリックします。
言語の使用状況のレビュー
複数言語スキルの場合、「言語」グラフのセグメントを使用して、サポートされている言語の使用状況を比較できます。各セグメントは、現在使用されている言語を表します。
グラフの言語で表される会話をレビューする場合は、セグメントまたは凡例をクリックすると、選択した言語でフィルタされた会話レポートにドリルダウンできます。
インサイト・データのエクスポート
各種インサイト・レポートによって様々な視点が提供されますが、このデータを別の方法で参照する必要がある場合は、エクスポートしたインサイト・データのCSVファイルから独自のレポートを作成できます。
エクスポート・タスクが1,048,000行を超える行を返すときに、データが一連のCSVに分散されることがあります。このような場合は、ZIPファイルに一連のZIPファイルが格納され、それぞれにCSVが格納されます。
- 名前: エクスポート・タスクの名前。
- 最終実行: タスクが最後に実行された日付。
- 作成者: タスクを作成したユーザーの名前。
- エクスポート・ステータス: 「送信済」、「進行中」、「失敗」、「データなし」(タスクに定義された日付範囲内にエクスポートするデータがない場合)または「完了」(エクスポートされたデータをCSVファイルとしてダウンロードできるハイパーリンク)。「失敗」ステータスの上にカーソルを置くと、説明メッセージが表示されます。
エクスポート・タスクは、スキルの現在のバージョンに適用されます。

エクスポート・タスクの作成
- 「エクスポート」ページを開き、「+エクスポート」をクリックします。
- レポートの名前を入力し、日付範囲を入力します。
- 「エクスポートされたファイルのPII匿名化の有効化」をクリックして、個人識別可能情報(PII)値をエクスポートされたファイルの匿名に置き換えます。これらの匿名が存在するのは、スキル設定でPIIが有効になっていない場合のみです。この場合も、匿名の値ではなくPII値はデータベースに保存され、エクスポートされたインサイト・ログおよびインサイト・レポート全体(会話レポート、リトレーナ、ワード・クラウドのキー・フレーズなど)に表示されます。スキル設定でPIIが有効になっている場合、ログおよびインサイト・レポートには匿名が含まれます。
- 「エクスポート」をクリックします。
- タスクが正常に終了したら、「完了」をクリックしてCSV (エクスポートが多いCSV)のZIPをダウンロードします。スキル・レベルのエクスポートCSVの名前は、
B_
で始まります。デジタル・アシスタント・レベルのエクスポートのファイル名は、D_
で始まります。

エクスポート・ログのレビュー
BOT_NAME
には、スキルの名前またはデジタル・アシスタントの名前が含まれます。この列を使用して、ダイアログがデジタル・システムからスキルに(およびスキル間で)どのようにルーティングされるかを確認できます。CHANNEL_SESSION_ID
には、チャネル・セッションIDが含まれます。このIDを3列目のCHANNEL_ID
と組み合せて使用すると、セッションに対してある種の一意識別子を作成できます。セッションは失効または終了する可能性があるため、この識別子を使用してセッションが変化したかどうかを確認できます。TIMESTAMP
は、イベントが発生した順序すなわちシーケンスを示します。通常は、この列でソートします。USER_UTTERANCE
およびBOT_RESPONSE
には、スキルとユーザー間の実際の会話が含まれます。TIMESTAMP
でソートすると、簡単に、これらの2つのフィールドによってユーザー・メッセージとスキル・メッセージが交互に表示されるようになります。USER_UTTERANCE
列では発話が重複している場合があります。これは、ユーザーが同一インスタンスで実行をテストしているときに発生する可能性がありますが、会話の別の部分で発話が使用されているという理由で発生する可能性の方が高いと考えられます。COMPONENT_NAME
、CURR_STATE
およびNEXT_STATE
を使用してダイアログ・フローをデバッグできます。
エクスポートされたインサイト・データのフィルタ
TIMESTAMP
列でログをソートします。スキル・ユーザーの会話など他の視点から表示するには、システム生成の内部状態で列をフィルタできます。一般的なフィルタリング方法は次のとおりです。
- スキルおよびデジタル・アシスタントの会話の分類 – デジタル・アシスタントとその登録済スキルの両方のデータがエクスポートに含まれている場合、
BOT_NAME
フィールドの内容がわかりにくいことがあります。様々なスキルの間やスキルとデジタル・アシスタントの間で、会話が任意に動いているように見えるためです。ダイアログを正しい順序(およびコンテキスト)で表示するには、TIMESTAMP
列を昇順で使用します。 - 会話の区切りの確認 –
System.BeginSession
フィールドといずれかの終了状態を使用して、会話の開始と終了を探します。会話はSystem.BeginSession
状態で始まります。次のいずれかの終了状態で終了します:System.EndSession
System.ExpiredSession
System.MaxStatesExceededHandler
System.DefaultErrorHandler
- 実際のユーザー・スキル会話のレビュー –
USER_UTTERANCE
列とBOT_RESPONSE
列の内容を分離するには、CURR_STATE
列をシステム生成状態System.MsgReceived
およびSystem.MsgSent
でフィルタしますノートユーザーとスキルのダイアログの一部が、
テキスト・メッセージ以外のレスポンス(エンティティの解決状態からのレスポンス)では、スキル出力は、改行文字で結合されたレスポンスの一部になります。USER_UTTERANCE
列とBOT_RESPONSE
列で繰り返される場合があります。ユーザー・テキストが繰り返されるのは、ユーザー入力を必要としない自動遷移があるときです。スキル・レスポンスが繰り返されるのは、次の状態が終了状態のいずれか(System.EndSession
またはSystem.DefaultErrorHandler
)である場合です。 - ユーザーとスキルのダイアログを含むダイアログ・フロー実行のみをレビュー – 内部トランザクションを表示するか、テキスト・メッセージ以外のみを表示するには、
CURR_STATE
列でSystem.MsgReceived
状態およびSystem.MsgReceived
状態をフィルタによって除外する必要があります(ダイアログのみを表示するのとは反対の方法です)。 - セッションの識別 –
CHANNEL_SESSION_ID
とSESSION_ID
(隣合っている)の値を比較します。
エクスポート・ログのフィールド
列名 | 説明 | サンプル値 |
---|---|---|
BOT_NAME |
スキルの名前 | PizzaBot |
CHANNEL_SESSION_ID |
セッションのユーザーのID。この値によって新しいセッションが識別されます。この値の変化は、チャネルのセッションが期限切れになったか、リセットされたことを示します。 | 2e62fb24-8585-40c7-91a9-8adf0509acd6 |
SESSIONID |
現在のセッションの識別子。これはランダムGUIDです。このために、このIDはCHANNEL_SESSION_ID またはUSER_ID とは異なります。セッションとは、状態定義での明示的なreturn 遷移またはダイアログ・エンジンによって注入される暗黙のreturnによって終了された1つ以上の実行パスです。
|
00cbecbb-0c2e-4749-bfa9-c1b222182e12 |
TIMESTAMP |
作成日時のタイムスタンプ。イベントを時間順に並べるため、つまり順序付けのために使用されます。 | 14-SEP-20 01.05.10.409000 PM |
USER_ID |
ユーザーID | 2880806 |
DOMAIN_USERID |
USER_ID を参照します。
|
2880806 |
PARENT_BOT_ID |
スキルまたはデジタル・アシスタントのID。デジタル・アシスタントによって会話がトリガーされる場合、これはデジタル・アシスタントのIDを指します。 | 9148117F-D9B8-4E99-9CA9-3C8BA56CE7D5 |
ENTITY_MATCHES |
インテントに解決された最初の発話で一致したコンポジット・バッグ・アイテムの値を識別します。ユーザーの最初のメッセージが「大きなピザのオーダー」の場合、この列にはコンポジット・バッグ・エンティティPizza内のPizzaSizeアイテムの一致が含まれます。 後続のユーザー・メッセージ内の他のアイテム値はトラッキングされないため、ユーザーの次のメッセージにPizzaType値が含まれる場合、エクスポート・ファイルには含まれません。ユーザーが最初に「Order a pizza」と入力し、インテントが解決された後、PizzaSizeアイテムのエンティティ値を含むフォローアップ・メッセージ(「make it a large」)を追加すると、ENTITY_MATCHES 列にNULL値が記録されます。これは、インテントに解決された初期メッセージにアイテム値が含まれていなかったためです。
PII匿名化を有効にすると、空のオブジェクト( |
{"Pizza":[{"entityName":"Pizza","PizzaType":["CHEESE BASIC"],"PizzaSize":["Large"]}]} |
PHRASE |
ODAによるユーザー入力の解釈 | large thin pizza |
INTENT_LIST |
候補インテントのランキング(JSONオブジェクトとして表されます)。 | [{"INTENT_NAME":"OrderPizza","INTENT_SCORE":0.4063},{"INTENT_NAME":"OrderPasta","INTENT_SCORE":0.1986}] デジタル・アシスタントのエクスポートの場合、これはデジタル・アシスタントを介してコールされたスキルのランキングです。例: |
BOT_RESPONSE |
ユーザーの任意の発話に対応してスキルが行ったレスポンス。 | How old are you? |
USER_UTTERANCE |
ユーザー入力。 | 18 |
INTENT |
会話を処理するためにスキルによって選択されたインテント。これは、会話に使用できるとみなされインテントのリストのうち最上位のものです。 | OrderPizza |
LOCALE |
ユーザーのロケール | en-US |
COMPONENT_NAME |
現在の状態で実行されるコンポーネント(システムまたはカスタム)。このフィールドをCURR_STATE およびNEXT STATE とともに使用して、ダイアログflow.Thereを、コンポーネントではないCOMPONENT_NAME 列の他の値としてデバッグできます:
|
AgeChecker |
CURR_STATE |
会話の現在の状態。これを使用して、メッセージのソースを判別します。このフィールドには、ダイアログ・フロー定義で定義された状態の名前と、システム生成の状態が含まれます。これらの状態を使用してCSVをフィルタできます。状態には、ユーザー・メッセージのSystem.MsgRecieved と、カスタマ・サービス統合のスキルまたはエージェントによって送信されるメッセージのSystem.MsgSent が含まれます。
|
checkage
|
NEXT_STATE |
実行パスの次の状態。ダイアログ・フロー定義の状態遷移によって、実行パスの次の状態が示されます。 | crust |
Language |
セッション中に使用された言語。 | fr |
SKILL_VERSION |
スキルのバージョン | 1.2 |
INTENT_TYPE |
インテントが、トランザクション・インテント(TRANS )か回答インテント(STATIC )か
|
STATIC |
CHANNEL_ID |
会話が行われたチャネルを示します。このフィールドは、CHANNEL_SESSION_ID とともにセッションを表します。
|
AF5D45A0EF4C02D4E053060013AC71BD |
ERROR_MESSAGE |
返されたエラー・メッセージ。 | Session expired due to inactivity .
|
INTENT_QUERY_TEXT |
分類のためにインテント・サーバーに送信された入力。ユーザー入力がネイティブ言語のいずれかである場合、INTENT_QUERY_TEXT とUSER_UTTERANCE の内容は同じです。ただし、ユーザー入力がネイティブにサポートされていない言語の場合は異なるため、翻訳されたサービスによって処理されます。このケースでは、INPUT_QUERY_TEXT は英語です。
|
|
TRANSLATE_ENABLED |
翻訳サービスが使用されるかどうか。 | NO |
SKILL_SESSION_ID |
セッションID | 6e2ea3dc-10e2-401a-a621-85e123213d48 |
ASR_REQUEST_ID |
各音声入力を識別する一意のキー・フィールド、すなわち音声リクエストID。この値が存在する場合は、入力が音声入力であることを示します。 | cb18bc1edd1cda16ac567f26ff0ce8f0 |
ASR_EE_DURATION |
会話期間における単一の音声発話の長さ。 | 3376 |
ASR_LATENCY |
音声の待機時間(ミリ秒単位)。音声認識には大量の計算が必要ですが、メモリ帯域幅とバッテリ容量は限られています。このために、音声入力が受け付けられてから転記されるまでの待機時間が発生します。また、サーバー・ベースの実装では、ラウンドトリップによって待機時間がさらに長くなります。 | 50 |
ASR_RTF |
音声認識システムのパフォーマンスの標準メトリック。入力音声の長さ{I}の処理にかかる時間が{P}の場合、実時間係数はRTF = \frac{P}{I}のように定義できます。音声入力を処理するための時間の比率はCPU時間と比例します。たとえば、1秒のオーディオの処理にCPU時間が1秒かかる場合、RTFは1 (1/1)です。1秒のオーディオの処理に500ミリ秒の場合のRTFは.5または½です。 | 0.330567 |
CONVERSATION_ID |
会話ID | 906ed6bd-de6d-4f59-a2af-3b633d6c7c06 |
CUSTOM_METRICS |
各カスタム・メトリック・ディメンションのオブジェクトを含むJSON配列。name はディメンション名で、value は戻り値です。この列は、バージョン22.02以上で使用できます。
|
|
内部状態
状態名 | 説明 |
---|---|
System.MsgReceived |
スキルが外部ソース(ユーザーや別のスキルなど)からテキスト・メッセージを受信したときに、インサイトに対してトリガーされるメッセージ受信イベント。 |
System.MsgSent |
スキルが外部ソース(ユーザーや別のスキルなど)に応答したときに、インサイトに対してトリガーされるメッセージ送信イベント。
各 |
System.BeginSession |
System.BeginSession イベントは、次の場合にセッションを開始するためのマーカーとして送信されます:
|
System.EndSession |
System.EndSession イベントが、セッション終了のマーカーとして取得されるのは、現在の状態で未処理のエラーが生成されておらず、return 遷移(実行する別のダイアログ状態がないことを示す)がある場合です。System.EndSession イベントは、現在の状態に以下が含まれる場合にも記録されることがあります:
|
System.ExpiredSession (Error type: "systemHandled") |
セッション・タイムアウト。デフォルトのタイムアウトは1時間です。
会話が停止したまま1時間を超えると、セッションの期限切れがトリガーされます。セッションの期限切れは、インサイトで2つの個別のイベントとして取得されます。最初のイベントは、アイドル状態、つまりユーザーとのやり取りが停止したダイアログ・フローの状態です。2番目は内部 |
System.DefaultErrorHandler |
デフォルトのエラー・ハンドラが実行されるのは、ダイアログ・フローでのエラー処理が、グローバル(YAMLベースのフローのdefaultTransitions ノードなど)またはerror 遷移を使用して状態レベルで定義されていない場合です。ダイアログ・フローにerror 遷移が含まれる場合、System.EndSession イベントがトリガーされます。
|
System.ExpiredSessionHandler |
System.ExpiredSessionHandler イベントが発生するのは、セッションが期限切れになった後に、外部システムまたはユーザーからスキルにメッセージが送信された場合です。たとえば、ユーザーが会話中にスキルとのチャットを停止し、チャット・ウィンドウを開いたままにしておき、1時間を超えてからメッセージを送信すると、このイベントが発生します。
|
System.MaxStatesExceededHandler |
このイベントが発生するのは、1つのユーザー・メッセージの中でトリガーされたダイアログ状態が100を超えた場合です。 |
チュートリアル: Oracle Digital Assistant Insightsの使用
チュートリアルOracle Digital Assistant Insightsの使用に従って、インサイト・レポート(リトレーナを含む)を適用します。