Konfiguracija spremenljivk konteksta za bote

Članek
06/25/2024

Pomembno

Power Virtual Agents zmogljivosti in funkcije so zdaj del Microsoft Copilot Studio spremljanja znatnih naložb v generativno umetno inteligenco in izboljšane integracije Microsoft Copilot.

Nekateri članki in posnetki zaslona se lahko nanašajo Power Virtual Agents med posodabljanjem dokumentacije in izobraževalne vsebine.

opomba,

Informacije o razpoložljivosti funkcije so naslednje.

Dynamics 365 središče za stike—vdelan	Dynamics 365 središče za stike – samostojno	Dynamics 365 Customer Service
No	Da	Da

Ta članek navaja kontekstne spremenljivke za Azure in Copilot Studio bote ter kako jih lahko konfigurirate v Vsi kanali za Customer Service. Če želite razumeti, kako ustvariti spremenljivke konteksta, glejte Upravljanje spremenljivk konteksta.

Spremenljivk konteksta za bote Azure

Naslednja tabela vsebuje seznam spremenljivk konteksta v dodatku Vsi kanali za Customer Service, ki jih lahko uporabite za konfiguracijo botov Azure.

Vrsta spremenljivke konteksta	Ime spremenljivke konteksta	Description	Kako izvesti preslikavo v Azure
Anketa pred pogovorom	Uporabite ime anketnega vprašanja pred pogovorom, ki ga ustvarite v Vsi kanali za Customer Service.	Sistem shrani odgovore iz ankete pred pogovorom kot spremenljivke konteksta.	Uporabite naslednje informacije za preslikavo imena vprašanja v Vsi kanali za Customer Service z vrsto spremenljivke v Azure: Ena vrstica: niz Več vrstic: niz Nabor možnosti: niz Soglasje uporabnika: logična vrednost
Kontekst po meri	Uporabite ime spremenljivke, ki jo ustvarite v aplikaciji Vsi kanali za Customer Service, ali posredujte z uporabo API-ja setContextProvider.	Kontekstne spremenljivke po meri, ki jih ustvarite, lahko posredujete prek SDK-ja za klepet v živo.	Preslikajte uporabnikov odgovor kot JSON za uporabo spremenljivke konteksta po meri v Vsi kanali za Customer Service.
Pogovor	msdyn_Conversationdata	Uporabite spremenljivko konteksta, ki vsebuje ID pogovora za tekoči pogovor in lahko pridobi in izvaja operacije v zapisu Microsoft Dataverse.	Niz: niz
Stik	msdyn_contact_msdyn_ocliveworkitem_Customer	Uporabite to spremenljivko konteksta, ki vsebuje ID zapisa za zapis stranke (stika), ki je povezan s pogovorom.	Razčlenitev formata JSON-a za izvlečenje ID-ja zapisa
Račun	msdyn_account_msdyn_ocliveworkitem_Customer	Uporabite to spremenljivko konteksta, ki vsebuje ID zapisa za zapis računa, ki je povezan s pogovorom.	Razčlenitev formata JSON-a za izvlečenje ID-ja zapisa
Primer	msdyn_incident_msdyn_ocliveworkitem	Uporabite to spremenljivko konteksta, ki vsebuje ID zapisa za zapis primera, ki je povezan s pogovorom.	Razčlenitev formata JSON-a za izvlečenje ID-ja zapisa

opomba,

Uporabite imena spremenljivk konteksta, kot so definirana, in jih ne spreminjajte, ko ustvarjate tokove v Azure ali Copilot Studio botih. Pri posredovanju vrednosti v spremenljivko konteksta prav tako ne pozabite uporabiti natančnega ujemanja, ker razlikujejo med velikimi in malimi črkami. Če pride do neujemanja, zapis ne bo samodejno identificiran. Več informacij: Samodejno prepoznavanje zapisov

Kontekstne spremenljivke za Copilot Studio bote

Naslednja tabela vsebuje seznam kontekstnih spremenljivk, ki so na voljo v Vsi kanali za Customer Service in jih lahko uporabite za konfiguriranje Copilot Studio botov.

Pomembno

Če želite uporabljati spremenljivke za sporočanje in glas, najprej namestite razširitvene rešitve.

Vrsta spremenljivke konteksta	Ime spremenljivke konteksta	Description	Kako preslikati v Copilot Studio
Anketa pred pogovorom	Uporabite ime anketnega vprašanja pred pogovorom, ki ga ustvarite v Vsi kanali za Customer Service.	Sistem shrani odgovore iz ankete pred pogovorom kot spremenljivke konteksta.	Uporabite naslednje informacije za preslikavo imena vprašanja v Vsi kanali za Customer Service s tipom spremenljivke v Copilot Studio: Ena vrstica: celoten odgovor uporabnika Več vrstic: celoten odgovor uporabnika Nabor možnosti: celoten odgovor uporabnika Soglasje uporabnika: logična vrednost
Kontekst po meri	Uporabite ime spremenljivke, ki ga ustvarite v Vsi kanali za Customer Service ali posredujete z setContextProvider API.	Kontekstne spremenljivke po meri, ki jih ustvarite, lahko posredujete prek SDK-ja za klepet v živo.	Uporabite naslednje informacije za preslikavo spremenljivke konteksta po meri v Vsi kanali za Customer Service s tipom spremenljivke v Copilot Studio: Niz: celoten odgovor uporabnika Logična vrednost: logična vrednost Številka, Plavajoča številka: številka
Pogovor	msdyn_Conversationdata	Uporabite spremenljivko konteksta, ki vsebuje ID pogovora za tekoči pogovor in lahko pridobi in izvaja operacije v zapisu Microsoft Dataverse.	Niz: celoten odgovor uporabnika.
Spremenljivke za sporočila in glas	msdyn_CustomerType	Uporabite to kontekstno spremenljivko, ki vsebuje vrsto stranke za račun ali kontakt zapis, povezan s pogovorom.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
	msdyn_CustomerName	Uporabite to spremenljivko konteksta, ki vsebuje ime stranke za zapis računa ali kontakt , povezan s pogovorom.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
	msdyn_CustomerId	Uporabite to spremenljivko konteksta, ki vsebuje ID stranke za zapis računa ali kontakt , povezan s pogovorom.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
	msdyn_CaseId	Uporabite to kontekstno spremenljivko, ki vsebuje ID zapisa primera, povezanega s pogovorom.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
	msdyn_CaseTitle	Uporabite to kontekstno spremenljivko, ki vsebuje naslov zapisa primera, povezanega s pogovorom.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
