Configurați variabilele de context pentru roboți

Articol
12/12/2023

Important

Power Virtual Agents capabilitățile și caracteristicile fac acum parte din Microsoft Copilot Studio urmarea unor investiții semnificative în IA generativă și integrări îmbunătățite Microsoft Copilot.

Unele articole și capturi de ecran se pot referi la Power Virtual Agents în timp ce actualizăm documentația și conținutul de instruire.

Acest articol listează variabilele de context pentru Azure și Copilot Studio boții și cum le puteți configura în Omnicanal pentru serviciu pentru relații cu clienții. Pentru a înțelege cum să creați variabile de context, consultați Gestionați variabilele de context.

Variabilele de context pentru roboți Azure

Următorul tabel conține lista variabilelor contextuale din Omnichannel pentru Customer Service pe care le puteți utiliza pentru configurarea roboților Azure.

Tip de variabilă de context	Nume variabilă de context	Descriere	Cum să mapați în Azure
Chestionar anterior conversației	Utilizați tipul de întrebare pe care îl creați în Omnicanal pentru Customer Service.	Variabilele de context pentru răspunsurile dinaintea conversației stochează răspunsurile clienților pentru întrebările din sondajul dinaintea conversației.	Utilizați următoarele informații pentru a mapa variabila de tip întrebare din Omnicanal pentru Customer Service cu tipul variabilei în Azure: O singură linie: Șir Linii multiple: Șir Set de opțiuni: Șir Consimțământul utilizatorului: Boolean
Context personalizat	Utilizați numele variabilei pe care îl creați în Omnicanal pentru Customer Service sau transmiteți folosind API-ul setContextProvider.	Acestea sunt variabile de context particularizate care pot fi create și transmise prin SDK-ul live chat.	Mapați răspunsul utilizatorului ca JSON pentru a utiliza variabila de context personalizată în Omnicanal pentru serviciu pentru relații cu clienții.
Conversație	msdyn_ConversationId	Utilizați variabila de context care conține ID-ul conversației pentru conversația în curs și poate prelua și efectua operațiuni în înregistrare în Microsoft Dataverse.	Șir: Șir
Persoană de contact	msdyn_contact_msdyn_ocliveworkitem_Customer	Utilizați această variabilă de context care conține ID-ul înregistrării pentru înregistrarea clientului (contact) care este legată de conversație.	Analizați JSON pentru a extrage ID-ul înregistrării
Cont	msdyn_account_msdyn_ocliveworkitem_Customer	Utilizați această variabilă de context care conține ID-ul înregistrării pentru înregistrarea contului legată de conversație.	Analizați JSON pentru a extrage ID-ul înregistrării
Caz	msdyn_incident_msdyn_ocliveworkitem	Utilizați această variabilă de context care conține ID-ul înregistrării pentru înregistrarea cazului legată de conversație.	Analizați JSON pentru a extrage ID-ul înregistrării

Notă

Utilizați numele variabilelor de context așa cum sunt definite și nu le modificați atunci când creați fluxuri în Azure sau Copilot Studio boți. De asemenea, asigurați-vă că utilizați potrivirea exactă pentru a transmite valoarea variabilei de context, deoarece face diferențiere litere mari și mici. Dacă există o nepotrivire, înregistrarea nu va fi identificată automat. Mai multe informații: Identificați automat înregistrările

Variabile de context pentru Copilot Studio boți

Următorul tabel conține lista variabilelor de context disponibile în Omnicanal pentru serviciu pentru relații cu clienții pe care le puteți utiliza pentru configurarea Copilot Studio boților.

Important

Pentru a putea folosi variabilele de mesagerie și voice, asigurați-vă că mai întâi că instalați soluțiile de extensie.

