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

# Amazon Connect のボットのメトリクスと分析
<a name="bot-metrics"></a>

次のフロー主導型メトリクスは、[フローおよび会話ボットパフォーマンスダッシュボード](flows-performance-dashboard.md)、および [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) で使用できます。

## ボットの平均会話時間
<a name="average-bot-conversation-time-metric"></a>

このメトリクスは、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話の平均時間を測定します。

**メトリクスタイプ**: 文字列 (*hh:mm:ss*)

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `AVG_BOT_CONVERSATION_TIME`

   メトリクスレベルフィルター `BOT_CONVERSATION_OUTCOME_TYPE` を使用して、特定の会話結果でフィルタリングできます。

**計算ロジック**
+ (フィルタリングされたすべての会話の開始から終了までの時間の合計) / (フィルタリングされたすべての会話の数)

**注意**:
+ このメトリクスのデータは、2024 年 12 月 2 日 00:00:00 GMT から利用できます。

## ボット会話の平均ターン
<a name="average-bot-conversation-turns-metric"></a>

このメトリクスは、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話の平均ターン数を提供します。

クライアントアプリケーションからのリクエストとボットからの応答が 1 回ずつで 1 ターンになります。

**メトリクスタイプ**: Double

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `AVG_BOT_CONVERSATION_TURNS`

   メトリクスレベルフィルター `BOT_CONVERSATION_OUTCOME_TYPE` を使用して、特定の会話結果でフィルタリングできます。

**計算ロジック**
+ (フィルタリングされたすべての会話の会話ターンの合計) / (フィルタリングされたすべての会話の数)

**注意**:
+ このメトリクスのデータは、2024 年 12 月 2 日 00:00:00 GMT から利用できます。

## 完了したボット会話
<a name="bot-conversations-completed-metric"></a>

このメトリクスは、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話の数を提供します。会話の終了時刻は、指定された終了時刻を超える場合があります。

例えば、開始時刻を午前 9 時、終了時刻を午前 10 時としてこのメトリクスをリクエストした場合、結果には、呼び出しリソース (フローまたはフローモジュール) の開始/終了時刻が以下のような会話が含まれます。
+ 午前 9 時 15 分に開始し、午前 9 時 40 分に終了
+ 午前 9 時 50 分に開始し、午前 10 時 10 分に終了

ただし、呼び出しリソース (フローまたはフローモジュール) が以下のような会話は除外されます。
+ 午前 8 時 50 分に開始し、午前 9 時 10 分に終了

**メトリクスタイプ**: 整数

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `BOT_CONVERSATIONS_COMPLETED`

  メトリクスレベルフィルター `BOT_CONVERSATION_OUTCOME_TYPE` を使用して、次の会話結果でフィルタリングできます。
  + 成功 — 会話の最終的なインテントが*成功*と分類されている。
  + 失敗 — 会話の最終的なインテントが失敗している。Amazon Lex V2 のデフォルトが の場合も、会話は失敗します`AMAZON.FallbackIntent`。
  + ドロップ済み — 会話が*成功*または*失敗*に分類される前に顧客の応答が終了した。

**計算ロジック**
+ 会話の合計数。

**注意**:
+ このメトリクスのデータは、2024 年 12 月 2 日 00:00:00 GMT から利用できます。

## 完了したボットインテント
<a name="bot-intents-completed-metric"></a>

このメトリクスは、完了したインテントの数を提供します。このメトリクスには、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話のインテントが含まれます。

**メトリクスタイプ**: 整数

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `BOT_INTENTS_COMPLETED`

  メトリクスレベルフィルター `BOT_CONVERSATION_OUTCOME_TYPE` を使用して、次の会話結果でフィルタリングできます。

  メトリクスレベルフィルター `BOT_INTENTS_OUTCOME_TYPE` を使用して、次のインテント結果でフィルタリングできます。
  + 成功 — ボットがインテントを正常に履行した。以下のいずれかの状況が該当します。
    + インテントの*状態*が *ReadyForFulfillment* で、*dialogAction* のタイプが *Close* の場合。
    + インテントの `state` が `Fulfilled` で、`dialogAction` のタイプが `Close` の場合。
  + 失敗 — ボットがインテントを履行できなかった。インテントの状態。以下のいずれかの状況が該当します。
    + インテントの `state` が `Failed` で、`dialogAction` の `type` が `Close` の場合 (例えば、ユーザーが確認プロンプトを拒否した場合など)。
    + ボットはインテントが完了する前に `AMAZON.FallbackIntent` に切り替わります。
  + 切り替え — ボットが別のインテントを認識し、元のインテントが*成功*または*失敗*に分類される前に、代わりにそのインテントに切り替えた。
  + ドロップ済み — インテントが*成功*または*失敗*に分類される前に顧客の応答が終了した。

**計算ロジック**
+ インテントの合計数。

**注意**:
+ このメトリクスのデータは、2024 年 12 月 2 日 00:00:00 GMT から利用できます。

## ボット会話の結果別の割合
<a name="percent-bot-conversations-outcome-metric"></a>

このメトリクスは、メトリクスレベルフィルター (`BOT_CONVERSATION_OUTCOME_TYPE`) で指定された特定の結果タイプで終了した会話の割合を提供します。このメトリクスには、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話のみが含まれます。

**メトリクスタイプ**: パーセント

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `PERCENT_BOT_CONVERSATIONS_OUTCOME`

**管理ウェブサイトを使用して Amazon Connect にアクセスする方法**: 

**計算ロジック**
+ (BOT\$1CONVERSATION\$1OUTCOME\$1TYPE の会話の数) / (会話の合計数) \$1 100

**注意**:
+ このメトリクスのデータは、2024 年 12 月 2 日 00:00:00 GMT から利用できます。

## ボットインテントの結果別の割合
<a name="percent-bot-intents-outcome-metric"></a>

このメトリクスは、メトリクスレベルフィルター (`BOT_INTENT_OUTCOME_TYPE`) で指定された特定の結果タイプで終了したインテントの割合を提供します。このメトリクスには、指定された開始時刻から終了時刻までの間に呼び出しリソース (フローまたはフローモジュール) が開始された、完了済みの会話のインテントが含まれます。

**メトリクスタイプ**: パーセント

**メトリクスカテゴリ**: フロー主導型メトリクス

**Amazon Connect API を使用してアクセスする方法**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API メトリクス識別子: `PERCENT_BOT_INTENTS_OUTCOME`

**管理ウェブサイトを使用して Amazon Connect にアクセスする方法**: 

**計算ロジック**
+ (BOT\$1INTENT\$1OUTCOME\$1TYPE のインテントの数) / (インテントの合計数) \$1 100