この記事の内容
dropdown icon
はじめに
    Cisco ビジネスルールエンジンについて
dropdown icon
ビジネスルールエンジンの実装
    はじめる前に
    ルールセットの作成
    BRE DataSync インスタンスを構成する
    BRE リクエストアクティビティを使用したフローの作成
    dropdown icon
    BRE リクエスト
      全般設定
      クエリパラメータ
      解析設定
      復号設定
      出力変数
    よくある質問

Webex Contact Center ビジネス ルール エンジン ユーザ ガイド

list-menuこの記事の内容
list-menuフィードバックがある場合

Webex Contact Center のビジネス ルール エンジン (BRE) を使用すると、顧客は実行時にシステムがアクセスできる特定のデータをアップロードして、ルーティングを決定したり、エージェントに情報を表示したりすることができます。nn

はじめに

Cisco ビジネスルールエンジンについて

Cisco© ビジネス ルール エンジン (BRE) を使用すると、カスタム ルーティングと一般的な実装のためにデータを Webex Contact Center 環境にアップロードできます。 システムは実行時にデータを取得し、ルーティングの決定やエージェントへの情報の表示に使用します。

たとえば、テナントは、ダイヤルされた自動番号識別 (ANI) に基づいて、特定のエージェント グループに通話をルーティングしたいと考えています。 このシナリオでは、テナントは ANI のリストをアップロードするだけで済みます。 着信コールの ANI がそのリストにある場合、システムは指定されたエージェント グループにコールをルーティングします。 ANI がリストにない場合、システムは通話を一般キューにルーティングします。

一般的な BRE 実装には、次の主要コンポーネントが含まれます。

  • ビジネス ルール エンジン ユーティリティ は、ドメインとルール セットを作成するためのインターフェイスを提供します。 BRE では、着信決定要求がドメインに関連付けられている必要があります ドメインには一連のルールが含まれています。 各ルールには優先度が割り当てられます。 BRE は、ルール内の条件に基づいて、ドメインの最も優先度の高いルールを決定要求と一致させようとします。

  • BRE DataSync 構成ユーティリティは、BRE データベースにデータをインポートするための Data Sync インスタンスを定義するためのインターフェイスを提供します。 テナントが Data Sync インスタンスを定義した後、テナントは CSV ファイルをアップロードできます。 システムは、アップロードされたコンマ区切り値データを BRE データベース内のレコードに変換します。

  • フロー デザイナー は、Webex Contact Center のコンポーネントを調整および自動化するフローを定義するために使用されるドラッグ アンド ドロップ ユーザ インターフェイスです。 BRE を呼び出すフローを作成できます。

データ取り扱いガイドライン

BRE の整合性とセキュリティを維持するには、次のデータ処理ガイドラインに従う必要があります。

  • 許可されるデータの種類: BRE の動作と機能に不可欠なデータをアップロードします。 これには、ビジネス ルール、構成、機密性のない運用データなどが含まれますが、これらに限定されません。

  • PII に関する制限: ANI データを除き、個人を特定できる情報 (PII) を BRE にアップロードしないでください。 PII には、以下のものが含まれますが、これらに限定されません。

    • フルネーム
    • 社会保障番号
    • メールアドレス
    • 物理アドレス
    • 財務情報

ANI データは、発信者に関連付けられた電話番号を指します。 ANI データは、BRE へのアップロードが許可される唯一の種類の PII です。 この例外は、ANI データに依存する特定のビジネス機能をサポートするためのものです。

ビジネス ルール エンジンの実装

はじめる前に

BRE を実装する前に、このガイド全体で使用されている次の用語を理解しておいてください。

  • 属性: アン 属性 BRE ユーティリティ内で作成された名前付き変数またはデータ フィールドです。 これは、BRE が要求を処理して出力を生成するために使用する情報のコンテナーとして機能します。
  • コンテクスト: A コンテクスト 主に、BRE 要求アクティビティの対象ドメインを指定する属性の例名として使用されます。
  • ラベル: A ラベル ルールの評価の出力または結果を保持するように設計された特定のタイプの属性です。

