I den här artikeln
dropdown icon
Introduktion
    Om Cisco Business Rules Engine
dropdown icon
Implementering av Business Rules Engine
    Innan du börjar
    Skapa en uppsättning regler
    Konfigurera en BRE DataSync-instans
    Skapa ett flöde med BRE-förfrågningsaktivitet
    dropdown icon
    BRE-begäran
      Allmänna inställningar
      Frågeparametrar
      Parsa inställningar
      Inställningar för dekryptering
      Utdatavariabler
    Vanliga frågor

Webex Contact Center Användarhandbok för Business Rules Engine

list-menuI den här artikeln
list-menuHar du feedback?

Business Rules Engine (BRE) i Webex Contact Center gör det möjligt för kunder att överförarntttspecifika data som systemet kan komma åt under körning för att fatta routningsbeslut ellerrntttvisa information för uppringande agenter.

Inledning

Om Cisco Business Rules Engine

Med BRE (Cisco© Business Rules Engine) kan du överföra data till miljön Webex Contact Center för anpassad routning och allmän implementering. Systemet hämtar data vid körning och använder dem för att avgöra routningsbeslut eller visa information för agenten.

En innehavare vill till exempel dirigera samtal till en viss grupp av agenter baserat på uppringda ANI (Automatic Number Identification). I det här scenariot kan klientorganisationen helt enkelt ladda upp en lista med ANI. Om ANI för det inkommande samtalet finns med i listan dirigeras samtalet till den angivna gruppen av agenter. Om ANI inte finns med i listan dirigerar systemet samtalet till den allmänna kön.

En typisk BRE-implementering omfattar följande huvudkomponenter:

  • Verktyget Business Rules Engine tillhandahåller ett gränssnitt för att skapa domäner och regeluppsättningar. BRE kräver att en inkommande beslutsbegäran associeras med en domän. Domänen innehåller en uppsättning regler. Varje regel tilldelas en prioritet. BRE försöker matcha domänens högsta prioritetsregel med beslutsbegäran baserat på villkoren i reglerna.

  • Konfigurationsverktyget för BRE DataSync tillhandahåller ett gränssnitt för att definiera Data Sync-instanser som ska importera data till BRE-databasen. När klientorganisationen har definierat Data Sync instansen kan klientorganisationen ladda upp en CSV-fil. Systemet konverterar uppladdade kommaseparerade värdedata till poster i BRE-databasen.

  • Flow Designer är ett dra-och-släpp-användargränssnitt som används för att definiera flöden som orkestrerar och automatiserar komponenterna i Webex Contact Center. Du kan skapa ett flöde som anropar BRE.

Riktlinjer för datahantering

För att upprätthålla integriteten och säkerheten i BRE måste du följa följande riktlinjer för datahantering:

  • Tillåtna datatyper: Ladda upp data som är väsentliga för driften och funktionaliteten i BRE. Detta inkluderar, men är inte begränsat till, affärsregler, konfigurationer och icke-känsliga driftdata.

  • Begränsning av PII: Ladda inte upp någon personligt identifierbar information (PII) till BRE förutom ANI-data. PII inkluderar, men är inte begränsat till:

    • Fullständiga namn
    • Personnummer
    • E-postadresser
    • Fysiska adresser
    • Finansiell information

ANI-data avser det telefonnummer som är kopplat till den uppringande parten. ANI-data är den enda typen av PII som är tillåten för uppladdning till BRE. Det här undantaget är till för att stödja specifika affärsfunktioner som är beroende av ANI-data.

Implementering av Business Rules Engine

Innan du börjar

Innan du implementerar BRE bör du bekanta dig med följande terminologier som används i den här guiden.

  • Attribut: Ett attribut är en namngiven variabel eller ett datafält som skapats i BRE-verktyget. Den fungerar som en behållare för information som BRE använder för att bearbeta begäranden och generera utdata.
  • Kontext: En kontext används främst som exempelnamn för ett attribut som anger måldomänen för en BRE-begärandeaktivitet.
  • Etikett: En etikett är en specifik typ av attribut som är utformad för att innehålla utdata eller resultat av en regelutvärdering.

Se avsnittet Vanliga frågor för mer information.

Skapa en uppsättning regler

