在此文章中
簡介
dropdown icon
業務規則引擎實作
    dropdown icon
    在開始之前
      設定 BRE 資料同步執行個體
    存取 BRE 應用程式
    建立一組規則
    dropdown icon
    BRE 要求
      一般設定
      查詢參數
      解析設定
      解密設定
      輸出變數
    使用 BRE 請求活動建立流程
    常見問題及解答
Webex 聯絡中心商業規則引擎使用指南
list-menu在此文章中
list-menu意見回饋?

Webex 聯絡中心中的商業規則引擎 (BRE) 可讓客戶上傳 系統在運行期間可以訪問的特定數據以作出路由決定或 顯示呼叫代理程式的資訊。

簡介

Cisco© Business Rules Engine 是一款應用程序,可協助在 Webex 聯繫中心快速找到資料。使用 Cisco© 業務規則引擎 (BRE),您可以執行資料查找、自訂路由和一般實作。系統在運行時檢索數據,並將其用於路由決策或向代理顯示資訊。

例如,租戶希望根據撥打的自動號碼識別碼 (ANI) 將呼叫路由到特定的一組客服人員。在這種情況下,租戶只需上傳 ANI 清單即可。如果來電的 ANI 在該清單中,系統會將通話路由到指定的座席群組。如果 ANI 不在清單中,系統會將呼叫路由到普通佇列。

典型的BRE實施方案包含以下主要組成部分:

  • BRE 資料同步: BRE DataSync 設定公用程式提供了一個接口,用於定義資料同步實例,以便將資料匯入 BRE 資料庫。租用戶定義資料同步實例後,即可上傳 CSV 檔案。該系統將上傳的逗號分隔值資料轉換為 BRE 資料庫中的記錄。

  • 業務規則引擎: 業務規則引擎實用程式提供了一個用於建立網域和規則集的介面。BRE 要求傳入的決策請求與 域相關聯。該域包含一組規則。每條規則都被賦予一個優先權。BRE 嘗試根據規則中的條件,將網域中優先順序最高的規則與決策請求進行比對。

  • 流程設計器: 一個用於定義流程的拖放式使用者介面,該流程可以協調和自動化 Webex 聯繫中心的各個元件。您可以建立一個流程,呼叫 BRE 活動來執行類似 HTTP 請求活動的簡單資料查找。但是,在這種情況下,資料儲存在 Webex 聯繫中心內。

資料處理指南

為維護BRE的完整性和安全性,您必須遵守以下資料處理準則:

  • 允許的資料型別: 上傳對 BRE 的運作和功能至關重要的資料。這包括但不限於業務規則、配置和非敏感操作資料。

  • 限制個人識別資訊: 除了 ANI 資料外,請勿向 BRE 上傳任何個人識別資訊 (PII)。個人識別資訊包括但不限於:

    • 全名
    • 社會安全號碼
    • 電子郵件地址
    • 實體地址
    • 財務資訊

ANI 資料指的是與呼叫方關聯的電話號碼。ANI 資料是唯一允許上傳到 BRE 的 PII 類型。此例外情況是為了支援依賴 ANI 資料的特定業務功能。

業務規則引擎實現

業務規則引擎由一個即時規則引擎組成,該引擎由與入口點關聯的流程呼叫。此規則引擎通常會諮詢資料儲存庫,以評估所需的呼叫處理方式。

BRE 查詢是在您的流程中進行的簡單資料訪問,類似於 HTTP 請求。但是,BRE 查詢的資料位於 Cisco Webex 聯繫中心資料中心內。下圖展示了 BRE 資料查找過程中涉及的各種流程。

在開始之前

在實施 BRE 之前:

  • 在充分了解資料模型的基礎上,為您的實作配置 BRE DataSync 實例。
  • 請熟悉本指南中使用的以下術語:
    • Attribute: attribute 是在 BRE 實用程式中建立的命名變數或資料欄位。它作為 BRE 用於處理請求和產生輸出的資訊容器。
    • Context: context 主要用作屬性的範例名稱,該屬性指定 BRE 請求活動的目標域。
    • Label: Label 是一種特殊類型的屬性,旨在保存規則評估的輸出或結果。

更多詳情請參閱 常見問題 部分。

配置 BRE DataSync 實例

BRE DataSync 工具透過存取資料庫來做出路由決策。務必定期更新資料庫,確保其中包含相關資訊。本節介紹如何設定 BRE DataSync 公用程式以更新 BRE 儲存庫。

BRE DataySync 實用程式如何配置以更新 BRE 儲存庫的示意圖。BRE 資料同步 > 增刪改查 > BRE 資料庫。
BRE DataSync 實用程式

租用戶管理員必須為規則引擎在決策過程中參考的每個資料集建立一個 BRE DataSync 實例。管理員可以建立資料集或上傳 CSV 檔案。資料被轉換為BRE儲存庫中的記錄。

在開始之前

請聯絡思科客戶服務客戶經理以取得 BRE DataSync 帳戶的存取權限。

BRE DataSync 目前僅對 完全管理員 角度啟用。擁有完整管理員角色的租用戶可以使用 CSV 檔案上傳或鍵值對上傳資料。擁有此角色的使用者只能上傳其所在組織的特定資料。

合作夥伴管理員、外部管理員、代理商和主管無權存取 BRE DataSync 實用程式。

1

以管理員身分登入 BRE DataSync 實用程式。

為了配合 BRE Hosting 和 Scalability 的最新改進,DataSync 實用程式的 URL 已更改。請務必使用更新後的URL將資料上傳到BRE。

2