Tip de variabilă de context	Nume variabilă de context	Descriere	Cum să mapați Copilot Studio
Chestionar anterior conversației	Utilizați tipul de întrebare pe care îl creați în Omnicanal pentru Customer Service.	Variabilele de context pentru răspunsurile dinaintea conversației stochează răspunsurile clienților pentru întrebările din sondajul dinaintea conversației.	Utilizați următoarele informații pentru a mapa variabila tipul de întrebare din Omnicanal pentru serviciu pentru relații cu clienții cu tipul de variabilă în Copilot Studio: O singură linie: Întregul răspuns al utilizatorului Mai multe linii: Întregul răspuns al utilizatorului Set de opțiuni: Întregul răspuns al utilizatorului Consimțământul utilizatorului: Boolean
Context personalizat	Utilizați numele variabilei pe care îl creați în Omnicanal pentru serviciu pentru relații cu clienții sau transmiteți folosind API-ul setContextProvider.	Acestea sunt variabile de context particularizate care pot fi create și transmise prin SDK-ul live chat.	Utilizați următoarele informații pentru a mapa variabila de context personalizată în Omnicanal pentru serviciu pentru relații cu clienții cu tipul de variabilă în Copilot Studio: Șir: Întregul răspuns al utilizatorului Boolean: Boolean Număr, Număr în virgulă mobilă: Număr
Conversație	msdyn_ConversationId	Utilizați variabila de context care conține ID-ul conversației pentru conversația în curs și poate prelua și efectua operațiuni în înregistrare în Microsoft Dataverse.	Șir: Întregul răspuns al utilizatorului.
Variabile de mesagerie și voice	msdyn_CustomerType	Utilizați această variabilă contextuală care conține tipul de client pentru înregistrarea cont sau contact legată de conversație.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
	msdyn_CustomerName	Utilizați această variabilă contextuală care conține tipul de nume pentru înregistrarea cont sau contact legată de conversație.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
	msdyn_CustomerId	Utilizați această variabilă contextuală care conține ID-ul clientului pentru înregistrarea cont sau contact legată de conversație.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
	msdyn_CaseId	Utilizați această variabilă de context care conține ID-ul înregistrăriia cazului legat de conversație.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
	msdyn_CaseTitle	Utilizați această variabilă de context care conține titlul înregistrării cazului legat de conversație.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
Numai variabile voice	CustomerPhoneNumber	Utilizați această variabilă de context pentru numărul de telefon al clientului care este furnizat în activitatea de telefonie.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
	OrganizationPhoneNumber	Utilizați această variabilă de context pentru numărul de telefon al organizației care este furnizat în activitatea de telefonie.	Selectați variabila soluție extensie Omnichannel pentru Customer Service.
Nume metodă extensie	va_SurveyConsent	Utilizați acest dialog pentru a determina dacă un client a fost de acord să participe la sondaje în timpul conversației.	Utilizați această metodă pentru a escalada detaliile conversației către Omnicanal pentru Customer Service.
	va_CustomerLocale	Utilizați acest dialog pentru a transfera utilizatorul care vorbește în prezent cu robotul către un alt robot care poate vorbi într-o altă limbă.	Setați codul selectând variabila de intrare și utilizând codul local corect.

Configurați variabilele de context pentru Copilot Studio bot

În Copilot Studio, procedați în felul următor:

Pe pagina Subiecte, selectați Subiect nou.
Pe fila Configurare, introduceți un nume și o descriere și salvați subiectul.
Selectați Accesați pânza de autor.
Selectați Adăugați nod, alegeți acțiunea Pune o întrebare.
Editați câmpul Identificați și în caseta de dialog Alegeți informații pe care să le identificați, selectați o opțiune care se va potrivi cu tipul de date al variabilei de context. Pentru informații despre maparea tipului de date, consultați informațiile din tabelul precedent.
Editați Salvați răspunsul ca și în caseta de dialog Proprietăți variabile actualizați valoarea pentru Nume cu variabila contextuală necesară Omnicanal pentru Customer Service. Asigurați-vă că Robot (orice subiect poate accesa) și Sursele externe pot seta valori sunt selectate. Opțiunea Sursele externe pot seta valori este aplicabilă numai pentru obținerea variabilei de context.
Salvați și publicați modificările.

În timpul rulării, informațiile necesare sunt capturate în variabila contextuală care poate fi apoi utilizată pentru acțiuni ulterioare pe baza fluxului de lucru pe care îl configurați. Robotul poate seta informațiile pentru variabilele de context pentru a conecta conversația și cazurile când robotul trimite conversația către un agent. Mai multe informatii: Conectați clientul și cazul la o conversație

De asemenea, puteți configura nodul Transfer la agent din subiectul Copilot Studio pentru a trimite un mesaj privat cu variabilele de context relevante agentului activ în timpul escaladării.

Variabilele globale care sunt create în Copilot Studio pot fi transmise către Omnicanal pentru serviciu pentru relații cu clienții atunci când o conversație este escaladată. Pentru lista completă, consultați Variabile contextuale disponibile la transmitere.

Analizați obiectul JSON pentru a extrage ID-ul înregistrării

Asigurați-vă că aveți următoarele detalii:

Variabila de context Omnicanal pentru Customer Service, cum ar fi msdyn_contact_msdyn_ocliveworkitem_Customer.
Detaliile schemei

O copie a detaliilor schemei eșantion este după cum urmează:

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

PrimaryDisplayValue va conține valoarea din atributul din entitățile Dataverse. Cartarea atributelor entității este după cum urmează:

Cazuri: Titlu de caz
Persoane de contact: Nume complet
Conturi: Nume

Iată un exemplu de înregistrare de context:

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

Consultați și

Integrați un Copilot Studio bot
Integrați un robot Azure
Configurați roboții pentru a escalada și a încheia conversațiile
Referință SDK pentru chat live

Share via