מדריך למשתמש של מנוע הכללים העסקיים של מרכז הקשר של Webex

במאמר זה

משוב?

מנוע הכללים העסקיים (BRE) במרכז הקשר של Webex מאפשר ללקוחות להעלות נתונים ספציפיים שהמערכת יכולה לגשת אליהם במהלך זמן ריצה כדי לקבל החלטות ניתוב או להציג מידע כדי להתקשר לסוכנים.

מבוא

Cisco© Business Rules Engine הוא יישום המסייע בחיפושי נתונים מהירים במרכז הקשר של Webex. באמצעות Cisco© Business Rules Engine ‏(BRE), ניתן לבצע חיפושי נתונים, ניתוב מותאם אישית ויישום כללי. המערכת מאחזרת את הנתונים בזמן ריצה ומשתמשת בהם לצורך קבלת החלטות ניתוב או הצגת מידע לסוכן.

לדוגמה, דייר רוצה לנתב שיחות לקבוצת סוכנים ספציפית בהתבסס על זיהוי מספרים אוטומטי (ANI) שחויגו. בתרחיש זה, הדייר יכול פשוט להעלות רשימה של ANIs. אם ה-ANI של השיחה הנכנסת נמצא ברשימה זו, המערכת מנתבת את השיחה לקבוצת הסוכנים שצוינה. אם ה-ANI אינו ברשימה, המערכת מנתבת את הקריאה לתור הכללי.

יישום BRE טיפוסי כולל את הרכיבים העיקריים הבאים:

סינכרון נתונים של BRE: כלי התצורה של BRE DataSync מספק ממשק להגדרת מופעי Data Sync לייבוא נתונים למסד הנתונים של BRE. לאחר שהדייר מגדיר את מופע Data Sync, הדייר יכול להעלות קובץ CSV. המערכת ממירה את נתוני הערכים המופרדים בפסיקים שהועלו לרשומות במסד הנתונים של BRE.
מנוע חוקים עסקיים: כלי השירות Business Rules Engine מספק ממשק ליצירת דומיינים וקבוצות כללים. ה-BRE דורש שבקשת החלטה נכנסת תהיה משויכת לתחום . הדומיין מכיל סט של כללים. לכל כלל מוקצה עדיפות. ה-BRE מנסה להתאים את כלל העדיפות הגבוהה ביותר של הדומיין לבקשת ההחלטה בהתבסס על התנאים בכללים.
מעצב זרימה: ממשק משתמש גרור ושחרר המשמש להגדרת זרימות המנהלות ומאפשרות אוטומציה של רכיבי מרכז הקשר של Webex. ניתן ליצור זרימה שמפעילה את פעילות BRE כדי לבצע חיפוש נתונים פשוט בדומה לפעילות בקשת HTTP. עם זאת, במקרה זה, הנתונים נמצאים במרכז הקשר של Webex.

הנחיות לטיפול בנתונים

כדי לשמור על שלמות ואבטחת ה-BRE, עליך לציית להנחיות הטיפול בנתונים הבאות:

סוגי נתונים מותרים: העלה נתונים החיוניים לתפעול ולתפקוד של ה-BRE. זה כולל, אך לא רק, כללי עסקיים, תצורות ונתונים תפעוליים שאינם רגישים.
הגבלה על מידע אישי: אין להעלות מידע אישי מזהה (PII) ל-BRE למעט נתוני ANI. מידע אישי מזהה כולל, אך אינו מוגבל ל:
- שמות מלאים
- מספרי ביטוח לאומי
- כתובות דוא"ל
- כתובות פיזיות
- מידע פיננסי