参照 よくある質問 詳細についてはセクションをご覧ください。

ルールセットの作成

新しい音声リクエストが ACD に提示されると、フローはビジネス ルール エンジン ユーティリティを呼び出します。 このセクションでは、BRE ユーティリティが ACD を支援して着信要求をルーティングできるようにルールを設定する方法について説明します。

Webex Contact Center 内のフローによって呼び出されるビジネス ルール エンジン ユーティリティの図。 Webex Contact Center フロー デザイナーでのフロー制御 > ルックアップ リクエスト > Cisco BRE > 読み取り > BRE リポジトリ。

BRE では、受信した決定要求をドメインおよび一連のルールに関連付ける必要があります。 BRE は、ルール内の条件に基づいて、最も優先度の高いルールを決定要求と一致させようとします。

すべてのケースをカバーするルールセットを必ず作成してください。 たとえば、次の両方のルールを作成する必要があります。 一致が見つかりました そして 一致するものが見つかりません 条件。 または、複数の条件に対してルールを設定することもできます。 例えば、 ANI マッチ または ANI ノーマッチ、それから または 。 この場合、可能性ごとにルールを作成する必要があります。 次に例を示します。

  • ANI マッチとゴールド

  • ANI マッチとシルバー

  • ANI ノーマッチとゴールド

  • ANI ノーマッチとシルバー

ルールセットを作成するには:

1

Cisco Webex Contact Center 管理ポータルにログインします。

2

パスをクリック Cisco Webex Contact Center 管理ポータル > ビジネスルール ビジネス ルール エンジン ユーティリティを開きます。

BRE は ID サービスとシングル サインオン インタラクションを使用します。 テナントがすでに Cisco Webex Contact Center 管理ポータルにログインしている場合は、組織の BRE ユーティリティに自動的にアクセスできます。

3

組織に関連付ける属性を作成します。

  1. 選択 属性 クリック 追加 上の 属性 ページ。

  2. オンザ 属性 ページ、入力 コンテクスト の中で 名前 分野。

  3. 選択してください データ型 として 文章 ドロップダウンリストから選択します。

    データ型は 文章 BRE ユーティリティで。

  4. [保存(Save)] をクリックします。

4

選択 コンテキスト 表示するには コンテキスト ページ。 クリック +コンテキストを追加

  1. 入力 名前 オプション 説明

  2. 複数の属性を作成する場合は、このコンテキストに関連付ける属性を 属性 ドロップダウンリスト。

  3. [保存] をクリックします。

5

ルールを作成するには、 コンテキスト ページ。

  1. クリック +ルールを追加 ページのセクションで、次の表に示す設定を指定します。

    フィールド

    Description

    Name

    ルールの名前。

    Description

    ルールのオプションの説明。

    アクティブ

    ルールがアクティブであることを指定するには、チェックボックスをオンにします。

    [ラベル(Label)]

    ドロップダウン リストから必要なラベルを選択します。

    Priority

    スライダーをドラッグしてルールに優先順位を割り当てます。 システムは、割り当てられた優先度(最高(100)から最低)に基づいてルールを実行します。

    優先順位は 100 から降順で割り当てることをお勧めします。

    条件

    ドロップダウン リストから条件を指定し、属性と値を選択します。

  2. クリック ルールの追加(エディター) ページのセクションで、次の表に示す設定を指定します。

    フィールド

    Description

    Name

    ルールの名前。

    Description

    ルールのオプションの説明。

    アクティブ

    ルールがアクティブであることを指定するには、チェックボックスをオンにします。

    [ラベル(Label)]

    ドロップダウン リストから必要なラベルを選択します。

    Priority

    スライダーをドラッグしてルールに優先順位を割り当てます。 ルールは、割り当てられた優先度(最高(100)から最低)に基づいて実行されます。

    条件

    ドロップダウン リストから条件を選択し、属性と値を指定します。

    ルールエディター

    ルールのコードを入力します。

  3. [保存] をクリックします。