Flöden anropar verktyget Business Rule Engine när en ny röstbegäran presenteras för ACD. I det här avsnittet beskrivs hur du kan ange regler så att BRE-verktyget kan hjälpa ACD att dirigera den inkommande begäran.

Diagram över verktyget Business Rule Engine som anropas av ett flöde i Webex Contact Center. Flödeskontroll i Webex Contact Center Flow Designer > Lookup Request > Cisco BRE > Read > BRE Repository.

BRE kräver att en inkommande beslutsbegäran associeras med en domän och en uppsättning regler. BRE försöker matcha regeln med högsta prioritet med beslutsbegäran baserat på villkoren i reglerna.

Se till att skapa en regeluppsättning som täcker alla fall. Du bör till exempel skapa regler för villkoren Matcha hittades och Matcha hittades inte . Du kan också ställa in regler för flera villkor. Till exempel,ANI Match eller ANI No Match , sedan Gold ellerSilver . I så fall måste du skapa en regel för varje affärsmöjlighet. Till exempel:

  • ANI Match och Guld

  • ANI Match och Silver

  • ANI No Match och guld

  • ANI No Match och Silver

Så här skapar du en uppsättning regler:

1

Logga in på hanteringsportalen Cisco Webex Contact Center.

2

Klicka på sökvägen Cisco Webex Contact Center Management Portal > Business Rules för att öppna verktyget Business Rules Engine.

BRE använder identitetstjänster och interaktion med enkel inloggning. Om innehavarna redan har loggat in på Cisco Webex Contact Center Management Portal kan de automatiskt få åtkomst till BRE-verktyget för sin organisation.

3

Skapa ett attribut som ska kopplas till din organisation:

  1. Välj Attribut och klicka på Lägg till på sidan Attribut .

  2. På sidan Attribut anger du kontext i fältet Namn .

  3. Välj Datatyp som text i listrutan.

    Datatypen måste vara Text i BRE-verktyget.

  4. Klicka på Spara.

4

Välj Kontexter för att visa sidan Sammanhang . Klicka på +Lägg till sammanhang.

  1. Ange Namn och en valfri beskrivning.

  2. Om fler än ett attribut skapas väljer du det attribut som du vill koppla till kontexten i listrutan Attribut .

  3. Klicka på Spara.

5

Om du vill skapa regler väljer du sidan Kontexter .

  1. Klicka på +Lägg till regel på sidan anger du inställningarna som beskrivs i följande tabell:

    Fält

    Beskrivning

    Namn

    Regelns namn.

    Beskrivning

    En valfri beskrivning av regeln.

    Aktiv

    Markera kryssrutan om du vill ange att regeln är aktiv.

    Etikett

    Välj önskad etikett i listrutan.

    Prioritet

    Dra skjutreglaget för att tilldela regeln en prioritet. Systemet kör reglerna baserat på den tilldelade prioriteten, från högsta (100) till lägsta.

    Vi rekommenderar att du börjar tilldela prioriteter från 100 i fallande ordning.

    Villkor

    Ange villkoren i listrutan och välj attribut och värden.

  2. Klicka på avsnittet Lägg till regel(redigerare) på sidan och ange inställningarna som beskrivs i följande tabell:

    Fält

    Beskrivning

    Namn

    Regelns namn.

    Beskrivning

    En valfri beskrivning av regeln.

    Aktiv

    Markera kryssrutan om du vill ange att regeln är aktiv.

    Etikett

    Välj önskad etikett i listrutan.

    Prioritet

    Dra skjutreglaget för att tilldela regeln en prioritet. Reglerna körs baserat på den tilldelade prioriteten, från högsta (100) till lägsta.

    Villkor

    Välj villkor i listrutan och ange attribut och värden.

    Regelredigeraren

    Ange koden för regeln.

  3. Klicka på Spara.

Följande exempelkod returnerar värdet för ett attribut med namnet routeInfo. Detta inträffar om numret som uppringaren ringde från (ANI) matchar ANI i listan över innehavare som överförs till BRE-databasen. Kopiera och klistra in följande regel i regelredigeraren:
när c: Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute("ani")) != null) och sedan c.putAttribute("routeInfo", c.getGlobalValuesManager().getAsString(c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute("ani"))); ände
BRE Contexts page with an example code returns value for ANIFound for attribute routeinfo.