נתוני ANI מתייחסים למספר הטלפון המשויך לצד המתקשר. נתוני ANI הם סוג המידע האישי היחיד שמותר להעלאה ל-BRE. חריג זה נועד לתמוך בפונקציונליות עסקית ספציפית המסתמכת על נתוני 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, כתובות ה-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.prodanz1.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 כדי לנווט לדף התחברות עם זהות משותפת. עבור אזור ארה"ב, בחר באשכול ארה"ב (ולא באשכול ארה"ב השני) כדי להמשיך הלאה. כתובות ה-URL של ממשק המשתמש הספציפי לאזור של BRE הן: https://bre.produs1.ciscoccservice.com/bre/ https://bre.prodeu1.ciscoccservice.com/bre/ https://bre.prodeu2.ciscoccservice.com/bre/ https://bre.prodanz1.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 מגה-בייט צור קשר עם מנהל הצלחת הלקוחות של סיסקו או עם איש הקשר של אבטחת הפתרונות כדי להוסיף סוגי חיפוש חדשים. לחץ על הוסף נתונים כדי להזין את המפתח ואת הערך . (אופציונלי) לחץ על הסר כדי למחוק מפתח וערך קיימים. לחץ על שלח.
4	כדי להעלות קובץ CSV למאגר BRE: בחר העלה נתוני BRE CSV. בחר את שם הארגון מהרשימה הנפתחת TenantName. בחר את סוג חיפוש BRE מהרשימה הנפתחת. בחר העלה כדי לעיין ולהעלות את קובץ ה-CSV. לחץ על שלח. *קובץ CSV לדוגמה עם נתונים* הפעולות מחיקה, עדכון והוספה אינן תלויות רישיות. ניתן גם להשתמש בתחביר `725160001,,Delete` כדי למחוק את הנתונים.

גישה לאפליקציית BRE

ניתן לגשת ליישום Business Rules Engine מפורטל הניהול של מרכז הקשר של Webex.

היכנס לפורטל הניהול של מרכז הקשר של Webex.
לחץ על כללי עסקיים כדי לפתוח את לוח המחוונים של מנוע כללי העסק.
BRE משתמש בשירות זהות ובאינטראקציה של כניסה יחידה. אם כבר נכנסת דרך Common Identity, תוכל לגשת לכלי BRE עבור הארגון שלך מבלי להיכנס שוב.

המערכת פותחת את יישום Business Rules Engine (BRE) בכרטיסייה חדשה בדפדפן. דף לוח המחוונים מופיע עם ייצוג גרפי של מספר הכללים והביצועים. לוח המחוונים של BRE

יצירת סט של כללים

תרשים של כלי השירות Business Rule Engine המופעל על ידי זרימה במרכז הקשר של Webex. בקרת זרימה במעצב הזרימה של מרכז הקשר של Webex > בקשת חיפוש > סיסקו BRE > לִקְרוֹא > מאגר BRE.

גש לפורטל BRE והגדר את התכונה, התווית, ההקשר והכללים, כמתואר להלן.

1	כדי ליצור מאפיין שישויך לארגון שלך: בחר מאפיינים ולחץ על הוסף בדף המאפיינים. הזן `context` בשדה שם. בחר את סוג הנתונים כ- `Text` מהרשימה הנפתחת. סוג הנתונים חייב להיות `Text` בכלי השירות BRE. לחץ על שמור.
2	תווית מוסיפה משמעות לנתונים שלך. כדי ליצור תווית : בחר תוויות ולחץ על הוסף בדף התוויות. הזן שם לתווית בשדה שם . לחץ על שמור.
3	לחץ על הקשרים כדי לנווט לדף הקשרים. לחץ על +Add הקשר. הזן את שם שהוא ההקשר שנוצר ברשימת הנתונים של BRE. הזן תיאור אופציונלי. אם נוצר יותר מתכונה אחת, בחר את התכונה שברצונך לשייך להקשר זה מהרשימה הנפתחת תכונה . לחץ על שמור.
4	כדי ליצור כללים, נווטו לדף הקשרים. לחץ על +Add עורך הכללים וקבע את ההגדרה של הפרטים הבאים: שם: ספק שם לכלל. תיאור: תיאור אופציונלי של הכלל. פעיל: סמן את תיבת הסימון כדי לציין שהכלל פעיל. תווית: בחר את התווית הרצויה מהרשימה הנפתחת. עדיפות: גרור את המחוון כדי להקצות עדיפות לכלל. המערכת מפעילה את הכללים על סמך העדיפות שהוקצתה, מהגבוהה ביותר (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 כדי לאחזר את הנתונים ממנוע כללי העסק (BRE) של הארגון שלך לשימוש בזרימה. פעילות בקשת BRE משתמשת בפרוטוקולי HTTP סטנדרטיים כדי לאחזר נתונים מה-BRE.

הסעיפים הבאים מאפשרים לך להגדיר את פעילות בקשת BRE:

הגדרות כלליות
פרמטרים של שאילתה
הגדרות ניתוח
משתני פלט

הגדרות כלליות

פרמטר	תיאור
תווית פעילות	הזן שם לפעילות.
תיאור הפעילות	(אופציונלי) הזן תיאור לפעילות.

פרמטרים של שאילתה

כחלק מבקשת ה-BRE, ניתן להעביר את הפרמטרים המסופקים בקריאה ל-API ל-BRE. בעמודות Key‐Value, ניתן להזין את המפתח עבור השאילתה ואת הערך המשויך שיש לשלוח יחד עם השאילתה. ניתן גם להשתמש בתחביר של סוגריים מסולסלים כפולים כדי להעביר ערכי משתנים.

לפעילות BRE יש פרמטר שאילתה אחד מוגדר מראש: context. פרמטר שאילתה זה מועבר בקריאה של ה-API אל ה-BRE.

ה- TenantID מוזרק אוטומטית כפרמטר ואין צורך להגדיר אותו.

טבלה 1. פרמטרים של שאילתה
פרמטר	תיאור
הקשר	מכיל את סיבת הבקשה. לא ניתן לערוך או למחוק פרמטר חובה זה. פרמטר זה חייב להכיל את אותו הערך כמו הערך שצוין בתכונה `context` ב-BRE. למידע נוסף, עיין בסעיף יצירת קבוצת כלליםבמדריך למשתמש של מנוע הכללים העסקי של מרכז הקשר של Cisco Webex.
ANI	מכיל את מספר הטלפון המקורי של השיחה. זהו פרמטר ברירת מחדל שניתן לערוך או למחוק, בהתבסס על תצורת הכללים ב-BRE. ערך לדוגמה עבור ANI הוא `{{NewContact.ANI}}`
זמן קצוב לתגובה	מציין את זמן הקצוב לחיבור עבור בקשת BRE. ברירת המחדל מוגדרת ל-2000 מילישניות.
מספר ניסיונות חוזרים	מציין את מספר הפעמים שמתבצע ניסיון לבקשת BRE לאחר כישלון. פרמטר זה משמש אם קוד הסטטוס הוא ⁦5xx⁩; לדוגמה, 500 או 501.

כדי להוסיף פרמטר שאילתה, לחץ על הוסף חדש. פעולה זו מוסיפה שורה שבה ניתן להזין את זוגות ערכי המפתח. ניתן להוסיף כמה פרמטרי שאילתה שיידרש כחלק מבקשת BRE.

הגדרות ניתוח

סעיף זה מאפשר לך לנתח את התגובה מבקשת ה-BRE למשתנים שונים:

פרמטר	תיאור
משתנה תגובה	בחר משתנה שאליו ברצונך לחלץ מקטע מסוים מאובייקט תגובת בקשת BRE. ניתן לבחור רק משתני זרימה מותאמים אישית מהרשימה הנפתחת.
ביטוי נתיב	הגדר את ביטוי הנתיב (Path Expression) לניתוח אובייקט התגובה. בהתאם לסוג מבנה הנתונים של אובייקט התגובה ולמקרי השימוש לחילוץ תת-קבוצה של מידע זה, ביטוי הנתיב משתנה. הנתונים מנורמלים להיררכיית אובייקטים לפני ביצוע ביטוי נתיב, כך ש-JSONPath משמש באובייקט התגובה ללא קשר לסוג התוכן שתצורתו נקבעה.

פרמטר

תיאור

משתנה תגובה

בחר משתנה שאליו ברצונך לחלץ מקטע מסוים מאובייקט תגובת בקשת BRE. ניתן לבחור רק משתני זרימה מותאמים אישית מהרשימה הנפתחת.

ביטוי נתיב

הגדר את ביטוי הנתיב (Path Expression) לניתוח אובייקט התגובה. בהתאם לסוג מבנה הנתונים של אובייקט התגובה ולמקרי השימוש לחילוץ תת-קבוצה של מידע זה, ביטוי הנתיב משתנה.

הנתונים מנורמלים להיררכיית אובייקטים לפני ביצוע ביטוי נתיב, כך ש-JSONPath משמש באובייקט התגובה ללא קשר לסוג התוכן שתצורתו נקבעה.

הגדרות פענוח

ניתן לפענח את משתני הפלט של פעילות בקשת BRE. אם פענוח מופעל ברמת הזרימה, משתמשים עם גישת פענוח לאיתור באגים יכולים לצפות בערכי הפלט החשופים של פעילות בקשת BRE ביומני ניפוי באגים של הזרימה. כבה את כפתור הפעל פענוח כדי להשבית פענוח ברמת הפעילות להגנה נוספת.

משתני פלט

בקשת BRE מחזירה שני משתני פלט:

BRERequest1.httpResponseBody: מחזירה את גוף התגובה עבור בקשת BRE.
BRERequest1.httpStatusCode: מחזירה את קוד הסטטוס של בקשת BRE.

קודי תגובה אלה מסווגים לקטגוריות הבאות:
- תגובות אינפורמטיביות (100–199)
- תשובות מוצלחות (200–299)
- הפניות (300–399)
- שגיאות לקוח (400–499)
- שגיאות שרת (500–599)

פורמטי סוג תוכן

הדוגמאות הבאות מתארות תבניות לדוגמה של סוגי תוכן (Content Type) ותגובת 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 Expressions Evaluator 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. צור זרימה עם הפעילות בקשת BRE במעצב הזרימות של מרכז הקשר של Webex.

למידע נוסף על הגדרת הזרימה, עיין ב- בקשת BRE.

שאלות נפוצות

מהי מטרתו של attribute?
Attributes הם בסיסיים לקישור בקשות חיפוש BRE נכנסות למערכות כללים ספציפיות המוגדרות בתוך BRE, ולאחסון תוצאות הערכות הכללים.
איך יוצרים attributes?
צור attributes תחת הקצאת משאבים > תכונות בכלי השירות BRE. לדוגמה, ייתכן שתיצור תכונה בשם context.
מהי מטרתו של context?
Context מגדיר את התרחיש או סוג החיפוש הספציפי ש-BRE מיישם. כאשר זרימה מפעילה את פעילות בקשת BRE, היא צריכה לומר ל-BRE איזו קבוצת כללים להעריך. תכונה, שלעתים קרובות נקראת Context, מוגדרת לשם של דומיין ספציפי.
מה זה domain?
טבלה domain היא הטבלה בתוך BRE המכילה את הנתונים הרלוונטיים. שם הדומיין מנחה את BRE לנתונים הנכונים ולקבוצת הכללים המתאימה להם.
מה זה label?
לאחר ש-BRE מעריך את הכללים שלו, עליו להעביר את התוצאה בחזרה למערכת השיחות (לדוגמה, זרימת מרכז קשר של Webex המכילה פעילות בקשת BRE). כללים מוגדרים לקבוע את הערך של תכונת תווית ייעודית בהתבסס על התנאים שלה.
מהו הקשר בין מאפיין, הקשר ותווית?
ניתן ליצור Attribute, לדוגמה, בשם context. ניתן לשייך תכונה זו ל- domain (הטבלה עצמה כמו ANILookup). בעת הפעלה של פעילות בקשת BRE, הזרימה קובעת את הערך של תכונה זו (כלומר, domain = ANILookup) כדי לציין את ההקשר (באילו חוקי דומיין להשתמש).
בתוך domainזה, נכתבים כללים בתחביר Drools כדי להעריך תנאים ולקבוע את הערך של attributeאחר, המכונה לעתים קרובות label (לדוגמה, label = "התאמה שנמצאה"). זה מייצג את תוצאת הכלל המוחזרת כתגובה לזרימה.
כיצד מאפיינים, הקשרים ותוויות קשורים לפרמטרי שאילתה של הבקשה?

ה-BRE מופעל על ידי Flow, בדרך כלל באמצעות קריאה ל-API (פעילות בקשת BRE) לכתובת URL פנימית מקודדת. זהו ממשק API של REST המאפשר חיפוש ערכי BRE שהועלו בקובץ CSV (key/value זוגות). הנתונים הנדרשים לקבלת החלטה על ידי ה-BRE מועברים כחלק מבקשה זו, בדומה לאופן שבו פרמטרי שאילתה או גוף בקשה יפעלו בקריאה רגילה של REST API.
- Input Data: מידע מהשיחה הנכנסת (כגון ה-ANI של המתקשר, מספר החשבון ונתונים דומים אחרים) נלכד כמשתני נתונים משויכים לשיחות (CAD) בזרימת השיחות של מרכז הקשר של Webex.
- BRE Configuration Data: פרמטרים הכרחיים אחרים, כגון הקשר והתכונה המציינת את הדומיין (למשל, domain = 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 והעלה נתונים

פתח את כלי סינכרון הנתונים BRE של מרכז הקשר של Webex ובחר את הדייר שלך. אם סוג החיפוש הנדרש אינו זמין, בקש מצוות התפעול ליצור אותו. השתמש בשם תיאורי כגון ANILookup. רשום את שם ההקשר שנוצר מכיוון שתצורת ה-BRE והזרימה חייבים להשתמש באותו ערך תלוי-רישיות.

כדי להוסיף רשומת בדיקה:

פתח הוסף נתונים.
בחר את הדייר ו- ANILookup.
הזן את ה-ANI ואת הערך המשויך לו.
הגש את הרשומה.

כדי לטעון את קבוצת הנתונים המלאה, פתחו את Upload BRE, בחרו את הדייר וסוג החיפוש, והעלו את קובץ ה-CSV. פתח את רשימת נתוני BRE וודא שהרשומות מופיעות. ודא שפורמט ה-ANI בקובץ ה-CSV תואם לפורמט שנשלח על ידי הזרימה.

השקת כללי עסקיים

היכנס לפורטל הניהול של מרכז הקשר של Webex, פתח את כללי עסקיםוהפעל את לוח המחוונים של BRE:

צור את תכונת ההקשר:

נווט אל דף הבית > תכונות > .
הוסף מאפיין עם הערכים הבאים:
- שם: context
- סוג נתונים: טקסט
שמור את תכונת התוצאה. התכונה context מזהה את מערך הנתונים של חיפוש שהועלה, אותו שואל הכלל.
הוסף תכונת טקסט המייצגת את הנתונים המוחזרים. תן לתכונה שם בעל משמעות גם כאשר הערך המוחזר מכיל מספר שדות מופרדים באמצעות קווי רשת. שמור את המאפיין. בדוגמה זו, customerType משמש כדוגמה.
פתח את הקשרים והוסף הקשר. הזן את שם ההקשר של סינכרון הנתונים שנוצר, כגון ANILookup, שייך אותו לתכונה context ושמור אותו. שם ההקשר תלוי רישיות וחייב להתאים במדויק להקשר של סינכרון הנתונים שנוצר.

צור כלל ANI-found וכלל ANI-not-found

פתח את ההקשר ובחר הוסף עורך כללים. תן לכלל את השם 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 ליצירת מפתח החיפוש. כאשר קיים ערך תואם, התוצאה מוקצית לתכונה response customerType.

הוסף כלל פעיל נוסף בשם ANINotFound. הקצה לו עדיפות ייחודית ונמוכה יותר, כגון 99. הגדר את הכלל כך שיגדיר את customerType ל- Not Found כאשר לא קיימת רשומה תואמת, ושמור אותה. אין להקצות את אותה עדיפות לשני הכללים.

צור את זרימת מרכז הקשר

פתח את מעצב הזרימות וצור או פתח זרימת בדיקה. הוסף פעילות BRE Request בנקודה שבה הזרימה חייבת לאחזר את פרטי המתקשר, וחבר את הפעילות לנתיב הזרימה המתאים.

לנרמל את ה-ANI

אם המפתחות שהועלו משמיטים את קידומת קוד המדינה +1, צור ביטוי עיבוד מקדים שמסיר אותה מה-ANI:

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

השתמש בערך המנורמל כמפתח חיפוש. יש להחיל טרנספורמציה זו רק כאשר הערכים המאוחסנים משמיטים +1; ערך הבקשה והמפתחות שהועלו חייבים להשתמש באותו פורמט.

הגדרת בקשת BRE

הגדר את הפעילות עם הערכים הבאים:

הֶקשֵׁר: ANILookup
מאפיין בקשה: ani
ערך הבקשה: ה-ANI המנורמל
פסק זמן: 5 שניות
ניסיונות חוזרים: 3
מאפיין תגובה: customerType

מפה את התגובה למשתנה זרימת מחרוזת. ההקשר בוחר את מערך הנתונים, בעוד ש- ani מספק את מפתח הרשומה הבודד.

עיבוד תגובה מרובת שדות

אם BRE מחזירה VIP Customer|John Smith|Premium Queue|Toronto, יש לפצל את המחרוזת באמצעות מפריד צינורות מסוג escape (\|). האלמנטים המתקבלים מכילים את סוג הלקוח, שם הלקוח, התור והמיקום. הקצה את האלמנטים הנדרשים למשתני זרימה נפרדים. ההדגמה מחלצת את האלמנט האחרון, Toronto.

הגדר את קופץ המסך

הוסף או קבע את פעילות הצצת המסך של הסוכן בשולחן העבודה. מפה את פרטי הלקוח שחולצו לשדה הנדרש במסך הקופץ, חבר את הזרימה לתור או לנתיב ניתוב הסוכן, ולאחר מכן שמור ופרסם את הזרימה.

בדוק את ההדגמה

בצע קריאה מ-ANI שקיים במערך הנתונים שהועלה. ודא שהזרימה מנרמלת את ה-ANI, שבקשת ה-BRE עוברת את נתיב ההצלחה שלה, והמידע שחולץ מופיע בשולחן העבודה של הסוכן. חזור על הבדיקה עם ANI שאינו נמצא במערך הנתונים וודא שהנתיב שלא נמצא מחזיר את ערך החלופה שהוגדר.

מבוא

מנוע הכללים העסקיים של סיסקו הוא יישום המסייע בחיפוש נתונים מהיר במרכז הקשר של Webex. באמצעות Cisco Business Rules Engine (BRE), באפשרותך לבצע חיפוש נתונים , ניתוב מותאם אישית ויישום כללי. המערכת מאחזרת את הנתונים בזמן הרי צה ומשתמשת בהם לניתוב החלטות או הצגת מידע לסוכן.

לדוגמה, דייר מעוניין לנתב שיחות לקבוצה ספציפית של סוכנים בהתבסס על זיהוי מספר אוטומטי (ANI) שחויג. בתרחיש זה, השוכר יכול פשוט להעלות רשימה של ANI. אם ה- ANI של השיחה הנכנסת נמצא ברשימה זו, המערכת מנת בת את השיחה לקבוצת הסוכנים שצוינה. אם ה- ANI אינו ברשימה, המערכת מנתבת את השיחה לתור הכללי.

יישום BRE טיפוסי כולל רכיבים עיקריים אלה:

BRE DataSync: כלי התצורה של BRE DataSync מספק ממשק להגדרת מופעי סינכרון הנתונים לייבוא נתונים למסד הנתונים של BRE. לאחר שהדייר מגדיר את מופע סנכרון הנתונים, הדייר יכול להעלות קובץ CSV. המערכת ממירה את נתוני הערך המופרדים בפסיקים שהועלו לרשומות במסד הנתונים של BRE .
מנוע כללים עס קיים: כלי השירות Business Rules Engine מספק מ משק ליצירת תחומים וערכות כללים. ה- BRE דורש שבקשת החלטה נכנסת תהיה קשורה לת חום. הדומיין מכיל קבוצה של כללים. לכל כלל מוקצה עדיפות. ה-BRE מנסה להתאים את כלל הע דיפות הגבוהה ביותר של הדומיין לבקשת ההחלטה בהתבסס על התנאים בכללים.
מעצב זרימה: ממשק משתמש גרירה ושחרור המשמש להגדרת זרימות שמת זמרות ואוטומטיות של רכיבי מרכז הקשר Webex. באפשרותך ליצור זרימה שמפעילה את פעילות BRE כדי לבצע בדיקת נתונים פשוטה הדומה לפעילות בקשת HTTP. עם זאת, במקרה זה, הנתונים נמצאים במרכז הקשר של Webex.

הנחיות לטיפול בנתונים

כדי לשמור על שלמות ואבטחה של BRE, עליך לציית להנחיות הטיפול בנתונים הבאות:

סוגי נתונים מות רים: העלה נתונים החיוניים לתפעול ופונקציונליות של ה- BRE. זה כולל, בין היתר, כללים עסקיים, תצורות ונתונים תפעוליים לא רגישים.
הגבלה על PII: אל תעלה מידע מזהה אישי (PII) ל- BRE למעט נתוני ANI. PII כולל, אך אינו מוגבל ל:
- שמות מלאים
- מספרי ביטוח לאומי
- כתובות דוא"ל
- כתובות פיזיות
- מידע פיננסי

נתוני ANI מתייחסים למספר הטלפון המשויך לצד המתקשר. נתוני ANI הם הסוג היחיד של PII המותר להעלאה ל- BRE. חריג זה נועד לתמוך בפונקציות עסקיות ספציפיות המסתמכות על נתוני ANI.

יישום מנוע כללים עסקיים

מנוע כללים עסקיים מורכב ממנוע כללים בזמן אמת שמופעל על ידי הזרימה המשויכת לנקודת כניסה. מנוע כללים זה מתייעץ בדרך כלל עם מא גר נתונים כדי להעריך את הטיפול הרצוי בשיחות.

חיפוש BRE הוא טבילה פשוטה של נתונים בתוך הזרימה שלך, כמו בקשת HTTP. עם זאת, הנתונים עבור בדיקת BRE נמצאים במרכז Cisco Webex Contact Center הנתונים. התמונה הבאה מציגה את התהליכים השונים המעורבים בחיפוש הנתונים של BRE.

לפני שתתחיל

לפני שאתה מיישם BRE:

הגדר את מופע ה- BRE DataSync ליישום שלך עם הבנה ברורה של מודל הנתונים.
הכירו את הטרמינולוגיות הבאות המשמשות לאורך מדריך זה:
- תכונה: תכונה היא משתנה בעל שם או שדה נתונים שנוצר בתוך כלי השירות BRE. הוא משמש כמיכל למידע בו משתמש BRE לעיבוד בקשות וליצור תפוקות.
- הקשר: הקשר משמש בעיקר כשם דוגמה לתכונה המציינת את הת חום הממוקד לפעילות בקשת BRE.
- תווית: תו וית היא סוג מסוים של תכונה שנועדה להחזיק את הפלט או התוצאה של הערכת כלל.

עיין בסעיף שאלות נפוצות לפרטים נוספים.

קביעת תצורה של מופע של 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 DataSync***

על מנהל הדייר ליצור מופע של BRE DataSync עבור כל מע רך נתונים שמנועי הכללים מתייעץ בו במהלך תהליך קבלת ההחלטות שלו. מנהל המערכת יכול ליצור את ערכת הנתונים או להעלות קובץ CSV. הנתונים מומרים לרשומות במאגר BRE.

לפני שתתחיל

צור קשר עם מנהל חשבונות שירות הלקוחות של סיסקו כדי לקבל גישה לחשבון BRE DataSync.

BRE DataSync מופעל כרגע רק לתפקיד מנהל מלא. דיירים בעלי תפקיד מנהל מלא יכולים להעלות נתונים באמצעות העלאה של קובץ CSV או זוגות מפ תח-ערך. משתמשים בעלי תפקיד זה יכולים להעלות רק את הנתונים הספציפיים לארגון שלהם.

למנהל שותפים, למנהל חיצוני, לסוכנים ולמפקחים אין גישה לכלי השירות BRE DataSync.

1	כמנהל מערכת, היכנס לכלי השירות BRE DataSync. בהתאם לשיפורים האחרונים באירוח ובהרחבה של BRE , כתובות האתר של כלי השירות DataSync השתנו. הקפד להשתמש בכתובות האתרים המעודכנות כדי להעלות נתונים ל- BRE. כתובות האתרים הספציפיות לאזור של 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/ לחץ על כתובות האתרים כדי לנווט לד ף התחברות עם זהות משות פת. עבור אזור ארה"ב, בחר באש כול ארה"ב (לא האש כול השני בארה"ב) כדי להמשיך הלאה. עבור אזור ANZ, אין כתובת אתר ספציפית. בחר את אשכול ה- CI הביתי שלך כדי להתחבר. עבור רוב המשתמשים, קישורי אשכול שני בארה"ב וארה"ב עובדים. כתובות האתרים הספציפיות לאזור של ממשק המשתמש של BRE למנהל הן: 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 מספר מקסימלי של שורות לכל סוג חיפוש: 100K שורות הגבלת גודל קובץ מקסימלית להעלאה: 10 MB צור קשר עם מנהל הצלחת הלקוחות של סיסקו או איש הקשר לאבטחת פתרונות כדי להוסיף סוגי חיפוש חדשים. לחץ על הוסף נתונים כדי להזן את המפתח והע רך. (אופציונלי) לחץ על הסר כדי למחוק מפתח וע רך קיימים. לחץ על שלח.
4	כדי להעלות קובץ CSV למאגר BRE: בחר הע לה נתוני CSV BRE. בחר את שם הארגון מהרשימה הנפת חת 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	ליצירת כללים, נווט לדף ה הקשרים. לחץ על +הוסף עורך כללים וקבע את התצורה של הפר טים הבאים: שם: ספק שם לכלל. תיאור: תיאור אופציונלי של הכלל. פעיל: סמן את תיבת הסימון כדי לציין ש הכלל פעיל. תווית: בחר את התווית הנדרשת מהרשימה הנפתחת. עדיפות: גרור את המחוון כדי להקצות עדיפות לכלל. המערכת מפעילה את הכללים בהתבסס על העדיפות שהוקצתה, מ הגבוה ביותר (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 עבור הת כונה Route Info. פעולה זו מתרחשת אם מספר שממנו חייג המתקשר ( 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 כדי לאחזר את הנתונים ממ נוע הכללים העסקיים (BRE) של הארגון שלך לשימוש בזרימה. פעילות בקשת BRE משתמשת בפרוטוקולי HTTP סטנדר טיים כדי להביא נתונים מה- BRE.

הסעיפים הבאים מאפשרים לך להגדיר את פעילות בקשת BRE:

הגדרות כלליות
פרמטרי שאילתה
הגדרות ניתוח
משתני פלט

הגדרות כלליות

פרמטר	תיאור
תווית פעילות	הזן שם לפעילות.
תיאור הפעילות	(אופציונלי) הזן תיאור לפעילות.

פרמטרי שאילתה

כחלק מבקשת BRE, באפשרותך להעביר את הפרמטרים המסופקים בשיחת ה- API ל- BRE. בעמודות Key‐Value, באפשרותך להכניס את המפתח לשאילתה ואת הערך המשויך לשליחה יחד עם השאילתה. ניתן גם להשתמש בתחביר סוג ריים מתולתלים כפולים כדי להעביר ערכים משתנים.

לפעילות BRE יש פרמטר שאילתה מוגדר מראש: הקשר. פרמטר שאילתה זה מועבר בשיחת ה- API ל- BRE.

ה - Tenant ID מוזרק אוטומטית כפרמטר ואין צורך להגדיר אותו.

טבלה 1. פרמטרי שאילתה
פרמטר	תיאור
הקשר	מכיל את הסיבה לבקשה. לא ניתן לערוך או למחוק פרמטר חובה זה. פרמטר זה חייב להכיל את אותו ערך כמו הערך שצוין ב `הקשר תכונה ב` - BRE. לקבלת מידע נוסף, עיין בסעיף יצירת ערכת כללים במדריך למשתמש של מנוע הכללים העסקיים. Cisco Webex Contact Center
ANI	מכיל את מספר הטלפון המקורי של השיחה. זהו פרמטר ברירת מחדל שניתן לערוך או למחוק, בהתבסס על תצורת הכללים ב- BRE. ערך מדגם עבור ANI הוא `{{newContact.` ani}}
פסק זמן תגובה	מציין את פסק הזמן לחיבור עבור בקשת BRE. ברירת המחדל מוגדרת על 2000 אלפיות השנייה.
מספר ניסיונות חוזרים	מציין את מספר הפעמים שבקשת BRE תנסה לאחר כישלון. פרמטר זה משמש אם קוד המצב הוא 5xx; לדוגמה, 500 או 501.

להוספת פרמטר שאילתה, לחץ על הוסף חדש. פעולה זו מוסיפה שורה שבה ניתן להכניס את זוגות ערכי המפתח. באפשרותך להוסיף כמה פרמטרים של שאילתה כנדר ש כחלק מבקשת BRE.

הגדרות ניתוח

סעיף זה מאפשר לך לנתח את התגובה מבקשת BRE למשתנים שונים:

פרמטר	תיאור
משתנה תגובה	בחר משתנה שאליו ברצונך לחלץ קטע מסוים מאובייקט התגובה של BRE Request. ניתן לבחור רק משתני זרימה מותאמת אישית מהרשימה הנפתחת.
ביטוי נתיב	הגדר את ביטוי הנתיב לניתוח אובייקט התגובה. בהתאם לסוג מבנה הנתונים של אובייקט התגובה ולמקרי השימוש לחילוץ תת-קבוצה של מידע זה, ביטוי נתיב משתנה. הנתונים מנורמלים להיררכיה של אובייקטים לפני ביצוע ביטוי נתיב, ולכן JSONPath משמש באובייקט התגובה ללא קשר לסוג התוכן שהוגדר.

פרמטר

תיאור

משתנה תגובה

בחר משתנה שאליו ברצונך לחלץ קטע מסוים מאובייקט התגובה של BRE Request. ניתן לבחור רק משתני זרימה מותאמת אישית מהרשימה הנפתחת.

ביטוי נתיב

הגדר את ביטוי הנתיב לניתוח אובייקט התגובה. בהתאם לסוג מבנה הנתונים של אובייקט התגובה ולמקרי השימוש לחילוץ תת-קבוצה של מידע זה, ביטוי נתיב משתנה.

הנתונים מנורמלים להיררכיה של אובייקטים לפני ביצוע ביטוי נתיב, ולכן 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:

<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

ניתן ליצור זרימות באמצעות ממשק Flow Designer הזמין במרכז אנשי הקשר של Webex. צור זרימה עם פעילות בק שת BRE במ עצב הז רימה של מרכז הקשר של Webex.

לקבלת מידע נוסף אודות הגדרת התצורה של הזרימה, עיין בקשת BRE.

שאלות נפוצות

מה המטרה של תכונה?
תכונות הן בסיסיות לקישור בקשות חיפוש BRE נכנסות למערכות כללים ספציפיות המוגדרות בתוך BRE, ולאחסון התוצאות של הערכות כללים.
איך יוצרים תכונות?
צור תכונות תחת הק צאה > תכונות בכלי השירות BRE. לדוגמה, באפשרותך ליצור תכונה בשם context.
מהי מטרת הקשר?
הקשר מגדיר את התרחיש הספציפי או סוג החיפוש ש-BRE מיישם. כאשר זרימה מפעילה את פעילות בקשת BRE, היא צריכה לומר ל- BRE איזו מערכת כללים להעריך. תכונה, הנקראת לעתים קרובות Con text מוגדרת לשם הת חום הספציפי.
מהו ד ומיין?
ת חום הוא הטבלה בתוך BRE המכילה את הנתונים הרלוונטיים. שם הדומיין מנחה את BRE לנ תונים הנכונים ולמערך הכללים המתאים לו.
מהי תו וית?
לאחר ש- BRE מעריך את הכללים שלה, עליו להעביר את התוצאה בחזרה למערכת המתקשרת (לדוגמה, זרימת מרכז הקשר של Webex המכילה פעילות בקשת BRE). הכללים מוגדרים כדי להגדיר את הערך של תכונת תו וית ייעודית בהתבסס על התנאים שלהם.
מה הקשר בין תכונה, הקשר ותווית?
ניתן ליצור תכונה, לדוגמה, הקשר בשם. ניתן לשייך תכונה זו לת חום (הטבלה בפועל כמו AniLookup). בעת הפעלת פעילות בקשת BRE, הזרימה קובעת את הערך של תכונה זו (כלומר, domain = AniLookup) כדי לציין את ההקשר (באילו כללי תחום להשתמש).
בתוך ת חום זה, כללים נכתבים בתחביר Drools כדי להעריך תנאים ולהגדיר את הערך של תכונה אחרת, המכונה לעתים קרובות תו וית ( לדוגמה, label = "MatchFound"). זה מייצג את התוצאה של הכלל המוחזרת כתגובה לזרימה.
כיצד קשורים תכונות, הקשרים ותוויות לפרמטרי שאילתה של הב קשה?

ה- BRE מופעל על ידי זרימה, בדרך כלל באמצעות קריאת API (פעילות בקשת BRE) לכתובת URL פנימית מקודדת. זהו ממשק API של REST המאפשר חיפוש של ערכי BRE שהועלו ב - CSV (זוגות מפתח/ערך). הנתונים הדרושים ל-BRE כדי לקבל החלטה מועברים כ חלק מבקשה זו, בדומה לאופן שבו פרמטרי שאילתה או גוף בקשה יפעלו בשיחת REST API רגילה.
- נתוני קלט: מידע מהשיחה הנכנסת (כגון ANI של המתקשר, מספר החשבון ונתונים דומים אחרים) נלכד כמשתני נתונים משויכים לשי חות (CAD) בזרימת השיחות של מרכז הקשר של Webex.
- נתוני תצורת BRE: פרמטרים נחוצים אחרים, כגון הקשר והתכונה המציינת את התחום (למשל, תחום = AniLookup), מו גדרים גם כמשתנים בצומת בקשה BRE של Flow.
- משתני בקשה: בשלב בקשת BRE של הזרימה, משתני CAD ומשתנים מוגדרים נבחרים כמשתנים בתצורת בקשת BRE. משתנים אלה נשלחים לאחר מכן למנוע האחורי לביצוע של BRE.
- פונקציה: בעיקרו של דבר, 'משתני בקשה' משמשים כ 'פרמטרי שאילתה' או מטען קלט עבור BRE. ה- BRE משתמש בערכים נכנסים אלה כדי להעריך את התנאים המוגדרים בכלליו.

Cisco AI Assistant

תודה על המשוב.

לפני שתתחיל

הגדרת מופע BRE DataSync

גישה לאפליקציית BRE

יצירת סט של כללים

בקשת BRE

הגדרות כלליות

פרמטרים של שאילתה

הגדרות ניתוח

הגדרות פענוח

משתני פלט

פורמטי סוג תוכן

סוג תוכן XML

סוג תוכן TOML

סוג תוכן YAML

סוג תוכן JSON

יצירת זרימה עם פעילות בקשת BRE

שאלות נפוצות

הגדרת חיפושי נתוני לקוחות מבוססי ANI באמצעות מנוע הכללים העסקיים

הכן את נתוני החיפוש

צור את סוג חיפוש ה-BRE והעלה נתונים

השקת כללי עסקיים

צור כלל ANI-found וכלל ANI-not-found

צור את זרימת מרכז הקשר

לנרמל את ה-ANI

הגדרת בקשת BRE

עיבוד תגובה מרובת שדות

הגדר את קופץ המסך

בדוק את ההדגמה

לפני שתתחיל

קביעת תצורה של מופע של BRE DataSync

גישה ליישום BRE

יצירת מערכת כללים

בקשת BRE

הגדרות כלליות

פרמטרי שאילתה

הגדרות ניתוח

הגדרות פענוח

משתני פלט

תבניות סוג תוכן

סוג תוכן XML

סוג תוכן TOML

סוג תוכן YAML

סוג תוכן JSON

יצירת זרימה עם פעילות בקשת BRE

שאלות נפוצות

עסק קטן

ארגון

מכשירים

פתרונות עבור

משאבים

חברה