選擇 BRE 資料清單 以查看與租戶組織相關的所有資訊。

3

將資料以鍵值對的形式新增至 BRE 儲存庫: 選擇 新增 BRE 資料

  1. 從 TenantName 下拉清單中選擇組織名稱。

  2. 從下拉清單中選擇 BRE 查找類型 。

    當您新增 BRE 查找類型時,請注意以下尺寸限制:

    • BRE 查找類型的最大字元限制:VARCHAR(200)
    • 值欄位的最大字元限制:VARCHAR(500)
    • 每個組織的最大查找類型數量:100
    • 每個查找類型的最大行數:100K 行
    • 上傳檔案的最大大小限制:10 MB

    請聯絡思科客戶成功經理或解決方案保障聯絡人以新增新的查找類型。

  3. 點選 新增資料 輸入 鍵 和 值。

  4. (可選)按 刪除 以刪除現有的 鍵 和 值。

  5. 按一下 提交.

4

將 CSV 檔案上傳到 BRE 儲存庫: 選擇 上傳 BRE CSV 資料 。

  1. 從 TenantName 下拉清單中選擇組織名稱。

  2. 從下拉清單中選擇 BRE 查找類型 。

  3. 選擇 上傳 以瀏覽並上傳 CSV 檔案。

  4. 按一下 提交.

    BRE CSV 資料上傳範例 CSV 檔案。列標題分別為「ANI」、「擴充」和「操作」。
    包含資料的範例 CSV 文件
    刪除、更新和新增操作不區分大小寫。您也可以使用語法 725160001,,Delete 刪除資料。

存取 BRE 應用程式

您可以從 Webex 聯絡中心管理入口網站存取業務規則引擎應用程式。

  1. 登入 Webex 聯絡中心管理入口網站。
  2. 點選 業務規則 開啟業務規則引擎儀表板。

    BRE 使用身分識別服務和單一登入互動。如果您已經透過 Common Identity 登錄,則無需再次登入即可存取您組織的 BRE 實用程式。

系統會在新的瀏覽器標籤頁中開啟業務規則引擎(BRE)應用程式。儀表板頁面以圖形方式顯示規則數量和執行次數。BRE儀錶板

建立一套規則

Webex Contact Center 中流程呼叫業務規則引擎實用程式的示意圖。Webex Contact Center Flow Designer 中的流程控制 > 查詢請求 > Cisco BRE > 讀 > BRE 資料庫。

存取 BRE 入口網站並依照下列說明配置屬性、標籤、上下文和規則。

1

若要建立與您的組織關聯的屬性:

  1. 在「屬性」頁面上,選擇 屬性 並按 新增 。

  2. 在 名稱 欄位中輸入 context 。

  3. 從下拉清單中選擇 資料類型 作為 Text 。

    在 BRE 工具中,資料型態必須為 Text 。

  4. 按一下儲存。

2

標籤能為數據賦予意義。要建立一個 標籤:

  1. 在「標籤」頁面上,選擇 標籤 並按 新增 。

  2. 在 名稱 欄位中輸入標籤名稱。

  3. 按一下儲存。

3

點選 上下文 導航至 上下文 頁面。點選 +Add 情境.

  1. 輸入 名稱 ,即 BRE 資料列表中的 產生上下文 。

  2. 輸入可選的 描述。

  3. 如果建立了多個屬性,請從 屬性 下拉清單中選擇要與此上下文關聯的屬性。

  4. 按一下儲存。

4

若要建立規則,請導覽至 上下文 頁面。點選 +Add 規則編輯器 並配置以下詳細資訊:

  • 姓名: 請為該規則命名。
  • 描述: 規則的可選描述。
  • 積極的: 選取此複選框以啟用該規則。
  • 標籤: 請從下拉清單中選擇所需的標籤。
  • 優先事項: 拖曳滑桿為規則設定優先權。系統依照分配的優先權運行規則,從最高(100)到最低。建議您從 100 開始按降序分配優先順序。
  • 規則編輯器 (用於輸入程式碼的工具,如下圖所示):輸入規則代碼。

建立兩條規則:一個用於系統找到匹配項的情況,另一個用於系統未找到匹配項的情況。

下列範例程式碼傳回名為 routeInfo的屬性的值。如果來電者撥打的號碼 (ANI) 與上傳到 BRE 資料庫的租用戶清單中的 ANI 匹配,則會發生這種情況。複製以下規則並貼上到 規則編輯器中 :
when
c: Contact()
eval(c.getGlobalValuesManager().getAsString( c.getTenantId(),
c.getAttribute("context")+"."+
c.getAttribute("ani")) != null)
then
c.putAttribute("routeInfo",
c.getGlobalValuesManager().getAsString(c.getTenantId(),
c.getAttribute("context")+"." + c.getAttribute("ani")));
end
BRE Contexts 頁面範例程式碼傳回屬性 routeinfo 的 ANIFound 值。

以下範例程式碼傳回屬性 routeInfo] 的值 NotFound 。如果來電者撥打的號碼(ANI)與上傳到 BRE 資料庫的租用戶清單中的 ANI 不匹配,則會發生這種情況。複製以下規則並貼上到 規則編輯器中 :

when
c: Contact()
eval(c.getGlobalValuesManager().getAsString( c.getTenantId(),
c.getAttribute("context")+"." + c.getAttribute("ani")) == null)
then
c.putAttribute("routeInfo", "NotFound ");
end

BRE Contexts 頁面範例程式碼傳回屬性 routeinfo 的 ANINotFound 值。
5

按一下儲存。

BRE 請求

