Comparteix a través de

Configurar variables de context per a bots

  • Article

Important

Power Virtual Agents Les capacitats i les funcions ara formen part de Microsoft Copilot Studio les inversions significatives en IA generativa i integracions millorades Microsoft Copilot.

Alguns articles i captures de pantalla poden fer referència mentre Power Virtual Agents actualitzem la documentació i el contingut de formació.

Nota

La informació de disponibilitat de les funcions és la següent.

Dynamics 365 centre de contactes—incrustat Dynamics 365 centre de contactes—independent Dynamics 365 Customer Service
No Sí Sí

En aquest article s'enumeren les variables de context per a l'Azure i Copilot Studio els bots, i com podeu configurar-les a Plataforma omnicanal per al Customer Service. Per comprendre com podeu crear variables de context, vegeu Administrar variables de context.

Variables de context per a bots de l'Azure

La taula següent conté la llista de variables de context de la Plataforma omnicanal per al Customer Service que podeu utilitzar per configurar bots a l'Azure.

Tipus de variable de context Nom de la variable de context Descripció Com assignar a l'Azure
Enquesta prèvia a la conversa Utilitzeu el nom de pregunta de l'enquesta prèvia a la conversa que creeu a Plataforma omnicanal per al Customer Service. El sistema emmagatzema les respostes de l'enquesta prèvia a la conversa com a variables de context. Utilitzeu la informació següent per assignar el nom de la pregunta a Plataforma omnicanal per al Customer Service amb el tipus de variable de l'Azure:
  • Una línia: cadena
  • Diverses línies: cadena
  • Conjunt d'opcions: cadena
  • Consentiment de l'usuari: booleà
Context personalitzat Utilitzeu el nom de la variable que creeu a la Plataforma omnicanal per al Customer Service o passeu-la per mitjà de l'API setContextProvider. Les variables de context personalitzades que creïs es poden transferir a través de l'SDK del xat en directe. Assigneu el resposta de l'usuari com a JSON per utilitzar la variable de context personalitzada a Plataforma omnicanal per al Customer Service.
Conversa msdyn_ConversationId Utilitzeu la variable de context que conté l'identificador de la conversa per a la conversa en curs i que pot extreure i realitzar operacions al registre de Microsoft Dataverse. Cadena: cadena
Contacte msdyn_contact_msdyn_ocliveworkitem_Customer Utilitzeu aquesta variable de context que conté l'identificador de registre del registre de client (contacte) que s'enllaça amb la conversa. Analitzar el JSON per extreure l'ID del registre
Compte msdyn_account_msdyn_ocliveworkitem_Customer Utilitzeu aquesta variable de context que conté l'identificador de registre del compte que s'enllaça amb la conversa. Analitzar el JSON per extreure l'ID del registre
Cas msdyn_incident_msdyn_ocliveworkitem Utilitzeu aquesta variable de context que conté l'identificador de registre del cas que s'enllaça amb la conversa. Analitzar el JSON per extreure l'ID del registre

Nota

Utilitzeu els noms de les variables de context tal com es defineixen i no els canvieu quan creeu fluxos a l'Azure o Copilot Studio als bots. Assegureu-vos també d'utilitzar la coincidència exacta per enviar el valor a la variable de context, ja que distingeix entre majúscules i minúscules. Si no hi ha coincidencia, el registre no s'identificarà automàticament. Més informació: Identificar automàticament els registres.

Variables de context per als Copilot Studio bots

La taula següent conté la llista de variables de context disponibles a Plataforma omnicanal per al Customer Service que podeu utilitzar per configurar Copilot Studio bots.

Important

Per utilitzar les variables de missatgeria i de veu, assegureu-vos d'instal·lar primer les solucions d'extensions.

Tipus de variable de context Nom de la variable de context Descripció Com cartografiar en Copilot Studio
Enquesta prèvia a la conversa Utilitzeu el nom de pregunta de l'enquesta prèvia a la conversa que creeu a Plataforma omnicanal per al Customer Service. El sistema emmagatzema les respostes de l'enquesta prèvia a la conversa com a variables de context. Utilitzeu la informació següent per assignar el nom de la pregunta en Plataforma omnicanal per al Customer Service amb el tipus de variable en Copilot Studio:
  • Una línia: resposta completa de l'usuari
  • Diverses línies: resposta completa de l'usuari
  • Conjunt d'opcions: resposta completa de l'usuari
  • Consentiment de l'usuari: booleà
Context personalitzat Utilitzeu el nom de la variable que creeu a Plataforma omnicanal per al Customer Service o passeu mitjançant l'API setContextProvider. Les variables de context personalitzades que creïs es poden transferir a través de l'SDK del xat en directe. Utilitzeu la informació següent per assignar la variable de context personalitzada en Plataforma omnicanal per al Customer Service amb el tipus de variable en Copilot Studio:
  • Cadena: resposta completa de l'usuari
    • Booleà: booleà
  • Nombre, Nombre flotant: nombre