I följande exempelkod returneras värdet NotFound för attributet routeInfo. Detta inträffar om ett nummer som uppringaren ringde från (ANI) inte matchar ett ANI i listan över innehavare som överförs till BRE-databasen. Kopiera och klistra in följande regel i regelredigeraren:

när c: Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+"." + c.getAttribute ("ani")) == null) sedan c.putAttribute ("routeInfo", "NotFound "); ände

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

Konfigurera en BRE DataSync-instans

BRE DataSync har åtkomst till en databas för att fatta routningsbeslut. Se till att regelbundet uppdatera databasen med lämplig information. I det här avsnittet beskrivs hur du konfigurerar verktyget BRE DataSync för att uppdatera BRE-databasen.

Diagram for how the BRE DataySync utility is configured to update the BRE repository. BRE DataSync > CRUD > BRE Repository.
BRE DataSync, verktyg

Innehavaradministratören måste skapa en BRE DataSync-instans för varje datauppsättning som regelmotorerna konsulterar under beslutsprocessen. Administratören kan skapa datauppsättningen eller överföra en CSV fil. Data konverteras till poster i BRE-databasen.

Innan du börjar

Kontakta Cisco Customer Service Account Manager för att få tillgång till BRE DataSync-kontot.

BRE DataSync är för närvarande endast aktiverat för rollen Fullständig administratör . Innehavare med rollen Fullständig administratör kan överföra data antingen med filöverföringen CSV eller nyckel/värde-paren. Användare med den här rollen kan bara överföra sina organisationsspecifika data.

Partneradministratörer, externa administratörer, agenter och arbetsledare har inte åtkomst till verktyget BRE DataSync.

1

Som administratör loggar du in på verktyget BRE DataSync.

I enlighet med de senaste förbättringarna av BRE Hosting och skalbarhet har URL:erna för DataSync-verktyget ändrats. Se till att använda de uppdaterade URL:erna för att ladda upp data till BRE.

2

Välj BRE-datalista om du vill visa all information som är relaterad till innehavarorganisationen.

3

(Valfritt) Välj Lägg till BRE-data om du vill lägga till data i BRE-databasen.

  1. Välj organisationsnamnet i listrutan TenantName .

  2. Välj en uppslagstyp i listrutan.

    Kontakta Cisco Customer Success Manager eller Solution Assurance-kontakt för att lägga till nya uppslagstyper.

  3. Klicka på Lägg till data för att ange nyckel och värde.

  4. (Valfritt) Klicka på Ta bort om du vill ta bort en befintlig nyckel och ett befintligt värde.

  5. Klicka på Skicka.

4

Välj Ladda upp BRE CSV data för att ladda upp filen CSV.

  1. Välj organisationsnamnet i listrutan TenantName .

  2. Välj en uppslagstyp i listrutan.

  3. Välj Ladda upp för att bläddra och ladda upp filen CSV.

  4. Klicka på Skicka.

    Sample CSV file for the BRE CSV data upload. Column headers are 'ANI', 'Extension', and 'Action'.
    Exempel på CSV fil med data
    Åtgärderna Ta bort, Uppdatera och Lägg till är inte skiftlägeskänsliga. Du kan också använda syntaxen 725160001,,Delete för att ta bort data.

Skapa ett flöde med BRE-förfrågningsaktivitet

Du kan skapa flöden med hjälp av Flow Designer-gränssnittet som finns i Webex Contact Center hanteringsportalen. Skapa ett flöde med BRE-begärandeaktiviteten i Webex Contact Center Flow Designer.

Mer information om hur du konfigurerar flödet finns i BRE-begäran .

BRE-begäran

Använd aktiviteten BRE-begäran för att hämta data från organisationens Business Rules Engine (BRE) som ska användas i flödet. Aktiviteten BRE-begäran använder HTTP-standardprotokoll för att hämta data från BRE.

I följande avsnitt kan du konfigurera BRE-begärandeaktiviteten:

Allmänna inställningar

Parameter

Beskrivning

Aktivitetsetikett

Ange ett namn för aktiviteten.

Aktivitetsbeskrivning

(Valfritt) Ange en beskrivning av aktiviteten.

Frågeparametrar