使用 BRE 請求活動從組織的業務規則引擎 (BRE) 中檢索數據,以便在流程中使用。BRE 請求活動使用標準 HTTP 協定從 BRE 取得資料。

以下各部分可用於設定 BRE 請求活動:

一般設定

參數

說明

活動標籤

請輸入活動名稱。

活動描述

(可選)請輸入活動描述。

查詢參數

作為 BRE 請求的一部分,您可以將 API 呼叫中提供的參數傳遞給 BRE。在「鍵值」欄位中,您可以輸入查詢的按鍵以及要隨查詢一起傳送的關聯值。您也可以使用雙花括號語法來傳遞變數值。

BRE 活動有一個預先定義的查詢參數:context. 此查詢參數透過 API 呼叫傳遞給 BRE。

TenantID 會自動作為參數注入,無需配置。

表 1. 查詢參數

參數

說明

內容

包含請求原因。此必填參數無法編輯或刪除。

此參數必須包含與 BRE 中屬性 context 指定的值相同的值。有關更多信息,請參閱 《 Cisco Webex Contact Center 業務規則引擎使用者指南》中的 「建立規則集 」部分。

ANI

包含呼叫發起方的電話號碼。這是一個預設參數,您可以根據 BRE 中的規則配置對其進行編輯或刪除。

ANI 的一個範例值為 {{NewContact.ANI}}

回應超時

指定 BRE 請求的連線逾時時間。預設值為 2000 毫秒。

重試次數

指定 BRE 請求失敗後嘗試的次數。

如果狀態碼為 5xx,則使用此參數。 ; 例如,500 或 501。

若要新增查詢參數,請按一下 新增。這將添加一行,您可以在其中輸入鍵值對。您可以在 BRE 請求中新增所需的任意數量的查詢參數。

解析設定

本部分可讓您將 BRE 請求的回應解析為不同的變數:

參數

說明

回應變數

選擇要從 BRE 請求回應物件中提取特定部分的變數。您只能從下拉清單中選擇自訂流程變數。

路徑表達式

定義用於解析回應物件的路徑表達式。根據回應對象的資料結構類型以及提取該資訊子集的用例,路徑表達式會有所不同。

在執行路徑表達式之前,資料會被規範化為物件層次結構,因此無論配置的內容類型為何,在回應物件中都會使用 JSONPath。

解密設定

您可以解密 BRE 請求活動的輸出變數。如果在串流層級啟用解密,則具有偵錯解密存取權的使用者可以在串流偵錯日誌中查看 BRE 請求活動的未封鎖輸出值。關閉 啟用解密 開關,即可在活動層級停用解密,以獲得額外保護。

輸出變數

BRE 請求回傳兩個輸出變數:

  • BRERequest1.httpResponseBody: 傳回 BRE 請求的回應正文。

  • BRERequest1.httpStatusCode: 傳回 BRE 請求的狀態碼。

    這些回應代碼分為以下幾類:

    • 資訊性回答(100-199)

    • 成功回覆(200–299)

    • 重定向(300–399)

    • 客戶端錯誤(400–499)

    • 伺服器錯誤(500–599)

內容類型格式

以下範例描述了範例輸入內容類型格式和 JSON 回應。

內容類型 XML

使用此工具將 XML 轉換為 JSON 格式 https://codeshack.io/xml-to-json-converter/。

XML輸入格式:


  Tove
  Jani
  Reminder
  Test application


Data/JSON 歸一化響應

{
   "note": {
      "to": "Tove",
      "from": "Jani",
      "heading": "Reminder",
      "body": "Test application"
   }
}

JSON 路徑表達式範例:使用 $.note.from 可以將值獲取為 Jani。

內容類型 TOML

使用此工具將 TOML 轉換為 JSON 格式 https://www.convertjson.com/toml-to-json.htm。

TOML 輸入格式:

title = "TOML Example"
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00

Data/JSON 歸一化響應

{
   "title": "TOML Example",
   "owner": {
      "name": "Tom Preston-Werner",
      "dob": "1979-05-27T15:32:00.000Z"
   }
}

JSON 路徑表達式範例:使用 $.owner.name 可以將值獲取為 ‘Tom Preston-Werner’。

內容類型 YAML

使用此工具將 YAML 轉換為 JSON 格式 https://www.convertjson.com/yaml-to-json.htm。

YAML 輸入格式:

# An employee record
martin:
  name: Martin D'vloper
  job: Developer
  skill: Elite

Data/JSON 歸一化響應

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

JSON 路徑表達式範例:使用 $.martin.job 取得值 Developer。

內容類型 JSON

使用 JSON 表達式求值器 https://jsonpath.com/。

JSON 輸入格式:

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

Data/JSON 歸一化響應

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

JSON 路徑表達式範例:使用 $.martin.job 取得值 Developer。

建立包含 BRE 請求活動的流程

您可以使用 Webex 聯繫中心提供的流程設計器介面建立流程。在 Webex 聯繫中心流程設計器中,使用 BRE 請求 活動建立流程。

有關配置流程的更多信息,請參閱 BRE 請求。