Sprmenljivke samo za glas	TelefonskaŠtevilkaStranke	Uporabite to spremenljivko konteksta za telefonsko številko stranke v dejavnosti telefonije.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
	TelefonskaŠtevilkaOrganizacije	Uporabite to kontekstno spremenljivko za telefonsko številko organizacije v dejavnosti Telefonija.	Izberite spremenljivko razširitvene rešitve za aplikacijo Vsi kanali za Customer Service.
Ime metode razširitve	va_SurveyConsent	S tem pogovornim oknom ugotovite, ali se je stranka med pogovorom strinjala s sodelovanjem v anketah.	Uporabite to metodo za eskalacijo podrobnosti pogovora v Vsi kanali za Customer Service.
	va_CustomerLocale	Uporabite to pogovorno okno za prenos uporabnika, ki se trenutno pogovarja z botom, k drugemu botu, ki lahko govori v drugem jeziku.	Nastavite kodo tako, da izberete vhodno spremenljivko in uporabite pravilno področno kodo.

Konfigurirajte spremenljivke konteksta za Copilot Studio bot

Če želite, da vaš Copilot Studio bot prebere kontekstne spremenljivke iz omnikanalen, naredite naslednje:

Na strani Teme izberite Dodaj tema in iz praznega.
Vnesite ime za svoj tema (na primer "Nastavi spremenljivke konteksta") in ga shranite.
Dodajte novo vozlišče v tema in izberite Upravljanje spremenljivk > Nastavite vrednost spremenljivke
V vašem novem vozlišču pod Nastavi spremenljivko izberite Ustvari novo spremenljivko.
Odprite podokno Lastnosti spremenljivke , tako da kliknete novo ime spremenljivke. V podoknu nastavite Ime spremenljivke tako, da se natančno ujema z imenom kontekstne spremenljivke omnikanalen (razlikuje med velikimi in malimi črkami).
V razdelku Reference izberite elipse (...) in izberite Pridobi vrednost iz tega vozlišča, če je prazno. Copilot Studio bot pridobi vrednost spremenljivke iz tega vozlišča med izvajanjem.
V razdelku Uporaba izberite Globalno (kateri koli tema ima dostop) in Zunanji viri lahko nastavijo vrednosti. Copilot Studio sprejema podatke iz omnikanalen. Zaprite podokno Lastnosti spremenljivke .
V svojem vozlišču vnesite vrednost v To value ki se ujema z vrsto podatkov, ki jo pričakuje vaš bot. Na primer, če vaš bot pričakuje niz, nastavite Text(""). Copilot Studio se vrne na vrednost, ki ste jo nastavili tukaj, če podatki ne prispejo v pogovor.
Shranite in objavite spremembe.

Med pogovorom so podatki iz spremenljivke konteksta omnikanalen nastavljeni v spremenljivkah Copilot Studio in jih je mogoče uporabiti v logiki bota.

Bot lahko med pogovorom tudi nastavi kontekstne spremenljivke omnikanalen. Če želite nastaviti spremenljivko omnikanalen iz vaše Copilot Studio logike, se prepričajte, da vaš bot uporablja pravilno ime spremenljivke in nastavite vrednost v lastnosti »V vrednost« v svojem vozlišču za upravljanje spremenljivk. Copilot Studio posreduje spremenljivko omnikanalen med prenesti posredniku. To se pogosto uporablja za povezavo pogovora s primerom, ko bot posreduje pogovor posredniku. Več informacij o povezovanju zapisov v omnikanalen iz teh podatkov: Povežite stranko in primer s pogovorom

Globalne spremenljivke, ki so ustvarjene v Copilot Studio , se lahko posredujejo v Vsi kanali za Customer Service, ko je pogovor eskaliran. Za celoten seznam glejte Kontekstualne spremenljivke, ki so na voljo ob oddaji.

Razčlenitev predmeta JSON-a za izvlečenje ID-ja zapisa

Poskrbite, da imate naslednje podrobnosti:

Spremenljivka konteksta aplikacije Vsi kanali za Customer Service, na primer msdyn_contact_msdyn_ocliveworkitem_Customer.
Podrobnosti sheme

Kopija podrobnosti vzorčne sheme je naslednja:

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

PrimaryDisplayValue vsebuje vrednost iz atributa v Dataverse entitetah. Preslikava za atribute entitete je naslednja:

Primeri: Naslov primera
Stiki: Polno ime
Računi: Ime

To je primer zapisa konteksta.

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

Glejte tudi

Integrirajte Copilot Studio bota
Integracija bota Azure
Konfigurirajte robote za stopnjevanje in zaključek pogovorov
Referenca SDK za klepet v živo

Deli z drugimi prek