Conversa msdyn_ConversationId Utilitzeu la variable de context que conté l'identificador de la conversa per a la conversa en curs i que pot extreure i realitzar operacions al registre de Microsoft Dataverse. Cadena: resposta completa de l'usuari.
Variables de missatgeria i de veu msdyn_CustomerType Utilitzeu aquesta variable de context que conté el tipus de client per al registre de compte o de contacte enllaçat a la conversa. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
msdyn_CustomerName Utilitzeu aquesta variable de context que conté el nom de client del registre de compte o de contacte enllaçat a la conversa. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
msdyn_CustomerId Utilitzeu aquesta variable de context que conté l'identificador de client del registre de compte o de contacte enllaçat a la conversa. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
msdyn_CaseId Utilitzeu aquesta variable de context que conté l'identificador del registre del cas enllaçat a la conversa. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
msdyn_CaseTitle Utilitzeu aquesta variable de context que conté el títol del registre del cas vinculat a la conversa. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
Variables només de veu CustomerPhoneNumber Utilitzeu aquesta variable de context per al número de telèfon del client a l'activitat de Telefonia. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
OrganizationPhoneNumber Utilitzeu aquesta variable de context per al número de telèfon de l'organització a l'activitat de Telefonia. Seleccioneu la variable de la solució d'extensió de la Plataforma omnicanal per al Customer Service.
Nom del mètode d'extensió va_SurveyConsent Utilitzeu aquest diàleg per determinar si un client ha acceptat participar en enquestes durant la conversa. Utilitzeu aquest mètode per escalar els detalls de les converses a la Plataforma omnicanal per al Customer Service.
va_CustomerLocale Utilitzeu aquest diàleg per transferir l'usuari que en aquest moment està parlant amb el bot a un altre bot que parli una altra llengua. Per definir el codi, seleccioneu la variable d'entrada i utilitzeu el codi de configuració regional correcte.

Configurar les variables de context per al Copilot Studio bot

Perquè el vostre Copilot Studio bot llegeixi variables de context de omnicanal, seguiu aquests passos:

  1. A la pàgina Temes , seleccioneu Afegeix un tema i des de zero.

  2. Introduïu un nom per al tema (per exemple, "Defineix variables de context") i deseu-lo.

  3. Afegiu un node nou al tema i seleccioneu Gestió de variables > Definir un valor de variable

  4. Al node nou, a Defineix la variable , seleccioneu Crea una variable nova.

  5. Per obrir la subfinestra Propietats variables , feu clic al nom de la variable nova. A la subfinestra, definiu el nom de la variable perquè coincideixi exactament amb el nom de la variable de context omnicanal (distingeix entre majúscules i minúscules).

  6. A la secció Referència , seleccioneu les el·lipses (...) i seleccioneu Obtén valor d'aquest node si està buit. El Copilot Studio bot recupera el valor de la variable d'aquest node en temps d'execució.

  7. A la secció Ús , seleccioneu Global (qualsevol tema pot accedir) i Fonts externes poden establir valors. Copilot Studio accepta dades de omnicanal. Tanqueu la subfinestra Propietats variables .

  8. Al node, introduïu un valor al valor Per a que coincideixi amb el tipus de dades que espera el vostre bot. Per exemple, si el bot espera una cadena, definiu Text(""). Copilot Studio torna al valor que heu definit aquí si les dades no arriben a la conversa.

    Configurar una variable de context en un tema.

  9. Desa i publica els canvis.

Durant una conversa, les dades de la variable de context omnicanal s'estableixen a les variables i es poden utilitzar en la Copilot Studio lògica del bot.

El bot també pot establir variables de context omnicanal durant una conversa. Per definir una variable omnicanal a partir de la vostra Copilot Studio lògica, assegureu-vos que el bot utilitza el nom de la variable correcte i definiu el valor a la propietat "Per valorar" del node de gestió de variables. Copilot Studio lliura la variable a omnicanal durant la transferència a l'agent. Sovint s'utilitza per enllaçar la conversa amb un cas en què el bot intensifica la conversa amb un agent. Més informació sobre com enllaçar registres en omnicanal a partir d'aquestes dades: Vincular client i cas a una conversa

Les variables globals que es creen es Copilot Studio poden passar a Plataforma omnicanal per al Customer Service quan s'intensifica una conversa. Per veure la llista completa, vegeu Variables contextuals disponibles en transferir.

Analitzar l'objecte JSON per extreure l'ID del registre

Assegureu-vos que teniu les dades següents:

  • La variable de context de la Plataforma omnicanal per al Customer Service, com ara msdyn_contact_msdyn_ocliveworkitem_Customer.
  • Els detalls de l'esquema

Una còpia dels detalls de l'esquema d'exemple és així:

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

PrimaryDisplayValue conté el valor de l'atribut a les Dataverse entitats. L'assignació dels atributs d'entitat és la següent:

  • Casos: títol del cas
  • Contactes: nom complet
  • Compte: nom

Aquí teniu un registre de context d'exemple.

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

Consulteu també

Integrar un Copilot Studio bot
Integrar un bot de l'Azure
Configurar bots per escalar i finalitzar converses
Referència de l'SDK del xat en directe