常見問題及解答

  1. 方括號 attribute的作用是什麼?

    Attributes 對於將傳入的 BRE 查找請求與 BRE 中定義的特定規則集關聯起來,以及儲存規則評估結果,它們至關重要。

  2. 如何創建attributes?

    在 attributes 配置 下建立 > BRE 實用程式中的屬性。例如,您可以建立一個名為 context的屬性。

  3. 的用途是什麼? context

    Context 定義 BRE 應用的特定場景或尋找類型。當流程呼叫 BRE 請求活動時,它需要告訴 BRE 要評估哪一組規則。一個屬性(通常命名為 Context )被設定為特定域的名稱。

  4. 什麼是 domain?

    domain 是 BRE 中包含相關數據的表。網域引導 BRE 找到正確的資料及其對應的規則集。

  5. 什麼是 label?

    BRE 評估其規則後,必須將結果傳達回呼叫系統(例如,包含 BRE 請求活動的 Webex 聯繫中心流程)。規則透過配置,根據其條件設定指定標籤屬性的值。

  6. 屬性、上下文和標籤之間是什麼關係?

    例如,您可以建立一個名為 Attribute的 context。您可以將此屬性與 domain (實際表,例如 ANILookup)關聯。當呼叫 BRE 請求活動時,流程會設定此屬性的值(即 domain )。 = 使用 ANILookup 指定上下文(要使用哪個域的規則)。

    在方括號 domain內,使用 Drools 語法編寫規則來評估條件並設定另一個方括號 attribute的值,該方括號通常稱為 label (例如, label )。 = "MatchFound")。這表示規則的結果,作為流程的回應回傳。

  7. 屬性、上下文和標籤與請求的查詢參數有何關係?

    BRE 由流程調用,通常是透過 API 呼叫(BRE 請求活動)到硬編碼的內部 URL。這是一個 REST API,用於尋找以 CSV 格式上傳的 BRE 值。 (key/value 成對的)。BRE 做出決策所需的資料會作為此請求的一部分傳遞,類似於查詢參數或請求正文在常規 REST API 呼叫中的作用。

    • Input Data: 來電資訊(如來電者的 ANI、帳號和其他類似資料)在 Webex 聯絡中心呼叫流程中被擷取為呼叫關聯資料 (CAD) 變數。
    • BRE Configuration Data: 其他必要參數,例如上下文和指定域的屬性(例如,域)。 = ANILookup),也被設定為流程的 BRE 請求節點中的變數。
    • Request Variables: 在流程的 BRE 請求步驟中,CAD 變數和設定變數被選為 BRE 請求配置中的變數。然後,這些變數會被傳送到 BRE 的執行後端引擎。
    • Function: 從本質上講,「請求變數」充當 BRE 的「查詢參數」或輸入有效負載。BRE 使用這些傳入值來評估其規則中定義的條件。

使用業務規則引擎配置基於 ANI 的客戶資料查找

此範例工作流程使用業務規則引擎 (BRE) 透過呼叫者的自動號碼識別 (ANI) 尋找客戶數據,在 Webex 聯絡中心流程中處理傳回的數據,並在座席桌面顯示選定的資訊。具體步驟如下:

準備查找數據

建立一個包含唯一查找鍵及其關聯資料的 CSV 檔案。對於此工作流程,呼叫者的 ANI 用作查找鍵。將一個或多個客戶欄位儲存在值列中。用豎線(|)分隔多個欄位。

15551234567,VIP Customer|John Smith|Premium Queue|Toronto 15559876543,Standard Customer|Jane Smith|General Queue|Vancouver

在這個例子中,第 1 列包含 ANI,第 2 列包含客戶類型、客戶名稱、佇列和位置。

BRE 旨在用於以讀取為導向的查找,而不是作為用於頻繁更新單一記錄的事務資料庫。

建立 BRE 查詢類型並上傳數據

開啟 Webex Contact Center BRE 資料同步工具並選擇您的租用戶。如果所需的查找類型不可用,請維運團隊建立它。使用描述性名稱,例如 ANILookup。記錄產生的上下文名稱,因為 BRE 配置和流程必須使用相同的區分大小寫的值。

新增測試記錄:

  1. 開啟 新增資料。
  2. 選擇租戶和 ANILookup。
  3. 請輸入ANI及其對應值。
  4. 提交記錄。

若要載入完整資料集,請開啟 上傳 BRE,選擇租用戶和尋找類型,然後上傳 CSV 檔案。開啟 BRE 資料清單 並確認記錄是否出現。確保 CSV 檔案中的 ANI 格式與流程傳送的格式一致。

啟動業務規則

登入 Webex 聯絡中心管理門戶,開啟 業務規則,然後啟動 BRE 儀表板:

建立上下文屬性:

  1. 導覽至 首頁 > 屬性 > .
  2. 新增一個屬性,並賦予以下值:
    • 名稱: context
    • 資料類型: 文字
  3. 保存結果屬性。 context 屬性標識規則查詢的已上傳查找資料集。
  4. 新增一個表示傳回資料的文字屬性。即使傳回值包含多個以豎線分隔的字段,也要給屬性一個有意義的名稱。保存該屬性。在這個例子中, customerType 用作範例。
  5. 開啟 上下文 並新增上下文。輸入產生的資料同步上下文名稱,例如 ANILookup,將其與 context 屬性關聯,然後儲存。上下文名稱區分大小寫,並且必須與產生的資料同步上下文完全匹配。

建立 ANI 找到規則和 ANI 未找到規則

開啟上下文並選擇 新增規則編輯器。將規則命名為 ANIFound,啟動它,並為其分配更高的優先級,例如 100。新增以下規則並儲存:

when c: Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context") + "." + c.getAttribute("ani") ) != null) then c.putAttribute( "customerType", c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context") + "." + c.getAttribute("ani") ) ); end

此規則將上下文和 ANI 結合起來形成查找鍵。當存在匹配值時,將結果賦值給 customerType 響應屬性。