次のサンプルコードは、次の属性の値を返します。 ルート情報。 これは、発信者がダイヤルした番号 (ANI) が、BRE データベースにアップロードされているテナントのリストにある ANI と一致する場合に発生します。 次のルールをコピーして貼り付けます ルールエディター:
c: Contact() が eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+"."+ c.getAttribute("ani")) != null) の場合、c.putAttribute("routeInfo", c.getGlobalValuesManager().getAsString(c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute("ani")));終わり
BRE Contexts page with an example code returns value for ANIFound for attribute routeinfo.

次のサンプルコードは値を返します 見つかりません 属性について ルート情報。 これは、発信者がダイヤルした番号 (ANI) が、BRE データベースにアップロードされたテナントのリストにある ANI と一致しない場合に発生します。 次のルールをコピーして貼り付けます ルールエディター:

c: Contact() の場合、eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute("ani")) == null) then c.putAttribute("routeInfo", "NotFound ");終わり

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

BRE DataSync インスタンスを構成する

BRE DataSync はデータベースにアクセスしてルーティングの決定を行います。 適切な情報でデータベースを定期的に更新してください。 このセクションでは、BRE リポジトリを更新するために BRE DataSync ユーティリティを構成する方法について説明します。

Diagram for how the BRE DataySync utility is configured to update the BRE repository. BRE DataSync > CRUD > BRE Repository.
BRE DataSync ユーティリティ

テナント管理者は、意思決定プロセス中にルール エンジンが参照するデータ セットごとに BRE DataSync インスタンスを作成する必要があります。 管理者はデータセットを作成するか、CSV ファイルをアップロードできます。 データは BRE リポジトリ内のレコードに変換されます。

はじめる前に

BRE DataSync アカウントにアクセスするには、Cisco カスタマー サービス アカウント マネージャーに問い合わせてください。

BRE DataSync は現在、 完全な管理者 役割。 完全な管理者ロールを持つテナントは、CSV ファイルのアップロードまたはキーと値のペアを使用してデータをアップロードできます。 このロールを持つユーザは、組織固有のデータのみをアップロードできます。

パートナー管理者、外部管理者、エージェント、スーパーバイザーは、BRE DataSync ユーティリティにアクセスできません。

1

管理者として、BRE DataSync ユーティリティにログインします。

BRE ホスティングおよびスケーラビリティの最近の機能強化に従って、DataSync ユーティリティの URL が変更されました。 更新された URL を使用して BRE にデータをアップロードしてください。

2

選択 BRE データリスト テナント組織に関連するすべての情報を表示します。

3

(オプション)選択 BRE データを追加する BRE リポジトリにデータを追加します。

  1. 組織名を テナント名 ドロップダウンリスト。

  2. 選択してください BRE ルックアップタイプ ドロップダウンリストから選択します。

    新しいルックアップ タイプを追加するには、Cisco カスタマー サクセス マネージャーまたはソリューション保証担当者に問い合わせてください。

  3. クリック データを追加 入力する そして 価値

  4. (オプション)クリック 取り除く 既存のものを削除する そして 価値

  5. [送信(Submit)] をクリックします。

4

選択 BRE CSV データをアップロード CSV ファイルをアップロードします。

  1. 組織名を テナント名 ドロップダウンリスト。

  2. 選択してください BRE ルックアップタイプ ドロップダウンリストから選択します。

  3. 選択 アップロード CSV ファイルを参照してアップロードします。

  4. [送信(Submit)] をクリックします。

    Sample CSV file for the BRE CSV data upload. Column headers are 'ANI', 'Extension', and 'Action'.
    データを含むサンプル CSV ファイル
    削除、更新、追加のアクションでは大文字と小文字は区別されません。 構文を使用することもできます 725160001,,削除 データを削除します。

BRE リクエストアクティビティを使用したフローの作成

Webex Contact Center 管理ポータルで利用可能な Flow Designer インターフェイスを使用してフローを作成できます。 フローを作成する BRE リクエスト Webex Contact Center フロー デザイナーでのアクティビティ。