Som en del av BRE-begäran kan du skicka parametrarna som anges i API-anropet till BRE. I nyckelvärdeskolumnerna kan du ange nyckeln för frågan och det associerade värdet som ska skickas tillsammans med frågan. Du kan också använda syntaxen för dubbla klammerparenteser för att skicka variabelvärden.

BRE-aktiviteten har en fördefinierad frågeparameter: kontext. Den här frågeparametern skickas i API-anropet till BRE.

TenantID matas in automatiskt som en parameter och behöver inte konfigureras.

Tabell 1. Frågeparametrar

Parameter

Beskrivning

Kontext

Innehåller orsaken till begäran. Den här obligatoriska parametern kan inte redigeras eller tas bort.

Den här parametern måste innehålla samma värde som värdet som anges i attributkontexten i BRE. Mer information finns i Skapa en uppsättning regler I Cisco Webex Contact Center Användarhandbok för Business Rules Engine.

ANI

Innehåller samtalets ursprungliga telefonnummer. Det här är en standardparameter som du kan redigera eller ta bort, baserat på regelkonfigurationen i BRE.

Ett exempelvärde för ANI är {{NewPhoneContact.ANI}}

Timeout för svar

Anger tidsgränsen för anslutningen för BRE-begäran. Standardvärdet är inställt på 2000 millisekunder.

Antal nya försök

Anger hur många gånger BRE-begäran ska försökas efter fel.

Denna parameter används om statuskoden är 5xx; Till exempel 500 eller 501.

Om du vill lägga till en frågeparameter klickar du på Lägg till ny. Då läggs en rad till där du kan ange nyckelvärdesparen. Du kan lägga till så många frågeparametrar som behövs som en del av BRE-begäran.

Parsa inställningar

I det här avsnittet kan du parsa svaret från BRE-begäran i olika variabler:

Parameter

Beskrivning

Svarsvariabel

Välj en variabel som du vill extrahera ett visst avsnitt till från svarsobjektet för BRE-begäran. Du kan bara välja anpassade flödesvariabler i listrutan.

Banuttryck

Definiera sökvägsuttrycket för parsning av svarsobjektet. Beroende på typen av datastruktur för svarsobjektet och användningsfallen för att extrahera en delmängd av den informationen varierar sökvägsuttrycket.

Data normaliseras till en objekthierarki innan sökvägsuttrycket körs, så JSONPath används i svarsobjektet oavsett den konfigurerade innehållstypen.

Inställningar för dekryptering

Du kan dekryptera utdatavariablerna för BRE-begärandeaktiviteten. Om dekryptering är aktiverat på flödesnivå kan användare med felsökningsdekrypteringsåtkomst visa de omaskerade utdatavärdena för BRE-begärandeaktiviteten i flödesfelsökningsloggarna. TURN av växlingsknappen Aktivera dekryptering för att inaktivera dekryptering på aktivitetsnivå för ytterligare skydd.

Utdatavariabler

BRE-begäran returnerar två utdatavariabler:

  • BRERequest1.httpResponseBody: Returnerar svarstexten för BRE-begäran.

  • BRERequest1.httpStatusCode: Returnerar statuskoden för BRE-begäran.

    Dessa svarskoder klassificeras i följande kategorier:

    • Informationssvar (100–199)

    • Lyckade svar (200–299)

    • Omdirigeringar (300–399)

    • Klientfel (400–499)

    • Serverfel (500–599)

Format för innehållstyp

I följande exempel beskrivs exempel på innehållstypformat för indata och JSON-svaret.

Innehållstyp XML

Använd det här verktyget för att konvertera XML till JSON-format https://codeshack.io/xml-to-json-converter/.

XML Inmatningsformat:

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

Data/JSON-normaliserat svar

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

Exempel på JSON-sökvägsuttryck: Använd $.note.from för att hämta värdet som Jani.

Innehållstyp TOML

Använd det här verktyget för att konvertera TOML till JSON-format https://www.convertjson.com/toml-to-json.htm.

TOML-inmatningsformat:

title = "TOML-exempel" [ägare] namn = "Tom Preston-Werner" dob = 1979-05-27T07:32:00-08:00 

Data/JSON-normaliserat svar

{ "title": "TOML-exempel", "ägare": { "namn": "Tom Preston-Werner", "dob": "1979-05-27T15:32:00.000Z" } } 