新增另一條名為 ANINotFound的活動規則。為其分配一個較低且唯一的優先級,例如 99。配置規則,當不存在匹配記錄時將 customerType 設為 Not Found ,並儲存。不要給這兩條規則相同的優先權。

建立聯絡中心流程

開啟流程設計器,建立或開啟測試流程。在流程必須檢索呼叫者資訊的位置新增 BRE 請求 活動,並將該活動連接到對應的流程路徑。

將ANI標準化

如果上傳的金鑰缺少 +1 國家代碼前綴,則建立預處理表達式,將其從 ANI 中刪除:

ANI.replace("+1", "")

使用歸一化值作為查找鍵。僅當儲存的值不包含方括號 +1時才套用此轉換。 ; 請求值和上傳的金鑰必須使用相同的格式。

配置 BRE 請求

請使用以下值配置活動:

  • 情境: ANILookup
  • 請求屬性: ani
  • 請求值: 標準化ANI
  • 逾時: 5秒
  • 重試次數: 3
  • 響應屬性: customerType

將回應映射到字串流變數。上下文選擇資料集,而 ani 提供單一記錄鍵。

處理多字段回應

如果 BRE 傳回 VIP Customer|John Smith|Premium Queue|Toronto,則使用轉義管道分隔符號 (\|) 分割字串。結果元素包含客戶類型、客戶姓名、佇列和位置。將所需元素分配給不同的流量變數。該演示提取了最後一個元素, Toronto。

配置螢幕彈出

新增或配置代理桌面螢幕彈出活動。將提取的客戶資訊對應到所需的螢幕彈出字段,將流程連接到佇列或代理程式路由路徑,然後儲存並發佈流程。

測試演示

使用已上傳資料集中的 ANI 發起呼叫。確認流程規範化了 ANI,BRE 請求遵循其成功路徑,並且提取的資訊出現在代理桌面中。使用資料集中不存在的 ANI 重複測試,並確認未找到的路徑返回配置的回退值。

簡介

思科商業規則引擎是一個應用程式,可協助您在 Webex 聯絡中心內快速查找資料。 使用思科商業規則引擎 (BRE),您可以執行資料 查詢、自訂路由和一般實作。 系統會在執行階段擷取資料 ,並將其用於路由決策或向代理程式顯示資訊。

例如,承租人想根據撥號的 自動號碼識別 (ANI),將呼叫路由至特定的代理程式群組。 在這種情況下,租戶只 需上傳 ANI 清單。 如果傳入呼叫的 ANI 位於該清單中,系統將呼 叫路由至指定的代理程式群組。 如果 ANI 不在清單中, 系統將呼叫路由到一般佇列。

典型的 BRE 實現涉及以下主要組件:

  • BRE DataSync:BRE DataSync 組態公用程式提供了一個介面,用 於定義將資料匯入 BRE 資料庫的資料同步執行個體。 承租 人定義資料同步執行個體之後,承租人可以上傳 CSV 檔案。 系統將上傳的逗號分隔值資料轉換為 BRE 資料庫中的記錄。

  • 商業規則引擎:商業規則引擎公用程式提供 用於建立網域和規則集的介面。 BRE 要求傳入的 決策請求與網域相關聯。 網域包含一 組規則。 每個規則都會指定優先順序。 BRE 會根據規則中的條 件嘗試將網域的最高優先順序規則與決策 請求匹配。

  • 流程設計工具:用於定義管理和自動化 Webex 聯絡中心 元件的流程的拖放使用者介面。 您可以建立呼叫 BRE 活動的流程,以執行類似 HTTP 請求活動 的簡單資料查詢。 但是,在這種情況下,資料會 位於 Webex 聯絡中心內。

資料處理指引

為了維持 BRE 的完整性和安全性,您必須遵守下列 資料處理準則:

  • 允許的資料類型:上傳對 BRE 的作業 和功能至關重要的資料。 這包括但不限於商業 規則、組態和非敏感的作業資料。

  • PII 限制:除 ANI 數據以外,切勿將任何個 人身份識別信息(PII)上傳到 BRE。 PII 包括但不限 於:

    • 全名
    • 社會安全號碼
    • 電子郵件地址
    • 實體地址
    • 財務資訊

ANI 數據是指與呼叫方相關聯的電話號碼。 ANI 資料 是唯一允許上傳至 BRE 的 PII 類型。 此例外 是為了支援依賴 ANI 資料的特定業務功能。

業務規則引擎實作

商業規則引擎由與入口點關聯的流 程呼叫的即時規則引擎。 此規則引擎通常會諮詢資料 儲存庫,以評估所需的呼叫處理。

BRE 查詢是流程中的簡單數據跳,就像 HTTP 請求一樣。 但是,BRE 查找的資料位於Cisco Webex Contact Center資料中心內。 下 圖顯示了 BRE 資料查找所涉及的各種程序。

在開始之前

在實作 BRE 之前:

  • 透過清楚瞭解資料模型,設定 BRE DataSync 執行個體 ,以便您的實作。
  • 熟悉本指南中使用的以下術語:
    • 屬性:屬性是在 BRE 公用程式中建立的具名 變數或資料欄位。 它作 為 BRE 用於處理請求和生成輸出的信 息的容器。
    • 前後關聯:前後關聯 主要用作為指定 BRE 請求活動的目標網 域的屬性的範例名稱。
    • 標籤:標籤是專為保留 規則評估的輸出或結果而設計的特定 屬性類型。

如需詳細資訊,請參閱常見問題集部分。

設定 BRE 資料同步執行個體

BRE DataSync 公用程式會存取資料庫以做出路由決定。 確保定期使用適當的資訊更新資料庫。 本 節說明如何設定 BRE DataSync 公用程式以更新 BRE 儲存庫。

