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

# 【新增】 自訂指標
<a name="custom-metrics-topic"></a>

## 概觀
<a name="custom-metrics-overview"></a>

如果您的 Connect 執行個體已啟用最終 AI，您可以使用指標基本概念上的進階篩選條件和函數來建立和管理自訂指標，並讓它們可用於您的儀表板。

**Topics**

## 管理您的自訂指標
<a name="manage-custom-metrics"></a>

在儀表板和報告中，您會在儀表板索引標籤下找到「自訂指標」，列出執行個體中的所有自訂指標。透過自訂儀表板建立的自訂服務層級指標將會列出，也可以在此處進行管理。

您可以在搜尋文字方塊中輸入 ，對指標名稱或描述進行字元比對快速搜尋。

您可以選擇要編輯、刪除或複製的指標。按一下清單頁面中的指標名稱，即可取得自訂指標的完整檢視。

![\[儀表板和報告中具有搜尋功能的自訂指標資料表。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/dashboard-custom-metric-table-with-search.png)


## 建立、編輯自訂指標
<a name="create-or-edit-custom-metrics"></a>

若要建立自訂或編輯指標，請導覽至儀表板和報告頁面「自訂指標」區段。按一下「建立指標」按鈕來建立指標，或選取現有的指標，然後按一下「編輯」按鈕。

建立自訂指標時，您需要選擇該指標是用於服務層級組態，還是使用指標建置器的進階指標。
+ **服務層級組態** - 設定排除標準並定義服務層級計算的接聽時間、捨棄時間閾值
+ **指標建置器** - 使用數學操作和函數建立具有指標基本概念的進階自訂指標。如需詳細資訊[，請參閱自訂指標基本概念](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)。

### 服務層級組態
<a name="custom-metrics-service-level-config"></a>
+ **指標名稱**：輸入唯一名稱 (最多 128 個字元)
+ **描述 (選用)**：提供指標用途的詳細資訊 (最多 500 個字元)
+ **目標時間**：指定服務層級閾值。
  + **長度**：輸入介於 1 秒到 7 天之間的值
  + **單位**：選取秒、分鐘、小時或天
+ **排除的聯絡結果**：選擇要從分母排除的聯絡類型：
  + **轉接的聯絡**
  + **導致回撥的聯絡**
  + **在 X 秒/分鐘/小時/天內捨棄的聯絡**
+ 當您設定這些設定時，服務層級計算預覽會自動更新。預覽顯示：
  + 計算公式。
  + 指標測量內容的純語言說明。
  + 在目標時間內接聽的聯絡百分比，排除您指定的任何聯絡類型。

![\[服務層級組態編輯器顯示自訂服務層級指標的組態選項。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/dashboard-service-level-editor.png)


### 指標建置器
<a name="metrics-builder"></a>

指標建置器是一種互動式編輯器，可讓您定義具有指標基本概念和數學運算子的進階自訂指標。如需基本和運算子的完整清單，以及進階自訂指標的範例，請參閱[連結](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)

**使用指標建置器建立自訂指標的步驟：**

1. 按一下主儀表板頁面上的「建立指標」按鈕。

1. 在「建立自訂指標」頁面中，選取「指標建置器」選項。

1. 首先定義自訂指標的元件。

1. 例如，我們希望建立一個速率指標，以計算處理的總聯絡人百分比，該聯絡人是屬於聊天頻道子類型的 SMS。

   1. 指定「處理聯絡人」的「M1」或任何變數名稱，然後新增選用篩選條件：頻道 =「聊天」和子類型 =「簡訊」。

   1. 接下來，為另一個指標基本指定「M2」。例如，沒有篩選條件的「已處理聯絡人」。

1. 在定義中，指定「100 \$1 SUM(M1) / SUM(M2)」，這是一個速率指標，定義聊天簡訊管道處理的所有聯絡人與處理的所有聯絡人的總和。

1. 選取顯示格式為「百分比」。

1. 為選用的欄位正趨勢指標選取適當的值。

1. 為您的指標指定唯一名稱。

1. 為您的指標新增適當的描述。

1. 檢查表單中是否有任何錯誤，一旦沒有錯誤，頁面底部會自動啟用「儲存」按鈕。

1. 按一下頁面底部的「儲存」以建立您的自訂指標。

1. 當此自訂指標新增至小工具時，適當的分組將套用至指標。

**元件**

元件代表指標基本或基本指標表達式，可做為將透過定義編輯器輸入之指標公式的變數參考。
+ 最多可以新增 5 個指標元件。
+ 元件識別符
  + 開頭為底線或字母，後面接著字母、數字或底線。
  + 在新增的元件中應該是唯一的。
+ 指標
  + 與個別元件連接的基本指標。
  + 請參閱[連結](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)，以查看可在不同元件之間一起使用哪些指標基本概念
+ 篩選條件和閾值
  + 將篩選條件和閾值套用至選取的指標。
  + 選取新的指標時，現有的篩選條件和閾值將被移除。
  + 可為任何選取的指標套用最多 5 個篩選條件。
  + 可為特定篩選條件選取最多 10 個值。
  + 如需支援的篩選條件值，請參閱[連結](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html#supported-metric-filters)。
  + 選用

**注意**  
使用 `Current Contact` 類別基本指標的自訂指標最多只能支援 1 個元件。

**定義：**

使用元件識別符、可用的數學運算子和函數定義表達式。將評估表達式以計算自訂指標值。
+ 如需支援的數學運算子、函數和範例表達式，請參閱[連結](https://docs.aws.amazon.com/connect/latest/adminguide/metric-primitive-definitions.html)。
+ 定義區段要求使用者至少新增一個元件。
+ 表達式中最多允許 1024 個字元。

**注意**  
本節已停用，當`Current Contact`指標基本值用於建置自訂指標時無法使用。

**Example**  
**顯示格式：**  
指定儀表板上計算自訂指標值的顯示格式。  
+ 已將百分比 - “%” 新增至計算的自訂指標值顯示結尾
+ 計算的自訂指標上的整數 - 整數值。如果計算的指標為「3.141592」，則值將為「3.00」
+ 計算的自訂指標上的雙十進位值。如果計算指標為「3.141592」，則四捨五入後顯示的值將為「3.142」，最多 3 個小數位數。
+ 秒 - 計算自訂指標上的「HH：MM：SS」格式化值。
**正趨勢指標：**  
+ 正 - 變更會以綠色箭頭顯示
+ 負 - 變更會以紅色箭頭顯示
+ 中立 - 變更將顯示為沒有任何指標。
+ 選用
**指標名稱：**  
+ 最多 128 個字元
+ 應該是唯一的
**描述：**  
+ 最多 500 個字元
+ 選用
使用編輯器時的典型標註  
+ 若要存取指標建置器，您的 Connect 執行個體應該已啟用最終 AI。
+ 一旦停用最終 AI，即無法存取使用指標建置器建立的指標進行編輯。

![\[Metric Builder 編輯器顯示用於建立進階自訂指標的元件、定義和組態選項。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/dashboard-metric-builder-editor.png)


## 檢視自訂指標
<a name="view-custom-metric"></a>

若要檢視自訂指標，請導覽至儀表板和報告，然後按一下「自訂指標」區段中的自訂指標名稱，該區段會列出執行個體中的所有自訂指標。檢視自訂指標時，您會看到下列資訊：

**自訂指標詳細資訊：**
+ 指標名稱：您指派給自訂指標的名稱
+ 狀態：顯示指標是否為「已發佈」且可供使用
+ 描述：指標用途的簡短說明
+ 建立方法：顯示建立指標的方式 （服務層級或指標建置器）
+ 已建立：建立指標的日期、時間和使用者
+ 修改：上次修改指標的日期、時間和使用者
+ ARN：指標的 Amazon Resource Name 唯一識別符，可用於查詢 GMDv2 api。

**元件：**
+ 元件識別符：每個元件的參考 ID （例如 M1, M2)
+ 指標：計算中使用的基本指標 （例如，處理的聯絡案例、排入佇列的聯絡案例）
+ 篩選條件和閾值：套用至指標的任何條件 （例如，佇列時間 (ms) <= 12000)
+ 定義：用於計算自訂指標的數學公式 （例如 100 \$1 SUM(M1) / SUM(M2))

**顯示設定：**
+ 顯示格式：指標值的顯示方式 （例如，百分比）
+ 正面趨勢指標：如何指出正面趨勢 （例如，中性）

您也可以使用頁面頂端的動作按鈕來管理自訂指標：
+ 刪除：移除自訂指標
+ 複製：建立自訂指標的副本
+ 編輯：修改自訂指標的組態

## 複製自訂指標
<a name="clone-custom-metric"></a>

複製自訂指標可讓您透過現有的自訂指標計算進行複製、進行任何變更，並儲存為新的自訂指標。複製可以在儀表板和報告上執行，方法是在儀表板索引標籤下的「自訂指標」區段中選取自訂指標，列出執行個體中的所有自訂指標，然後按一下複製按鈕。也可以透過導覽至自訂指標檢視頁面並按一下複製按鈕來執行。

## 刪除自訂指標
<a name="delete-custom-metric"></a>

自訂指標可以從自訂指標清單或指標檢視頁面中刪除。當您刪除自訂指標時，系統需要確認以防止意外刪除。

**若要刪除自訂指標：**

1. 導覽至**儀表板和報告**，並在儀表板索引標籤下的「自訂指標」區段中尋找您要刪除的自訂指標。

1. 針對您想要移除的指標，按一下**刪除**按鈕 （或開啟指標，然後從檢視頁面按一下**刪除**)。

1. 系統會顯示確認對話方塊，要求您輸入「確認」以防止意外刪除。

1. 按一下刪除以永久移除指標，或按一下取消以中止刪除程序。

**重要**  
重要考量：  
此動作為永久性且無法復原。刪除後，指標及其所有相關資料都會從您的執行個體中移除。
對儀表板的影響：如果刪除的指標用於任何儀表板，這些小工具會顯示錯誤訊息，指出指標不再可用。

## 將自訂指標新增至儀表板小工具
<a name="add-custom-metric-to-dashboard"></a>

您建立的自訂指標可以新增至儀表板小工具，以視覺化和監控您的資料。您可以透過小工具編輯功能表新增自訂指標，從任何[儀表板小工具](https://docs.aws.amazon.com/connect/latest/adminguide/dashboard-customize-widgets.html#dashboard-changing-metrics)中選取**動作**圖示，然後選擇**編輯**。

**若要將自訂指標新增至儀表板小工具：**

1. 從任何[儀表板小工具](https://docs.aws.amazon.com/connect/latest/adminguide/dashboard-customize-widgets.html#dashboard-changing-metrics)中，選取**動作**圖示，然後選擇**編輯**。

1. 在編輯面板中，您會看到可用指標清單，依類別分類：

   1. 標準指標 （例如主動意圖參與率、參考計數和回應完成率）

   1. **自訂指標**區段顯示執行個體中可用自訂指標的清單。

   1. 若要新增自訂指標：

      1. 使用頂端的搜尋欄位，依名稱尋找特定指標

      1. 捲動**自訂指標**區段以瀏覽可用的選項

      1. 按一下您要從清單中新增的自訂指標

1. 按一下**新增指標**以在小工具中包含您的選擇。
**注意**  
小工具對可新增的指標數量有限制。界面會顯示您可以新增的指標數量 （例如，「您最多可以新增 1 個」)。

1. 按一下**儲存**以將變更套用至小工具，或按一下**取消**以捨棄變更。