翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

分析APIsに を使用する

このセクションでは、ボットの分析を取得するために使用するAPIオペレーションについて説明します。

結果のフィルタ処理

Analytics APIリクエストでは、 startTimeと を指定する必要がありますendTime。は、 の後に開始startTimeされ、 の前に終了したセッション、インテント、インテントステージ、または発話APIを返しますendTime。

filters は Analytics APIリクエストのオプションフィールドです。AnalyticsSessionFilter、、AnalyticsIntentFilterAnalyticsIntentStageFilter、または AnalyticsUtteranceFilter オブジェクトのリストにマッピングされます。各オブジェクトで、フィールドを使用してフィルター条件となる式を作成します。たとえば、次のフィルターをリストに追加すると、ボットは 30 秒を超える会話を検索します。

{
    "name": "Duration",
    "operator": "GT",
    "value": "30 sec",
}

ボットのメトリクスを取得する

ListSessionMetrics、ListIntentMetrics、ListIntentStageMetrics および ListUtteranceMetrics オペレーションを使用して、セッション、インテント、インテントステージ、発話のサマリーメトリクスを取得します。

これらのオペレーションでは、以下の必須フィールドに入力してください。

リクエストの残りのフィールドはオプションです。次の方法で検索結果をフィルタリングし、整理できます。

以下のフィールドを使用してレスポンスの表示を処理します。

ListUtteranceMetricsを使用している場合は、attributes フィールドで返す属性を指定できます。このフィールドは、単一のAnalyticsUtteranceAttributeオブジェクトを含むリストにマッピングされます。発話時に Amazon Lex V2 が使用していたインテントを返すように LastUsedIntent フィールドで name を指定します。

レスポンスでは、 results フィールドは AnalyticsSessionResult、、AnalyticsIntentResultAnalyticsIntentStageResult、または AnalyticsUtteranceResult オブジェクトのリストにマッピングされます。各オブジェクトには、指定したメソッドから作成されたビンまたはグループに加えて、要求したメトリクスの要約統計の値を返す metrics フィールドが含まれています。

ボットのセッションと発話のメタデータを取得する

ListSessionAnalyticsData および ListUtteranceAnalyticsDataオペレーションを使用して、個々のセッションと発話に関するメタデータを取得します。

必須の startTime と endTime フィールドを入力して、結果を取得する時間範囲を定義します。

リクエストの残りのフィールドはオプションです。結果をフィルタリングしてソートするには:

以下のフィールドを使用してレスポンスの表示を処理します。

レスポンスでは、 sessions または utterancesフィールドは SessionSpecificationまたは UtteranceSpecification オブジェクトのリストにマッピングされます。各オブジェクトには、1 つのセッションまたは発話のメタデータが含まれています。

ボットのセッションと発話のメタデータを取得する

ListIntentPaths オペレーションを使用して、顧客がボットと会話する際に取るインテントの順序に関するメトリクスを取得します。

このオペレーションでは、以下の必須フィールドに入力してください。

オプションの filters フィールドを使用して、結果をフィルタリングします。詳細については、「結果のフィルタ処理」を参照してください。

Lex V2 会話からの発話統計の表示

発話統計を使用して、ユーザーがボットに送信している発話を特定できます。Amazon Lex V2 が正常に検出した発話と、検出されなかった発話の両方を確認できます。この情報を使用して、ボットをチューニングできるようになります。

例えば、Amazon Lex V2 が見つからないという発話をユーザーが送信している場合、その発話をインテントに追加できます。インテントのドラフトバージョンは新しい発話で更新され、ボットにデプロイする前にテストできます。

Amazon Lex V2 が、ボット用に設定されたインテントを呼び出そうとしていると認識した場合、発話が検出されます。Amazon Lex V2 が発話を認識せず、代わりに AMAZON.FallbackIntent を呼び出すと、発話が失われます。

発話統計は、 ListUtteranceMetricsAPIと ListAggregatedUtterance を使用して表示できますAPI。

発話統計はListUtteranceMetricsAPI、次の条件下で を使用して生成されません。

ListUtteranceMetrics API には、次のような追加機能があります。

発話統計はListAggregatedUtteranceAPI、次の条件下で を使用して生成されません。

ListAggregatedUtterance API には、次のような機能があります。

発話統計を使用すると、特定の発話が検出された、または見逃されたか、ボットインタラクションで発話が最後に使用されたかを確認できます。

Amazon Lex V2 は、ユーザーがボットと対話している間、発話を継続的に保存します。コンソールまたは、ListAggregatedUtterances オペレーションを使用して統計をクエリできます。データ保持期間は 15 日間で、ユーザーがデータストレージをオプトアウトした場合は使用できません。DeleteUtterances オペレーションまたはデータストレージのオプトアウトにより、発話を削除することができます。 AWS アカウントを閉じると、すべての発話が削除されます。保存された発話は、サーバーマネージドキーで暗号化されます。

ボットバージョンを削除すると、そのバージョンの発話統計は ListUtteranceMetrics の場合は最大 30 日間、ListAggregatedUtterances を使用する場合は 15 日間使用できます。Amazon Lex V2 コンソールでは、削除されたバージョンの統計を表示できません。削除されたバージョンの統計を表示するには、ListAggregatedUtterances と ListUtteranceMetrics オペレーション両方を使用します。

ListAggregatedUtterances と の両方でListUtteranceMetricsAPIs、発話は発話のテキストによって集計されます。例えば、顧客が「ピザを注文したい」というフレーズを使用したすべてのインスタンスは、応答の同じ行に集約されます。RecognizeUtterance オペレーションを使用する場合、使用されるテキストは入力トランスクリプトです。

ListAggregatedUtterances と を使用するにはListUtteranceMetricsAPIs、次のポリシーをロールに適用します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ListAggregatedUtterancesPolicy",
            "Effect": "Allow",
            "Action": "lex:ListAggregatedUtterances",
            "Resource": "*"
        }
    ]
}