Diagram for how the BRE DataySync utility is configured to update the BRE repository. BRE DataSync > CRUD > BRE Repository.
BRE 數據同步實用程序

承租人管理員必須為規則引擎在決策過程中諮詢的每 個資料集建立 BRE DataSync 執行個體。 管理員可以建立資料集或上傳 CSV 檔案。 資料會轉換 為 BRE 儲存庫中的記錄。

在開始之前

請連絡思科客戶服務客戶經理,以取得 BRE DataSync 帳戶的存取權。

BRE 數據同步目前僅針對完整管理員角色啟用。 具有 完整管理員角色的租戶可以使用 CSV 檔案上傳或金 鑰值配對上傳資料。 具有此角色的使用者只能上傳其組織特定資料。

合作夥伴管理員、外部管理員、代理程式和監督無 法存取 BRE DataSync 公用程式。

1

以管理員身份登入 BRE DataSync 公用程式。

根據最近的 BRE 託管和可 擴展性的增強功能,DataSync 公用程式的 URL 已變更。 確保 使用更新的 URL 將數據上傳到 BRE。

特定區域的 BRE 數據同步網址如下:

https://bre-datasync.produs1.ciscoccservice.com/datasync/

https://bre-datasync.prodeu1.ciscoccservice.com/datasync/

https://bre-datasync.prodeu2.ciscoccservice.com/datasync/

https://bre-datasync.prodca1.ciscoccservice.com/datasync/

https://bre-datasync.prodjp1.ciscoccservice.com/datasync/

https://bre-datasync.prodsg1.ciscoccservice.com/datasync/

按一下 URL 以瀏覽至「使用通用 身分登入」 頁面。 對於美國地區,請選擇 美國叢集(而不是美國第二個 叢集)以進一步進行。

對於 ANZ 地區,沒有特定的網址。 選擇您的家用 CI 叢集以登入。 對於大多數用戶,美國和美國第二叢集鏈接可以 使用。

特定區域的 BRE 管理員 UI URL 是:

https://bre.produs1.ciscoccservice.com/bre/

https://bre.prodeu1.ciscoccservice.com/bre/

https://bre.prodeu2.ciscoccservice.com/bre/

https://bre.prodca1.ciscoccservice.com/bre/

https://bre.prodjp1.ciscoccservice.com/bre/

https://bre.prodsg1.ciscoccservice.com/bre/

2

選取 BRE 資料清單可檢視與承租人組織 相關的所有資訊。

3

若要將資料作為鍵值配對新增至 BRE 儲存庫:選取「新增 BRE 資料 」

  1. 從租戶名稱 下拉式清單中選取組織名稱。

  2. 從下拉式 清單中選取 BRE 查找類型。

    如需新增 BRE 查找 類型,請參閱下列大小限制:

    • BRE 查找類型的字元限制上限: VARCHAR(200)
    • 值欄位的最大字元限制: VARCHAR (500)
    • 每個組織的查詢類型數目上限: 100
    • 每個查找類型的資料列數上限:100K 行
    • 上傳檔案大小上限:10 MB

    請連絡思科客戶成功經理或解決方案保證 聯絡人,以新增查詢類型。

  3. 按一下「新增資料」以輸入金 鑰和值。

  4. (選擇性) 按一下「移除」以刪除現有 的金鑰和值。

  5. 按一下提交。

4

若要將 CSV 檔案上傳至 BRE 儲存庫:選取「上傳 BRE CSV 資料」。

  1. 從租戶名稱 下拉式清單中選取組織名稱。

  2. 從下拉式 清單中選取 BRE 查找類型。

  3. 選取 [上傳] 以瀏覽並上傳 CSV 檔案。

  4. 按一下提交。

    Sample CSV file for the BRE CSV data upload. Column headers are 'ANI', 'Extension', and 'Action'.
    帶有數據的範例 CSV 文件
    「刪除」、「更新」和「新增」動作不區分大小寫。 您 也可以使用語法 725160001、, 刪除來刪除資料。

存取 BRE 應用程式

您可以從 Webex 聯絡中心存取商業規則引擎應用程式:

  1. 登入 Control Hub。
  2. 導覽至服務 > 聯絡中心 。
  3. 在右窗格的「快速連結」區段下,按一下「 商業規則引擎」。

    BRE 使用身分識別服務和單一登入互動。 如果租戶 已登入 Control Hub,則可以自動取得其組織的 BRE 公用 程式的存取權。

系統會在新的瀏覽器標籤中開啟商業規則引擎 (BRE) 應用程式,並 且您會自動登入應用程式。 顯示「儀表板」頁面,其 中包含規則數和執行次數的圖形表示。BRE Dashboard

建立一組規則

Diagram of the Business Rule Engine utility being invoked by a flow in Webex Contact Center. Flow control in Webex Contact Center Flow Designer > Lookup Request > Cisco BRE > Read > BRE Repository.

存取 BRE 入口網站並設定屬性、標籤、前後關聯和規則,如下所 述。

1

若要建立屬性 (用於與您的組織建立關聯):

  1. 選擇屬性。 按一下「 屬性」頁面上的「新增」。

  2. 在「名稱」欄位中,輸入前後 關聯。

  3. 從下拉式清單中選擇文字作為資料類型 。

    在 BRE 實用程式中,資料類型必須是文字。

  4. 按一下儲存。

2

標籤為您的數據增加了意義。 若要建立 標籤:

  1. 選擇「標籤」,然後按一下「 標籤」頁面上的新增。

  2. 在「名稱」欄位中輸入標籤的名稱 。

  3. 按一下儲存。