フローの設定の詳細については、 BRE リクエスト

BRE リクエスト

BRE 要求アクティビティを使用して、フローで使用するデータを組織のビジネス ルール エンジン (BRE) から取得します。 BRE 要求アクティビティは、標準の HTTP プロトコルを使用して BRE からデータを取得します。

次のセクションでは、BRE 要求アクティビティを構成できます。

全般設定

パラメータ

説明

アクティビティラベル

アクティビティの名前を入力します。

アクティビティの説明

(オプション)アクティビティの説明を入力します。

クエリパラメータ

BRE 要求の一部として、API 呼び出しで提供されるパラメーターを BRE に渡すことができます。 キー値列では、クエリのキーと、クエリと一緒に送信する関連値を入力できます。 変数値を渡すために二重中括弧構文を使用することもできます。

BRE アクティビティには、定義済みのクエリ パラメータが 1 つあります。 コンテクスト。 このクエリ パラメータは、API 呼び出しで BRE に渡されます。

その テナント ID パラメータとして自動的に挿入されるため、構成する必要はありません。

表 1. クエリパラメータ

パラメータ

説明

コンテキスト

リクエストの理由が含まれます。 この必須パラメータは編集または削除できません。

このパラメータには、属性で指定された値と同じ値が含まれている必要があります。 コンテクスト BRE で。 詳細については、 ルールセットの作成 セクションの Cisco Webex Contact Center ビジネス ルール エンジン ユーザ ガイド

アニ

通話の発信元の電話番号が含まれます。 これは、BRE のルール構成に基づいて編集または削除できるデフォルトのパラメーターです。

ANI のサンプル値は {{新しい電話連絡先.ANI}}

応答タイムアウト

BRE 要求の接続タイムアウトを指定します。 デフォルトは 2000 ミリ秒に設定されています。

再試行回数

失敗後に BRE 要求を試行する回数を指定します。

このパラメータは、ステータス コードが 5xx (たとえば 500 または 501) の場合に使用されます。

クエリパラメータを追加するには、 新規追加。 これにより、キーと値のペアを入力できる行が追加されます。 BRE リクエストの一部として、必要な数のクエリ パラメータを追加できます。

解析設定

このセクションでは、BRE リクエストからの応答をさまざまな変数に解析できます。

パラメータ

説明

応答変数

BRE リクエスト応答オブジェクトから特定のセクションを抽出する変数を選択します。 ドロップダウン リストから選択できるのは、カスタム フロー変数のみです。

パス式

応答オブジェクトを解析するためのパス式を定義します。 応答オブジェクトのデータ構造の種類と、その情報のサブセットを抽出するユースケースに応じて、パス式は異なります。

データはパス式の実行前にオブジェクト階層に正規化されるため、構成されたコンテンツ タイプに関係なく、応答オブジェクトでは JSONPath が使用されます。

復号設定

BRE リクエスト アクティビティの出力変数を復号化できます。 フロー レベルで復号化が有効になっている場合、デバッグ復号化アクセス権を持つユーザは、フロー デバッグ ログで BRE 要求アクティビティのマスクされていない出力値を表示できます。 TURN 復号化を有効にする トグルをオフにして、アクティビティ レベルで復号化を無効にし、保護を強化します。

出力変数

BRE リクエストは 2 つの出力変数を返します。

  • 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>リマインダー</heading><body>テストアプリケーション</body></note> 

データ/JSON 正規化レスポンス

{ "note": { "to": "Tove", "from": "Jani", "heading": "リマインダー", "body": "テストアプリケーション" } } 

JSON パス式の例: $.note.from を使用して、 Jani として値を取得します。

コンテンツタイプ TOML

このツールを使用して、TOML を JSON 形式に変換します https://www.convertjson.com/toml-to-json.htm

TOML 入力形式:

title = "TOML の例" [所有者] name = "Tom Preston-Werner" 生年月日 = 1979-05-27T07:32:00-08:00 

データ/JSON 正規化レスポンス

