دليل مستخدم محرك قواعد أعمال مركز اتصال Webex

يتكون محرك قواعد الأعمال من محرك قواعد في الوقت الفعلي يتم استدعاؤه من خلال التدفق المرتبط بنقطة الدخول. يتشاور محرك القواعد هذا عادةً مع مستودع البيانات لتقييم معالجة المكالمات المطلوبة.

بحث BRE هو عبارة عن غمس بسيط للبيانات داخل التدفق الخاص بك، مثل طلب HTTP. ومع ذلك، فإن بيانات بحث BRE موجودة داخل مركز Cisco Webex Contact Center البيانات. تعرض الصورة التالية العمليات المختلفة المتضمنة في البحث عن بيانات BRE.

قبل أن تبدأ

قبل تنفيذ BRE:

قم بتكوين مثيل BRE DataSync للتنفيذ الخاص بك مع فهم واضح لنموذج البيانات.
تعرف على المصطلحات التالية المستخدمة في هذا الدليل:
- السمة: السمة هي متغير مسمى أو حقل بيانات تم إنشاؤه داخل أداة BRE. إنه بمثابة حاوية للمعلومات التي تستخدمها BRE لمعالجة الطلبات وإنشاء المخرجات.
- السياق: يتم استخدام السياق بشكل أساسي كاسم مثال لسمة تحدد المجال المستهدف لنشاط BRE Request.
- التسمية: التسمية هي نوع معين من السمات المصممة للاحتفاظ بمخرجات أو نتيجة تقييم القاعدة.

راجع قسم الأسئلة الشائعة لمزيد من التفاصيل.

تكوين مثيل BRE DataSync

تصل أداة 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 لكل مجموعة بيانات تستشيرها Rules Engines أثناء عملية اتخاذ القرار. يمكن للمسؤول إنشاء مجموعة البيانات أو تحميل ملف CSV. يتم تحويل البيانات إلى سجلات في مستودع BRE.

قبل أن تبدأ

اتصل بمدير حساب خدمة عملاء Cisco للوصول إلى حساب BRE DataSync.

تم تمكين BRE DataSync حاليًا لدور المسؤول الكامل فقط. يمكن للمستأجرين الذين لديهم دور المسؤول الكامل تحميل البيانات إما باستخدام تحميل ملف CSV أو أزواج المفاتيح والقيمة. يمكن للمستخدمين الذين لديهم هذا الدور تحميل البيانات الخاصة بالمؤسسة فقط.

لا يمكن لمسؤول الشريك والمسؤول الخارجي والوكلاء والمشرفين الوصول إلى أداة BRE DataSync.

1	كمسؤول، قم بتسجيل الدخول إلى الأداة المساعدة BRE DataSync. وفقًا للتحسينات الأخيرة في استضافة BRE وقابلية التوسع، تغيرت عناوين URL لأداة DataSync. تأكد من استخدام عناوين URL المحدثة لتحميل البيانات إلى BRE. عناوين URL لـ BRE DataSync الخاصة بالمنطقة هي: 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، لا يوجد عنوان URL محدد. اختر مجموعة CI المنزلية لتسجيل الدخول. بالنسبة لمعظم المستخدمين، تعمل روابط المجموعة الثانية في الولايات المتحدة والولايات المتحدة. عناوين URL لواجهة مستخدم BRE Admin الخاصة بالمنطقة هي: 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 حدد اسم المؤسسة من القائمة المنسدلة TenantName. حدد نوع بحث BRE من القائمة المنسدلة. راجع قيود الحجم التالية لإضافة نوع بحث BRE: الحد الأقصى لعدد الأحرف لنوع بحث BRE: VARCHAR (200) الحد الأقصى لعدد الأحرف لحقل القيمة: VARCHAR (500) الحد الأقصى لعدد أنواع البحث لكل مؤسسة: 100 الحد الأقصى لعدد الصفوف لكل نوع بحث: 100 ألف صف الحد الأقصى لحجم الملف للتحميل: 10 ميغابايت اتصل بمدير نجاح عملاء Cisco أو جهة اتصال ضمان الحلول لإضافة أنواع بحث جديدة. انقر فوق إضافة بيانات لإدخال المفتاح والقيمة. (اختياري) انقر فوق إزالة لحذف مفتاح وقيمة موجودان. انقر فوق إرسال.
4	لتحميل ملف CSV إلى مستودع BRE: حدد تحميل بيانات BRE CSV. حدد اسم المؤسسة من القائمة المنسدلة TenantName. حدد نوع بحث BRE من القائمة المنسدلة. حدد تحميل لاستعراض ملف CSV وتحميله. انقر فوق إرسال. *نموذج ملف CSV مع البيانات* لا تتأثر إجراءات الحذف والتحديث والإضافة بحالة الأحرف. يمكنك أيضًا استخدام الصيغة `725160001، حذف لحذف` البيانات.

