Konfigurisanje promenljivih konteksta za robote

Članak
06/25/2024

Važno

Power Virtual Agents mogućnosti i karakteristike su sada deo prateći značajna Microsoft Copilot Studio ulaganja u generativnu AI i poboljšanu integraciju širom sveta Microsoft Copilot.

Neki članci i snimci ekrana mogu da se odnose na vreme Power Virtual Agents dok ažuriramo dokumentaciju i sadržaj obuke.

Ovaj članak navodi promenljive konteksta za Azure i botove Copilot Studio i kako ih možete konfigurisati u Više kanala za Customer Service. Da biste razumeli kako da kreirate promenljive konteksta, pogledajte članak Upravljanje promenljivama konteksta.

Promenljive konteksta za Azure robote

Sledeća tabela sadrži listu promenljivih konteksta u Više kanala za Customer Service koje možete koristiti za konfigurisanje Azure robota.

Tip promenljive konteksta	Naziv promenljivih konteksta	Opis	Kako mapirati u usluzi Azure
Anketa pre razgovora	Koristite ime pitanja ankete pre razgovora koje kreirate u Više kanala za Customer Service.	Sistem skladišti odgovore iz ankete pre razgovora kao promenljive konteksta.	Koristite sledeće informacije da biste mapirali ime pitanja u Više kanala za Customer Service sa tipom promenljive u Azure: Jedan red: Niska Više redova: Niska Skup opcija: Niska Pristanak korisnika: Logička vrednost
Prilagođeni kontekst	Koristite naziv promenljive koju kreirate u Više kanala za Customer Service ili prosledite koristeći setContextProvider API.	Prilagođene kontekstualne promenljive koje kreirate mogu da se prosleđuju kroz SDK za ćaskanje uživo.	Mapiraj korisnički odgovor JSON da koristi prilagođenu kontekstualu promenljivu u Više kanala za Customer Service.
Razgovor	msdyn_ConversationId	Koristite promenljivu konteksta koja sadrži ID razgovora za tekući razgovor i može dohvatati i izvoditi operacije nad zapisom u usluzi Microsoft Dataverse.	Niska: Niska
Kontakt	msdyn_contact_msdyn_ocliveworkitem_Customer	Koristite ovu promenljivu konteksta koja sadrži ID zapisa za zapis klijenta (kontakta) koji je povezan sa razgovorom.	Raščlanite JSON da biste izvukli ID zapisa
Poslovni kontakt	msdyn_account_msdyn_ocliveworkitem_Customer	Koristite ovu promenljivu konteksta koja sadrži ID zapisa za zapis poslovnog kontakta koji je povezan sa razgovorom.	Raščlanite JSON da biste izvukli ID zapisa
Predmet	msdyn_incident_msdyn_ocliveworkitem	Koristite ovu promenljivu konteksta koja sadrži ID zapisa za zapis predmeta koji je povezan sa razgovorom.	Raščlanite JSON da biste izvukli ID zapisa

Belešku

Koristite imena promenljivih konteksta kao što je definisano i nemojte ih menjati kada autor teče u Azure ili Copilot Studio botovima. Takođe, uverite se da koristite tačno podudaranje da biste prosledili vrednost u promenljivu konteksta, jer je osetljiva na velika i mala slova. Ako dođe do nepodudaranja, zapis neće biti automatski identifikovan. Još informacija: Automatsko identifikovanje zapisa

Kontekstualne promenljive za Copilot Studio botove

Sledeća tabela sadrži listu kontekstualnih promenljivih dostupnih u Više kanala za Customer Service koje možete koristiti za konfigurisanje Copilot Studio botova.

Važno

Da biste koristili poruke i glasovne promenljive, uverite se da ste prvo instalirali rešenja proširenja.

Tip promenljive konteksta	Naziv promenljivih konteksta	Opis	Kako mapirati u Copilot Studio
Anketa pre razgovora	Koristite ime pitanja ankete pre razgovora koje kreirate u Više kanala za Customer Service.	Sistem skladišti odgovore iz ankete pre razgovora kao promenljive konteksta.	Koristite sledeće informacije da biste mapirali ime pitanja u Više kanala za Customer Service sa tipom promenljive u Copilot Studio: Jedan red: Korisnikov ceo odgovor Više redova: Korisnikov ceo odgovor Skup opcija: Korisnikov ceo odgovor Pristanak korisnika: Logička vrednost
Prilagođeni kontekst	Koristite promenljivo ime koje kreirate u Više kanala za Customer Service ili prosledite pomoću API-ja setContextProvider.	Prilagođene kontekstualne promenljive koje kreirate mogu da se prosleđuju kroz SDK za ćaskanje uživo.	Koristite sledeće informacije da biste mapirali prilagođenu kontekstualu promenljivu Više kanala za Customer Service sa tipom promenljive u Copilot Studio: Niska: Korisnikov ceo odgovor Logička vrednost: Logička vrednost Broj, broj sa pokretnim zarezom: Broj
Razgovor	msdyn_ConversationId	Koristite promenljivu konteksta koja sadrži ID razgovora za tekući razgovor i može dohvatati i izvoditi operacije nad zapisom u usluzi Microsoft Dataverse.	Niska: Korisnikov ceo odgovor.
Promenljive razmene poruka i glasovnog kanala	msdyn_CustomerType	Koristite ovu kontekstualna promenljivu koja sadrži vrstu klijenta za zapis poslovnog kontakta ili kontakta povezanog sa razgovorom.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
	msdyn_CustomerName	Koristite ovu kontekstualna promenljivu koja sadrži ime kupca za zapis naloga ili kontakta povezanog sa razgovorom.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
	msdyn_CustomerId	Koristite ovu kontekstualnu promenljivu koja sadrži ID kupca za zapis poslovnog kontakta ili kontakta povezan sa razgovorom.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
	msdyn_CaseId	Koristite ovu kontekstualnu promenljivu koja sadrži ID zapisa predmeta povezanog sa razgovorom.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
	msdyn_CaseTitle	Koristite ovu kontekstualna promenljiva koja sadrži naslov zapisa predmeta povezanog sa razgovorom.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