{ "title": "TOML の例", "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 入力形式:

# 従業員レコード martin: 名前: Martin D'vloper 職業: 開発者 スキル: エリート 

データ/JSON 正規化レスポンス

{ "martin": { "name": "Martin D'vloper", "job": "開発者", "skill": "エリート" } } 

JSON パス式の例: $.martin.job を使用して、 Developer の値を取得します。

コンテンツタイプ JSON

JSON 式エバリュエーター https://jsonpath.com/ を使用します。

JSON 入力形式:

{ "martin": { "name": "Martin D'vloper", "job": "開発者", "skill": "エリート" } } 

データ/JSON 正規化レスポンス

{ "martin": { "name": "Martin D'vloper", "job": "開発者", "skill": "エリート" } } 

JSON パス式の例: $.martin.job を使用して、 Developer の値を取得します。

よくある質問

  1. 属性の目的は何ですか?

    属性 は、受信した BRE 検索要求を BRE で作成された特定のルール セットにリンクし、ルール評価の結果を保存するために不可欠です。

  2. 属性はどうやって作成するのでしょうか?

    BRE ユーティリティの [プロビジョニング] & 属性 を作成します。 たとえば、 context という名前の属性を作成できます。

  3. コンテキストの目的は何ですか?

    コンテキスト は、BRE が適用する必要がある特定のシナリオまたはルックアップ タイプを定義します。 フローが BRE 要求アクティビティを呼び出す場合、評価するルール セットを BRE に伝える必要があります。 多くの場合 Context という名前の属性が、特定のドメインの名前に設定されます。

  4. ドメインとは何ですか?

    ドメイン は、関連データが含まれる BRE 上のテーブルです。 この値は、BRE を正しいドメインのデータと対応するルール セットに誘導します。

  5. ラベルとは何ですか?

    BRE はルールを評価した後、その結果を呼び出し元システムに返す必要があります (たとえば、BRE 要求を含む Webex Contact Center フロー)。 ルールは、条件に基づいて指定されたラベル属性の値を設定するために記述されます。

  6. 属性、コンテキスト、ラベルの関係は何ですか?

    たとえば、 context という名前の 属性 を作成します。 この属性を ドメイン (ANILookup のような実際のテーブル) に関連付けます。 BRE を呼び出すときに、フローはこの属性の値 (つまり、 domain = ANILookup) を設定して、コンテキスト (使用するドメインのルール) を指定します。

    その中で ドメインルールは Drools 構文で書かれ、条件を評価して別の値を設定する。 属性、しばしば ラベル (例えば、 ラベル = "MatchFound" であり、これはフローへの応答として返されるルールの結果を表します。

  7. 属性、コンテキスト、ラベルはリクエストのクエリ パラメータとどのように関連していますか?

    BRE は、通常、ハードコードされた内部 URL への API 呼び出し (BRE リクエスト ノード/アクティビティ) を通じてフローによって呼び出されます。 これは、CSV (キー/値のペア) にアップロードされた BRE 値の検索を可能にする REST API です。 BRE が決定を下すために必要なデータは、このリクエストの一部として渡されます。これは、通常の REST API 呼び出しでクエリ パラメータまたはリクエスト ボディが機能する方法に似ています。

    • 入力データ: 着信コールの情報 (発信者の ANI、アカウント番号、その他の同様のデータなど) は、Webex Contact Center コールフローでコール関連データ (CAD) 変数としてキャプチャされます。
    • BRE 構成データ: コンテキストやドメインを指定する属性 (例: domain = ANILookup) などのその他の必要なパラメータも、フローの BRE 要求ノードで変数として設定されます。
    • リクエスト変数: フローの BRE リクエスト ステップでは、CAD 変数と構成された変数が BRE リクエスト構成の変数として選択されます。 これらの変数は、BRE の実行バックエンド エンジンに送信されます。
    • 機能: 基本的に、「リクエスト変数」は BRE の「クエリ パラメータ」または入力ペイロードとして機能します。 BRE はこれらの入力値を使用して、ルールで定義された条件を評価します。

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?