3

按一下「前後關聯」以導覽至「前 後關聯」頁面 按一下「+ 新增前後關 聯」。

  1. 在 BRE 資料清單中輸入 「 產生前後關聯」的名稱。

  2. 輸入選擇性的「描述」。

  3. 如果已建立多個屬性,請從「屬性」下拉式 清單中選取要與此前後關聯的屬性。

  4. 按一下儲存。

4

若要建立規則,請瀏覽至「前後關聯」 頁面。 按一下 + 新增規則編輯器,並設定下列 詳細資訊:

  • 名稱:為規則提供名稱。
  • 說明:規則的選擇性 描述。
  • 作用中:勾選核取方塊以指定規 則處於作用中狀態。
  • 標籤:從下 拉式清單中選擇所需的標籤。
  • 優先順序:拖曳滑桿以指定優先順序給 規則。 系統會根據指派的優先順序執行規則,從 最高 (100) 到最低。 建議您開始按遞減順序從 100 開始指定優先順序。
  • 規則編輯器(用於輸入代碼的工具,如下面 的屏幕截圖所示):輸入規則的代碼。

創建兩個規則:一個是系統找到匹配的時候,另一個是 系統找不到匹配的時候。

下列範例程式碼會傳回名為 RouteInfo 屬性的值。 如果來電者撥號 (ANI) 的號碼與上傳至 BRE 資料庫的租戶清單上的 ANI 相符,就會發生這種情況。 在規則 編輯器中複製並貼上下列規則:
when
c: Contact()
eval(c.getGlobalValuesManager().getAsString( c.getTenantId(),
c.getAttribute("context")+"."+
c.getAttribute("ani")) != null)
then
c.putAttribute("routeInfo",
c.getGlobalValuesManager().getAsString(c.getTenantId(),
c.getAttribute("context")+"." + c.getAttribute("ani")));
end
BRE Contexts page with an example code returns value for ANIFound for attribute routeinfo.

下列範例程式碼會傳回「路由資訊」 屬性的「未找到」值。 如果來電者撥打的號碼 (ANI) 與上 傳至 BRE 資料庫的租戶清單中的 ANI 不符,就會發生這種情 況。 在規則 編輯器中複製並貼上下列規則:

when
c: Contact()
eval(c.getGlobalValuesManager().getAsString( c.getTenantId(),
c.getAttribute("context")+"." + c.getAttribute("ani")) == null)
then
c.putAttribute("routeInfo", "NotFound ");
end

BRE Contexts page with an example code returns value for ANINotFound for attribute routeinfo.
5

按一下儲存。

BRE 要求

使用 BRE 請求活動從組織的商業規則引 擎 (BRE) 擷取資料,以便在流程中使用。 BRE 請求活動使用標準 HTTP 通訊協 定從 BRE 擷取資料。

下列段落可讓您設定 BRE 請求活動:

一般設定

參數

說明

活動標籤

輸入活動的名稱。

活動說明

(選擇性) 輸入活動的描述。

查詢參數

作為 BRE 請求的一部分,您可以將 API 呼叫中提供的參數傳遞給 BRE。 在「關鍵值」欄中,您可以輸入查詢的索引 鍵以及要與查詢一起傳送的關聯值。 您也可以使用 雙括號語法傳遞變數值。

BRE 活動具有一個預先定義的查詢參數:前後關聯。 此查詢參數 在 API 呼叫中傳遞給 BRE。

TenantID 會自動作為參數插入,不需要配置。

表一。查詢參數

參數

說明

前後關聯

包含請求的原因。 無法編輯或刪除此強制 參數。

此參數必須包含與 BRE 中「屬性」前後關聯中指定的值相同。 如需詳細資訊,請參閱「Cisco Webex Contact Center商業規則引擎使用指南」中的「建立一組規則」段落。

ANI

包含來電的原始電話號碼。 這 是您可以根據 BRE 中的規則組態來編輯或刪除 的預設參數。

ANI 的樣本值為 {{新聯絡人。ANI}}

回應逾時

指定 BRE 請求的連線逾時。 預設值設定為 2000 毫秒。

重試次數

指定在失敗後嘗試 BRE 請求的次數。

如果狀態代碼為 5xx,則會使用此參數;例如,500 或 501。

若要新增查詢參數,請按一下「新增」。 這會新增一列, 您可以在其中輸入索引鍵值對。 您可以根據需要新增任意數量的查詢參數 作為 BRE 請求的一部分。

解析設定

本節可讓您將 BRE 請求中的回應解析成不同的變量:

參數

說明

回應變數

選擇要從 BRE 請求回應對象中擷取特定區段的變數。 您只能從下拉式清單中選擇 「自訂流程」變數。

路徑表示式

定義用於剖析回應物件的路徑運算式。 根據回應物件的資料結構類型以及擷取 該資訊子集的使用案例,「路徑運算式」會有所不同 。

在執行路徑表示式之前,資料會標準化為物件階層,因此 無論設定的內容 類型為何,都會在回應物件中使用 JSONPath。

解密設定

您可以解密 BRE 請求活動的輸出變數。 如果在流程層級 啟用解密,具有除錯解密存取權的使用者可以在流程偵錯記錄檔中檢視 BRE Request 活動的未遮罩 輸出值。 關閉 啟用解密切換,以停用活動層級的解密以獲 得額外保護。

輸出變數