الوصول إلى تطبيق BRE

يمكنك الوصول إلى تطبيق محرك قواعد الأعمال من مركز اتصال Webex:

قم بتسجيل الدخول إلى مركز التحكم.
انتقل إلى الخدمات > مركز الاتصال.
ضمن قسم الارتباطات السريعة في الجزء الأيسر، انقر فوق مشغل قواعد الأعمال.
تستخدم BRE خدمة الهوية وتفاعل تسجيل الدخول الأحادي. إذا قام المستأجرون بتسجيل الدخول بالفعل إلى Control Hub، فيمكنهم الوصول تلقائيًا إلى أداة BRE لمؤسستهم.

يفتح النظام تطبيق Business Rules Engine (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	لإنشاء سمة (للربط مع مؤسستك): اختر السمات. انقر فوق إضافة في صفحة السمات. في حقل الاسم، أدخل `السياق`. اختر `النص` كنوع البيانات من القائمة المنسدلة. `في الأداة المساعدة BRE، يجب أن يكون نوع البيانات نصًا.` انقر فوق حفظ.
2	تضيف التسمية معنى لبياناتك. لإنشاء تسمية: اختر التصنيفات وانقر فوق إضافة في صفحة التصنيفات. أدخل اسمًا للتسمية في حقل الاسم. انقر فوق حفظ.
3	انقر فوق السياقات للانتقال إلى صفحة السياقات. انقر فوق +إضافة سياق. أدخل الاسم الذي يمثل السياق الذي تم إنشاؤه في قائمة بيانات BRE. أدخل وصفًا اختياريًا. إذا تم إنشاء أكثر من سمة واحدة، فحدد السمة التي تريد ربطها بهذا السياق من قائمة السمات المنسدلة. انقر فوق حفظ.
4	لإنشاء قواعد، انتقل إلى صفحة السياقات. انقر فوق +Add Rule Editor وقم بتكوين التفاصيل التالية: الاسم: أدخل اسمًا للقاعدة. الوصف: وصف اختياري للقاعدة. نشط: حدد خانة الاختيار لتحديد أن القاعدة نشطة. التصنيف: اختر التسمية المطلوبة من القائمة المنسدلة. الأولوية: اسحب شريط التمرير لتعيين أولوية للقاعدة. يقوم النظام بتشغيل القواعد بناءً على الأولوية المعينة، من الأعلى (100) إلى الأدنى. من المستحسن أن تبدأ في تعيين الأولويات من 100 بترتيب تنازلي. محرر القواعد (أداة لإدخال التعليمات البرمجية، كما هو موضح في لقطات الشاشة أدناه): أدخل رمز القاعدة. قم بإنشاء قاعدتين: واحدة إذا وجد النظام تطابقًا والأخرى عندما لا يجد النظام تطابقًا. يقوم رمز المثال التالي بإرجاع قيمة سمة تسمى RouteInfo. يحدث هذا إذا كان الرقم الذي اتصل به المتصل (ANI) يطابق ANI في قائمة المستأجرين الذين تم تحميلهم إلى قاعدة بيانات BRE. انسخ القاعدة التالية والصقها في محرر القواعد: `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` يقوم رمز المثال التالي بإرجاع القيمة NotFound للسمة RouteInfo. يحدث هذا إذا كان الرقم الذي اتصل به المتصل (ANI) لا يتطابق مع ANI في قائمة المستأجرين الذين تم تحميلهم إلى قاعدة بيانات BRE. انسخ القاعدة التالية والصقها في محرر القواعد: `when c: Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute("ani")) == null) then c.putAttribute("routeInfo", "NotFound "); end`
5	انقر فوق حفظ.

طلب BRE

استخدم نشاط BRE Request لاسترداد البيانات من محرك قواعد الأعمال (BRE) لمؤسستك لاستخدامها في التدفق. يستخدم نشاط طلب BRE بروتوكولات HTTP القياسية لجلب البيانات من BRE.

تمكنك الأقسام التالية من تكوين نشاط طلب BRE:

إعدادات عامة
بارامترات الاستعلام
إعدادات التحليل
متغيرات الإخراج

إعدادات عامة

المعلمة	وصف
ملصق النشاط	أدخل اسمًا للنشاط.
وصف النشاط	(اختياري) أدخل وصفًا للنشاط.

بارامترات الاستعلام

كجزء من طلب BRE، يمكنك تمرير المعلمات التي يتم توفيرها في استدعاء API إلى BRE. في أعمدة Key‐Value، يمكنك إدخال مفتاح الاستعلام والقيمة المرتبطة لإرسالها مع الاستعلام. يمكنك أيضًا استخدام صيغة الأقواس المزدوجة المجعدة لتمرير قيم المتغيرات.

يحتوي نشاط BRE على معلمة استعلام محددة مسبقًا: السياق. يتم تمرير معلمة الاستعلام هذه في استدعاء API إلى BRE.

يتم حقن TenantID تلقائيًا كمعامل ولا يحتاج إلى تكوين.

الجدول 1. بارامترات الاستعلام
المعلمة	وصف
السياق	يحتوي على سبب الطلب. لا يمكن تحرير هذه المعلمة الإلزامية أو حذفها. يجب أن تحتوي هذه المعلمة على نفس قيمة القيمة المحددة في `سياق` السمة في BRE. لمزيد من المعلومات، راجع قسم إنشاء مجموعة من القواعد في دليل مستخدم محرك قواعد Cisco Webex Contact Center الأعمال.
ANI	يحتوي على رقم الهاتف الأصلي للمكالمة. هذه هي المعلمة الافتراضية التي يمكنك تحريرها أو حذفها، استنادًا إلى تكوين القواعد في BRE. قيمة العينة لـ ANI هي `{{newContact.ani`}}
مهلة الاستجابة	يحدد مهلة الاتصال لطلب BRE. تم تعيين الإعداد الافتراضي عند 2000 مللي ثانية.
عدد مرات إعادة المحاولة	يحدد عدد المرات التي تمت فيها محاولة طلب BRE بعد الفشل. يتم استخدام هذه المعلمة إذا كان رمز الحالة هو 5xx؛ على سبيل المثال، 500 أو 501.

