

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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` 指標層級篩選條件，根據特定對話結果進行篩選。

**計算邏輯**：
+ Sum(所有已篩選對話的對話開始時間 - 對話結束時間) / (所有已篩選對話的計數)

**備註**：
+ 此指標的資料從 GMT 時間 2024 年 12 月 2 日 0:00:00 開始可用。

## 平均機器人對話回合數
<a name="average-bot-conversation-turns-metric"></a>

此指標會提供在指定開始和結束時間之間啟動調用資源 (流程或流程模組) 的已完成對話平均回合數。

單一回合是來自用戶端應用程式的請求，以及來自機器人的回應。

**指標類型**：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` 指標層級篩選條件，根據特定對話結果進行篩選。

**計算邏輯**：
+ Sum(所有已篩選對話的對話回合) / (所有已篩選對話的計數)

**備註**：
+ 此指標的資料從 GMT 時間 2024 年 12 月 2 日 0:00:00 開始可用。

## 機器人對話已完成
<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`，根據下列對話結果進行篩選。
  + SUCCESS：對話中的最終意圖被歸類為*成功*。
  + FAILED：對話中的最終意圖為失敗。如果 Amazon Lex V2 預設為 `AMAZON.FallbackIntent`，則對話也會失敗。
  + DROPPED：在對話分類為*成功*或*失敗*之前，客戶不會回應。

**計算邏輯**：
+ 對話的總計數。

**備註**：
+ 此指標的資料從 GMT 時間 2024 年 12 月 2 日 0:00:00 開始可用。

## 機器人意圖已完成
<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`，根據下列意圖結果進行篩選。
  + SUCCESS：機器人已成功滿足意圖。下列其中一種情況為真：
    + 意圖*狀態*為 *ReadyForFulfillment*，而 *dialogAction* 的類型為 *Close*。
    + 意圖 `state` 為 `Fulfilled`，而 `dialogAction` 的類型為 `Close`。
  + FAILED：機器人無法滿足意圖。意圖狀態。下列其中一種情況為真：
    + 意圖 `state` 為 `Failed`，而 `dialogAction` 的 `type` 為 `Close` (例如，使用者已拒絕確認提示)。
    + 在意圖完成之前，機器人會切換到 `AMAZON.FallbackIntent`。
  + SWITCHED：在原始意圖分類為*成功*或*失敗*之前，機器人會辨識不同的意圖並改為切換到該意圖。
  + DROPPED：在意圖分類為*成功*或*失敗*之前，客戶不會回應。

**計算邏輯**：
+ 意圖的總計數。

**備註**：
+ 此指標的資料從 GMT 時間 2024 年 12 月 2 日 0:00:00 開始可用。

## 機器人對話結果百分比
<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

**備註**：
+ 此指標的資料從 GMT 時間 2024 年 12 月 2 日 0:00:00 開始可用。

## 機器人意圖結果百分比
<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