Promenljive samo glasovnog kanala	CustomerPhoneNumber	Koristite ovu kontekstualnu promenljivu za broj telefona kupca u aktivnosti telefonije.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
	OrganizationPhoneNumber	Koristite ovu kontekstualnu promenljivu za broj telefona organizacije u aktivnosti telefonije.	Izaberite promenljivu rešenja proširenja za Više kanala za Customer Service.
Naziv metoda proširenja	va_SurveyConsent	Koristite ovaj dijalog da biste utvrdili da li je klijent pristao da učestvuje u anketama tokom razgovora.	Koristite ovaj metod da biste eskalirali detalje o razgovoru u Više kanala za Customer Service.
	va_CustomerLocale	Koristite ovaj dijalog da biste prebacili korisnika koji trenutno razgovara sa robotom na drugog robota koji može da govori drugim jezikom.	Postavite kôd tako što ćete izabrati ulaznu promenljivu i koristiti ispravnu šifru lokalnog standarda.

Konfigurisanje kontekstualnih promenljivih za Copilot Studio bota

Da bi vaš Copilot Studio bot pročitao kontekstualne promenljive na više kanala, uradite sledeće korake:

Na stranici " Teme" izaberite stavku Dodaj tema i iz praznog.
Unesite ime za svoju tema (na primer, "Postavi promenljive konteksta") i sačuvajte je.
Dodajte novi tema i izaberite opciju "Postavi promenljivu > vrednost"
U novom čmiku, u okviru Postavi promenljivu izaberite Stavku Kreiraj novu promenljivu.
Otvorite okno sa svojstvima promenljive tako što ćete kliknuti na novo ime promenljive. U oknu podesite ime promenljive tako da se na više kanala ime kontekstualne promenljive (to tačno znači da ima mala i velika slova).
U odeljku Referenca izaberite elipse (...) i izaberite Stavku Uzmi vrednost iz ovog oglasa ako je prazna. Bot Copilot Studio preuzima promenljivu vrednost iz ovog čmaka u vreme izvršavanja.
U odeljku Korišćenje izaberite stavku Globalno (svim tema mogu da pristupe), a spoljni izvori mogu da postave vrednosti. Copilot Studio prihvata podatke iz na više kanala. Zatvorite okno sa svojstvima promenljive .
U svoju glavu unesite vrednost u Vrednost koja odgovara tipu podataka koji vaš bot očekuje. Na primer, ako vaš bot očekuje nisku, postavite text(""). Copilot Studio pada na vrednost koju ste ovde postavili ako podaci ne stignu u razgovor.
Sačuvajte i objavite promene.

Tokom razgovora, podaci iz na više kanala su postavljeni u Copilot Studio promenljive i mogu se koristiti po logici bota.

Bot takođe može da na više kanala promenljive konteksta tokom razgovora. Da biste postavili na više kanala promenljivu iz Copilot Studio vaše logike, uverite se da vaš bot koristi ispravno promenljivo ime i postavite vrednost u svojstvu "Do vrednosti" u vašem promenljivom upravljačkom čmu. Copilot Studio dalje ruke od promenljive da na više kanala tokom preneti agentu. Ovo se često koristi za povezivanje razgovora sa slučajem kada bot eskalira razgovor sa agentom. Više informacija o povezivanju zapisa u na više kanala iz e-e podataka: Povežite kupca i predmet sa razgovorom

Globalne promenljive koje su kreirane u Copilot Studio njima mogu se preneti Više kanala za Customer Service kada razgovor eskalira. Za kompletnu listu, pogledajte Promenljive konteksta dostupne na dohvat ruke.

Raščlanite JSON objekat da biste izvukli ID zapisa

Uverite se da imate sledeće detalje:

Promenljiva konteksta u Više kanala za Customer Service, kao što je msdyn_contact_msdyn_ocliveworkitem_Customer.
Detalji šeme

Kopija detalja šeme uzorka je sledeća:

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

PrimaryDisplayValue sadrži vrednost iz atributa u entitetima Dataverse . Mapiranje za atribute entiteta je sledeće:

Predmeti: Naslov predmeta
Kontakti: Ime i prezime
Poslovni kontakti: Ime

Evo primera zapisa konteksta.

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

Pogledajte i ovo

Integrisati Copilot Studio bota
Integrisanje Azure robota
Konfigurisanje botova za eskalaciju i okončanje razgovora
SDK referenca za ćaskanje uživo

Deli putem