لإضافة معلمة استعلام، انقر فوق إضافة جديد. يؤدي هذا إلى إضافة صف حيث يمكنك إدخال أزواج قيم المفاتيح. يمكنك إضافة العديد من معاملات الاستعلام كما هو مطلوب كجزء من طلب BRE.

إعدادات التحليل

يمكّنك هذا القسم من تحليل الاستجابة من طلب BRE إلى متغيرات مختلفة:

المعلمة	وصف
متغير الاستجابة	اختر المتغير الذي تريد استخراج قسم معين إليه من كائن استجابة BRE Request. يمكنك اختيار متغيرات التدفق المخصص فقط من القائمة المنسدلة.
تعبير المسار	حدد تعبير المسار لتحليل كائن الاستجابة. اعتمادًا على نوع بنية بيانات كائن الاستجابة وحالات الاستخدام لاستخراج مجموعة فرعية من تلك المعلومات، يختلف تعبير المسار. يتم تسوية البيانات إلى التسلسل الهرمي للكائن قبل تنفيذ Path Expression، لذلك يتم استخدام JsonPath في كائن الاستجابة بغض النظر عن نوع المحتوى الذي تم تكوينه.

المعلمة

وصف

متغير الاستجابة

اختر المتغير الذي تريد استخراج قسم معين إليه من كائن استجابة BRE Request. يمكنك اختيار متغيرات التدفق المخصص فقط من القائمة المنسدلة.

تعبير المسار

حدد تعبير المسار لتحليل كائن الاستجابة. اعتمادًا على نوع بنية بيانات كائن الاستجابة وحالات الاستخدام لاستخراج مجموعة فرعية من تلك المعلومات، يختلف تعبير المسار.

يتم تسوية البيانات إلى التسلسل الهرمي للكائن قبل تنفيذ Path Expression، لذلك يتم استخدام JsonPath في كائن الاستجابة بغض النظر عن نوع المحتوى الذي تم تكوينه.

إعدادات فك التشفير

يمكنك فك تشفير متغيرات الإخراج لنشاط BRE Request. في حالة تمكين فك التشفير على مستوى التدفق، يمكن للمستخدمين الذين لديهم حق الوصول إلى فك تشفير التصحيح عرض قيم الإخراج غير المقنعة لنشاط BRE Request في سجلات تصحيح التدفق. قم بإيقاف تشغيل مفتاح تمكين فك التشفير لتعطيل فك التشفير على مستوى النشاط للحصول على حماية إضافية.

متغيرات الإخراج

يقوم طلب BRE بإرجاع متغيرين للإخراج:

brerequest1.HttpResonsebody: يقوم بإرجاع نص الاستجابة لطلب BRE.
brequest1.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/.

تنسيق إدخال جسون:

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

الاستجابة المعيارية للبيانات/JSON

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

مثال لتعبير مسار JSON: استخدم $.martin.job للحصول على قيمة المطور.

إنشاء تدفق باستخدام نشاط طلب BRE

يمكنك إنشاء تدفقات باستخدام واجهة Flow Designer المتوفرة في مركز اتصال Webex. قم بإنشاء تدفق باستخدام نشاط طلب BRE في مصمم تدفق مركز اتصال Webex.

لمزيد من المعلومات حول تكوين التدفق، راجع طلب BRE.