BRE 請求返回兩個輸出變數:

  • BRERequest1. HttpResponseBody:傳回 BRE 請求的回應主體。

  • BREREQUEST1. HTTPStatusCode:傳回 BRE 請求的狀態代碼。

    這些回應代碼分為以下類別:

    • 資訊回應 (100—199)

    • 成功回應 (200—299)

    • 重新導向 (300 至 399)

    • 用戶端錯誤 (400 至 499)

    • 伺服器錯誤 (500—599)

內容類型格式

下列範例說明範例輸入內容類型格式和 JSON 回應。

內容類型 XML

使用此工具將 XML 轉換為 JSON 格式 https://codeshack.io/xml-to-json-converter/。

XML 輸入格式:

<note>
  <to>Tove</to>
  <from>Jani</from>
  <heading>Reminder</heading>
  <body>Test application</body>
</note>

數據/JSON 標準化響應

{
   "note": {
      "to": "Tove",
      "from": "Jani",
      "heading": "Reminder",
      "body": "Test application"
   }
}

範例 JSON 路徑運算式:使用 $.note.from 獲取為 Jani 的值。

內容類型 TOML

使用此工具將 TOML 轉換為 JSON 格式 https://www.convertjson.com/toml-to-json.htm。

TOML 輸入格式:

title = "TOML Example"
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00

數據/JSON 標準化響應

{
   "title": "TOML Example",
   "owner": {
      "name": "Tom Preston-Werner",
      "dob": "1979-05-27T15:32:00.000Z"
   }
}

範例 JSON 路徑運算式:使用 $.owner.name 獲取「湯姆·普雷斯頓-韋納」的值。

內容類型 YAML

使用此工具將 YAML 轉換為 JSON 格式 https://www.convertjson.com/yaml-to-json.htm。

YAML 輸入格式:

# An employee record
martin:
  name: Martin D'vloper
  job: Developer
  skill: Elite

數據/JSON 標準化響應

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

範例 JSON 路徑運算式:使用 $.martin.job 獲取值開發人員。

內容類型 JSON

使用 JSON 表示式評估器 https://jsonpath.com/。

JSON 輸入格式:

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

數據/JSON 標準化響應

{
   "martin": {
      "name": "Martin D'vloper",
      "job": "Developer",
      "skill": "Elite"
   }
}

範例 JSON 路徑運算式:使用 $.martin.job 獲取值開發人員。

使用 BRE 請求活動建立流程

您可以使用 Webex 聯絡 中心中提供的流程設計工具介面來建立流程。 在 Webex 聯絡中心流程設計師中使 用 BRE 請求活動建立流程。

如需有關設定流程的詳細資訊,請參閱 BRE 請求。

常見問題及解答

  1. 屬性的目的是什麼?

    屬性對於將傳入的 BRE 查詢請求連結至 BRE 中定義的特定規則集,以及儲存規則評估結果的基 本性。

  2. 你如何創建屬性?

    在 BRE 公用程式中的佈建 > 屬性下建立屬性。 例如,您可以建立名為前後關 聯的屬性。

  3. 上下文的目的是什麼?

    前後 關聯定義 BRE 套用的特定案例或查找類型。 當流程調用 BRE 請求活動時,它需要告訴 BRE 要評估哪一組規則。 一個 屬性,通常名為 Context,會設定為特定 網域的名稱。

  4. 什麼是網域?

    網域是 BRE 中包 含相關資料的表格。 網域名稱會引導 BRE 找到正確的 資料及其對應的規則集。

  5. 什麼是標籤?

    BRE 評估其規則之後,必須 將結果傳送回呼叫系統(例如,包含 BRE 請求活動的 Webex 聯絡中心 流程)。 規則設定為根據其條件設 定指定標籤屬性的值。

  6. 屬性、前後關聯和標籤之間有什麼關係?

    您可以 建立屬性,例如具名前後關聯。 您可 以將此屬性與網域(如 Ani Lookup 這樣的實際表 格)關聯。 調用 BRE 請求活動時,流程會設定此 屬性的值 (也就是網域 = AniLookup) 以指定前後關聯 (要使用哪個 網域的規則)。

    在該領域中,規則會以 Drools 語法編寫,以評估條件並設置另一個 屬性的值,通常稱為標籤( 例如,label =「matchFound」)。 這代表規則的結果 ,該結果作為流程回應。

  7. 屬性、前後關聯和標籤如何與請 求的查詢參數相關?

    BRE 是由 Flow 調用,通常通過 API 呼叫(BRE 請求活動)到硬編碼的 內部 URL。 這是一個 REST API,可以查找在 CSV 中上傳的 BRE 值(鍵/值配對)。 BRE 做出決定所需的資料會作為此請求的一部 分傳遞,類似於查詢參數或請求主體在常規 REST API 呼 叫中運作的方式類似。

    • 輸入資料:來電來電的資訊 (例如來電者的 ANI、帳戶號碼和其他類似資料) 會擷取為 Webex 聯絡中心 呼叫流程中的呼叫關聯 資料 (CAD) 變數。
    • BRE 組態資料:其他必要參數,例如 前後關聯和指定網域的屬性(例如,網域 = AniLookup),也會在 Flow 的 BRE 要求節點中設定為變數。
    • 請求變數:在流程的 BRE 請求步驟中,將 CAD 變數和已設定的變數選取為 BRE 請求 組態中的變數。 然後將這些變量發送到 BRE 的執行後端引擎。
    • 函數:基本上,「請求變量」充當 BRE 的 「查詢參數」或輸入有效負載。 BRE 使用這些輸入值來評 估其規則中定義的條件。

本文是否有幫助?
本文是否有幫助?