Konfigurácia kontextových premenných pre botov

Článok
06/25/2024

Dôležité

Power Virtual Agents schopnosti a funkcie sú teraz súčasťou Microsoft Copilot Studio po významných investíciách do generatívnej AI a rozšírených integrácií Microsoft Copilot.

Počas aktualizácie dokumentácie a obsahu školenia môžu niektoré články a snímky obrazovky odkazovať na Power Virtual Agents .

Poznámka

Informácie o dostupnosti funkcií sú nasledovné.

Dynamics 365 kontaktné centrum – vložené	Dynamics 365 kontaktné centrum – samostatný	Dynamics 365 Customer Service
No	Áno	Áno

V tomto článku sú uvedené kontextové premenné pre Azure a Copilot Studio boty a ako ich môžete nakonfigurovať v Omnikanál pre Customer Service. Ak chcete pochopiť, ako vytvoriť kontextové premenné, pozrite si časť Správa kontextových premenných.

Kontextové premenné pre boty Azure

Nasledujúca tabuľka obsahuje zoznam kontextových premenných v Omnikanáli pre Customer Service, ktoré môžete použiť na konfiguráciu botov Azure.

Typ kontextovej premennej	Názov kontextovej premennej	Description	Ako mapovať v Azure
Prieskum pred konverzáciou	Použite názov otázky prieskumu pred konverzáciou, ktorú vytvoríte v Omnikanál pre Customer Service.	Systém ukladá odpovede z prieskumu pred konverzáciou ako kontextové premenné.	Pomocou nasledujúcich informácií namapujte názov otázky v Omnikanál pre Customer Service s typom premennej v Azure: Jeden riadok: Reťazec Viac riadkov: Reťazec Množina možností: Reťazec Súhlas používateľa: Booleovský
Vlastný kontext	Použite názov premennej, ktorý vytvoríte v Omnikanál pre Customer Service, alebo ho odovzdajte pomocou rozhrania API setContextProvider.	Vlastné kontextové premenné, ktoré vytvoríte, možno odovzdať prostredníctvom súpravy SDK živého četu.	Mapujte odpoveď používateľa ako JSON , aby ste mohli použiť vlastnú kontextovú premennú v Omnikanál pre Customer Service.
Konverzácia	msdyn_ConversationId	Použite kontextovú premennú, ktorá obsahuje ID konverzácie pre prebiehajúcu konverzáciu, a môžete načítať a vykonávať operácie so záznamom v Microsoft Dataverse.	Reťazec: Reťazec
Kontakt	msdyn_contact_msdyn_ocliveworkitem_Customer	Použite túto kontextovú premennú, ktorá obsahuje ID záznamu pre záznam zákazníka (kontakt), ktorý je prepojený s konverzáciou.	Analýza JSON a extrakcia ID záznamu
Konto	msdyn_account_msdyn_ocliveworkitem_Customer	Použite túto kontextovú premennú, ktorá obsahuje ID záznamu obchodného vzťahu, ktorý je prepojený s konverzáciou.	Analýza JSON a extrakcia ID záznamu
Case	msdyn_incident_msdyn_ocliveworkitem	Použite túto kontextovú premennú, ktorá obsahuje ID záznamu prípadu, ktorý je prepojený s konverzáciou.	Analýza JSON a extrakcia ID záznamu

Poznámka

Názvy kontextových premenných používajte podľa definície a nemeňte ich, keď vytvárate toky v Azure alebo Copilot Studio botoch. Nezabudnite tiež použiť presnú zhodu na odovzdanie hodnoty kontextovej premennej, pretože sa rozlišujú veľké a malé písmená. Ak dôjde k nezhode, záznam nebude automaticky identifikovaný. Viac informácií: Automatická identifikácia záznamov

Kontextové premenné pre Copilot Studio roboty

Nasledujúca tabuľka obsahuje zoznam kontextových premenných dostupných v Omnikanál pre Customer Service, ktoré môžete použiť na konfiguráciu Copilot Studio robotov.

Dôležité

Ak chcete používať premenné správ a hlasu, uistite sa, že ste najprv nainštalovali riešenia rozšírenia.

Typ kontextovej premennej	Názov kontextovej premennej	Description	Ako mapovať Copilot Studio
Prieskum pred konverzáciou	Použite názov otázky prieskumu pred konverzáciou, ktorú vytvoríte v Omnikanál pre Customer Service.	Systém ukladá odpovede z prieskumu pred konverzáciou ako kontextové premenné.	Pomocou nasledujúcich informácií namapujte názov otázky v Omnikanál pre Customer Service s typom premennej v Copilot Studio: Jeden riadok: Celá odpoveď používateľa Viac riadkov: Celá odpoveď používateľa Množina možností: Celá odpoveď používateľa Súhlas používateľa: Booleovský
Vlastný kontext	Použite názov premennej, ktorý vytvoríte v Omnikanál pre Customer Service, alebo ho odovzdajte pomocou rozhrania setContextProvider API.	Vlastné kontextové premenné, ktoré vytvoríte, možno odovzdať prostredníctvom súpravy SDK živého četu.	Na mapovanie vlastnej kontextovej premennej v Omnikanál pre Customer Service s typom premennej v Copilot Studio použite nasledujúce informácie: Reťazec: Celá odpoveď používateľa Boolean: Booleovský Číslo, Číslo s pohyblivou desatinnou čiarkou: Číslo
Konverzácia	msdyn_ConversationId	Použite kontextovú premennú, ktorá obsahuje ID konverzácie pre prebiehajúcu konverzáciu, a môžete načítať a vykonávať operácie so záznamom v Microsoft Dataverse.	Reťazec: Celá odpoveď používateľa.
Premenné správ a hlasu	msdyn_CustomerType	Použite túto kontextovú premennú, ktorá obsahuje typ zákazníka pre účet alebo záznam kontaktu prepojený s konverzáciou.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
	msdyn_CustomerName	Použite túto kontextovú premennú, ktorá obsahuje meno zákazníka pre účet alebo záznam kontaktu prepojený s konverzáciou.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
	msdyn_CustomerId	Použite túto kontextovú premennú, ktorá obsahuje ID zákazníka pre účet alebo záznam kontaktu prepojený s konverzáciou.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
	msdyn_CaseId	Použite túto kontextovú premennú, ktorá obsahuje ID záznamu prípadu prepojeného s konverzáciou.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
	msdyn_CaseTitle	Použite túto kontextovú premennú, ktorá obsahuje názov záznamu prípadu prepojeného s konverzáciou.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