أسئلة متكررة

ما الغرض من السمة؟
تعد السمات أساسية لربط طلبات بحث BRE الواردة بمجموعات قواعد محددة محددة داخل BRE، ولتخزين نتائج تقييمات القواعد.
كيف تقوم بإنشاء السمات؟
قم بإنشاء سمات ضمن التزويد > السمات في أداة BRE. على سبيل المثال، يمكنك إنشاء سمة باسم السياق.
ما هو الغرض من السياق؟
يحدد السياق السيناريو المحدد أو نوع البحث الذي تطبقه BRE. عندما يستدعي التدفق نشاط طلب BRE، فإنه يحتاج إلى إخبار BRE بمجموعة القواعد التي يجب تقييمها. يتم تعيين السمة، التي غالبًا ما تسمى Context، على اسم المجال المحدد.
ما هو النطاق؟
المجال هو الجدول داخل BRE الذي يحتوي على البيانات ذات الصلة. يوجه اسم المجال BRE إلى البيانات الصحيحة ومجموعة القواعد المقابلة لها.
ما هي التسمية؟
بعد تقييم BRE لقواعدها، يجب عليها توصيل النتيجة مرة أخرى إلى نظام الاتصال (على سبيل المثال، تدفق مركز اتصال Webex الذي يحتوي على نشاط طلب BRE). يتم تكوين القواعد لتعيين قيمة سمة التسمية المعينة بناءً على شروطها.
ما العلاقة بين السمة والسياق والتسمية؟
يمكنك إنشاء سمة، على سبيل المثال، السياق المسمى. يمكنك ربط هذه السمة بنطاق (الجدول الفعلي مثل Anilookup). عند استدعاء نشاط طلب BRE، يقوم التدفق بتعيين قيمة هذه السمة (أي، domain = anilookup) لتحديد السياق (قواعد المجال التي يجب استخدامها).
داخل هذا المجال، تتم كتابة القواعد في Drools Syntax لتقييم الشروط وتعيين قيمة سمة أخرى، غالبًا ما يشار إليها باسم التسمية (على سبيل المثال، label = «MatchFound»). يمثل هذا نتيجة القاعدة التي يتم إرجاعها كاستجابة للتدفق.
كيف ترتبط السمات والسياقات والتسميات بمعلمات الاستعلام الخاصة بالطلب؟

يتم استدعاء BRE بواسطة التدفق، عادةً من خلال استدعاء API (نشاط طلب BRE) إلى عنوان URL داخلي مشفر. هذه واجهة برمجة تطبيقات REST تتيح البحث عن قيم BRE التي تم تحميلها في CSV (أزواج المفاتيح/القيم). يتم تمرير البيانات المطلوبة لـ BRE لاتخاذ قرار كجزء من هذا الطلب، على غرار كيفية عمل معلمات الاستعلام أو نص الطلب في استدعاء REST API العادي.
- بيانات الإدخال: يتم التقاط المعلومات من المكالمة الواردة (مثل ANI الخاص بالمتصل ورقم الحساب والبيانات المماثلة الأخرى) كمتغيرات البيانات المرتبطة بالمكالمات (CAD) في تدفق مكالمات Webex Contact Center.
- بيانات تكوين BRE: يتم أيضًا تعيين المعلمات الضرورية الأخرى، مثل السياق والسمة التي تحدد المجال (على سبيل المثال، domain = Anilookup)، كمتغيرات في عقدة طلب BRE الخاصة بـ Flow.
- متغيرات الطلب: في خطوة طلب BRE من التدفق، يتم تحديد متغيرات CAD والمتغيرات المكونة كمتغيرات في تكوين طلب BRE. ثم يتم إرسال هذه المتغيرات إلى محرك الواجهة الخلفية لتنفيذ BRE.
- الوظيفة: بشكل أساسي، تعمل «متغيرات الطلب» بمثابة «معاملات الاستعلام» أو حمولة الإدخال لـ BRE. تستخدم BRE هذه القيم الواردة لتقييم الشروط المحددة في قواعدها.

Cisco AI Assistant

شكرًا على ملاحظاتك.

قبل أن تبدأ

تكوين مثيل BRE DataSync

الوصول إلى تطبيق BRE

إنشاء مجموعة من القواعد

طلب BRE

إعدادات عامة

بارامترات الاستعلام

إعدادات التحليل

إعدادات فك التشفير

متغيرات الإخراج

تنسيقات نوع المحتوى

نوع المحتوى XML

نوع المحتوى TOML

نوع المحتوى YAML

نوع المحتوى JSON

إنشاء تدفق باستخدام نشاط طلب BRE

أسئلة متكررة

الشركات صغيرة الحجم

المؤسسة

الأجهزة

حلول لـ

الموارد

الشركة