Exempel på JSON-sökvägsuttryck: Use $.owner.name för att hämta värdet som 'Tom Preston-Werner'.

Innehållstyp YAML

Använd det här verktyget för att konvertera YAML till JSON-format https://www.convertjson.com/yaml-to-json.htm.

YAML-indataformat:

# En anställd rekord martin: namn: Martin D'vloper jobb: Utvecklare skicklighet: Elite 

Data/JSON-normaliserat svar

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

Exempel på JSON-sökvägsuttryck: Använd $.martin.job för att hämta värdet Developer.

Innehållstyp JSON

Använd JSON Expression Evaluator https://jsonpath.com/.

JSON-indataformat:

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

Data/JSON-normaliserat svar

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

Exempel på JSON-sökvägsuttryck: Använd $.martin.job för att hämta värdet Developer.

Vanliga frågor

  1. Vad är syftet med ett attribut?

    Attribut är grundläggande för att länka inkommande BRE-sökningsbegäranden till specifika regeluppsättningar som skapats i BRE och för att lagra resultaten av regelutvärderingar.

  2. Hur skapar du attribut?

    Skapa attribut under Provisioning > Attributes i verktyget BRE. Du kan till exempel skapa ett attribut med namnet context.

  3. Vad är syftet med ett sammanhang?

    Kontext definierar det specifika scenario eller den uppslagstyp som BRE ska tillämpa. När ett flöde anropar BRE-begärandeaktiviteten måste det tala om för BRE vilken uppsättning regler som ska utvärderas. Ett attribut, som ofta heter Context , är inställt på namnet på den specifika domänen.

  4. Vad är en domän?

    En domän är den tabell i BRE som innehåller relevanta data. Det här värdet vägleder BRE till rätt domäns data och motsvarande regeluppsättning.

  5. Vad är en etikett?

    När BRE har utvärderat sina regler måste den kommunicera resultatet tillbaka till det anropande systemet (till exempel ett Webex Contact Center-flöde som innehåller BRE-begäran). Regler skrivs för att ange värdet för ett visst etikettattribut baserat på deras villkor.

  6. Vad är förhållandet mellan ett attribut, sammanhang och en etikett?

    Du skapar ett attribut, till exempel namngivet sammanhang. Du associerar det här attributet med en domän (den faktiska tabellen som ANILookup). När BRE anropas anger flödet värdet för det här attributet (det vill säga domain = ANILookup) för att ange kontexten (vilka domänregler som ska användas).

    Inom den domänen skrivs regler i Drools Syntax för att utvärdera villkor och ange värdet för ett annat attribut, som ofta kallas en label (till exempel label = "MatchFound"), som representerar regelns resultat som returneras som ett svar på flödet.

  7. Hur är attribut, kontexter och etiketter relaterade till frågeparametrarna i begäran?

    BRE anropas av ett flöde, vanligtvis via ett API-anrop (BRE-begärandenod/aktivitet) till en hårdkodad intern URL. Det här är en REST API som möjliggör sökning av BRE-värden som laddats upp i CSV (nyckel/värde-par). De data som krävs för att BRE ska fatta ett beslut skickas som en del av den här begäran, på samma sätt som frågeparametrar eller en begärandetext skulle fungera i ett vanligt REST API-anrop.

    • Indata: Information från det inkommande samtalet (till exempel uppringarens ANI, kontonummer och andra liknande data) samlas in som CAD-variabler (Call Associated Data) i Webex Contact Center-samtalsflödet.
    • BRE-konfigurationsdata: Andra nödvändiga parametrar, till exempel kontext och attributet som anger domänen (t.ex. domän = ANILookup), anges också som variabler i flödets BRE-begärannod.
    • Förfrågningsvariabler: I steget BRE-begäran i flödet väljs CAD-variablerna och de konfigurerade variablerna som variabler i BRE-begäran-konfigurationen. Dessa variabler skickas sedan till BRE:s serverdelsmotor för körning.
    • Funktion: I huvudsak fungerar "förfrågningsvariablerna" som "frågeparametrar" eller indatanyttolast för BRE. BRE använder dessa inkommande värden för att utvärdera de villkor som definieras i dess regler.

Var den här artikeln användbar?
Var den här artikeln användbar?