Iba hlasové premenné	CustomerPhoneNumber	Túto kontextovú premennú použite pre telefónne číslo zákazníka v aktivite Telefonovanie.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
	OrganizationPhoneNumber	Túto kontextovú premennú použite pre telefónne číslo organizácie v aktivite Telefonovanie.	Vyberte premennú riešenia rozšírenia Omnikanál pre Customer Service.
Názov metódy prípony	va_SurveyConsent	Pomocou tohto dialógového okna zistíte, či zákazník súhlasil s účasťou na prieskumoch počas konverzácie.	Túto metódu použite na eskaláciu podrobností konverzácie do Omnikanála pre Customer Service.
	va_CustomerLocale	Pomocou tohto dialógového okna prenesiete používateľa, ktorý práve hovorí s botom, na iného bota, ktorý môže hovoriť iným jazykom.	Nastavte kód výberom vstupnej premennej a použitím správneho kódu miestneho nastavenia.

Nakonfigurujte kontextové premenné pre Copilot Studio bot

Ak chcete, aby váš Copilot Studio bot čítal kontextové premenné z omnikanálový, vykonajte tieto kroky:

Na stránke Témy vyberte Pridať tému a z prázdneho.
Zadajte názov pre svoju tému (napríklad „Nastaviť kontextové premenné“) a uložte ju.
Pridajte k téme nový uzol a vyberte Správa premenných > Nastaviť hodnotu premennej
Vo svojom novom uzle v časti Nastaviť premennú vyberte Vytvoriť novú premennú.
Kliknutím na názov novej premennej otvorte panel Vlastnosti premennej . Na table nastavte Názov premennej tak, aby sa presne zhodoval s názvom kontextovej premennej omnikanálový (rozlišujú sa malé a veľké písmená).
V sekcii Referencia vyberte elipsy (...) a vyberte Získajte hodnotu z tohto uzla, ak je prázdny. Bot Copilot Studio načíta hodnotu premennej z tohto uzla za behu.
V sekcii Použitie vyberte Globálne (prístup má akákoľvek téma) a Externé zdroje môžu nastaviť hodnoty. Copilot Studio prijíma údaje z omnikanálový. Zatvorte tablu Vlastnosti premennej .
Vo svojom uzle zadajte hodnotu To value , ktorá zodpovedá typu údajov, ktoré váš robot očakáva. Napríklad, ak váš robot očakáva reťazec, nastavte Text(""). Copilot Studio spadne späť na hodnotu, ktorú ste tu nastavili, ak údaje neprídu do konverzácie.
Uložte a zverejnite zmeny.

Počas konverzácie sa údaje z kontextovej premennej omnikanálový nastavujú v premenných Copilot Studio a možno ich použiť v logike robota.

Robot môže počas konverzácie nastaviť aj kontextové premenné omnikanálový. Ak chcete nastaviť premennú omnikanálový z logiky Copilot Studio , uistite sa, že váš robot používa správny názov premennej a nastavte hodnotu vo vlastnosti „To value“ vo vašom uzle správy premenných. Copilot Studio odovzdá premennú omnikanálový počas preniesť agentovi. Toto sa často používa na prepojenie konverzácie s prípadom, keď robot eskaluje konverzáciu agentovi. Viac informácií o tom, ako prepojiť záznamy v omnikanálový z týchto údajov: Prepojte zákazníka a prípad s konverzáciou

Globálne premenné, ktoré sú vytvorené v Copilot Studio , môžu byť odovzdané do Omnikanál pre Customer Service, keď je konverzácia eskalovaná. Celý zoznam nájdete v časti Kontextové premenné dostupné po odovzdaní.

Analýza objektu JSON a extrakcia ID záznamu

Uistite sa, že máte nasledujúce podrobnosti:

Kontextová premenná Omnikanál pre Customer Service, ako napríklad msdyn_contact_msdyn_ocliveworkitem_Customer.
Podrobnosti schémy

Kópia podrobností ukážkovej schémy je nasledovná:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue obsahuje hodnotu z atribútu v Dataverse entitách. Mapovanie atribútov entity je nasledovné:

Prípady: Nadpis prípadu
Kontakty: Celé meno
Obchodné vzťahy: Názov

Tu je vzorový záznam kontextu.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

Pozrite si tiež

Integrujte robota Copilot Studio
Integrácia bota Azure
Nakonfigurujte roboty na eskaláciu a ukončenie konverzácií
Referenčné informácie o súprave SDK pre živý rozhovor

Zdieľať cez