Jaa


Kontekstimuuttujien määrittäminen tekoälyagenteille

Koskee: Dynamics 365 Customer Service ja Dynamics 365 Contact Center – vain erilliskäyttö

Huomautus

Copilot Studio -botti nimetään uudelleen Copilot agentiksi (agentiksi tai tekoälyagentiksi). Ihmisasiakaspalvelija on nyt nimetty uudelleen asiakaspalvelijaksi. Saatat löytää viittauksia vanhoihin ja uusiin termeihin, kun päivitämme tuotteen käyttöliittymää, dokumentaatiota ja koulutussisältöä.

Tässä artikkelissa luetellaan Azure- ja Copilot-agenttien kontekstimuuttujat ja se, miten voit määrittää ne Dynamics 365 Contact Center. Tietoja kontekstimuuttujien luomisesta on ohjeaiheessa Kontekstimuuttujien hallinta.

Copilot agenttien kontekstimuuttujat

Seuraava taulukko sisältää luettelon Dynamics 365 Contact Center käytettävissä olevista kontekstimuuttujista, joita voit käyttää >Copilot agentien määrittämisessä.

Tärkeää

  • Jotkin muuttujat ovat helpommin käytettävissä, jos asennat laajennusratkaisut.
  • Copilot Studio voi vastaanottaa muuttujia asynkronisesti keskustelun aikana. Tämän ansiosta tekoälyagentti voi tervehtiä käyttäjiäsi pienellä viiveellä samalla, kun hän käyttää Yhteystietokeskuksen tarjoamia mukautettuja tietoja keskustelun aikana. Kun suunnittelet agenttia, ota huomioon sekä tietolähteet että noutoajat, koska Dataverse-ympäristöjen tiedoissa saattaa ilmetä viiveitä. Määritä muuttujan määrityksen aikakatkaisuasetukset niin, että myöhään saapuvien tietojen hallinta on oikein. Lisätietoja on artikkelissa Yleisten muuttujien määrittäminen ulkoisista lähteistä.
Kontekstimuuttujan tyyppi Kontekstimuuttujan nimi Description Kartoitus Copilot Studiossa
Keskustelua edeltävä kysely Käytä keskustelua edeltävän kyselyn kysymyksen nimeä, jonka luot Dynamics 365 Contact Center. Järjestelmä tallentaa keskustelua edeltävän kyselyn vastaukset kontekstimuuttujina. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center kysymyksen nimen Copilot Studion muuttujatyyppiin:
  • Yksi rivi: käyttäjän koko vastaus
  • Useita rivejä: käyttäjän koko vastaus
  • Asetusjoukko: käyttäjän koko vastaus
  • Käyttäjän suostumus: totuusarvo
Mukautettu konteksti keskustelulle Käytä Dynamics 365 Contact Center tai välitystilassa luomaasi muuttujan nimeä käyttämällä setContextProvider-ohjelmointirajapintaa. Luomasi mukautetut kontekstimuuttujat voidaan välittää live-keskustelun SDK:n kautta. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center mukautetun kontekstimuuttujan Copilot Studion muuttujatyypillä:
  • Merkkijono: käyttäjän koko vastaus
  • Boolean: Boolean
  • Numero, Liukuluku: numero
Mukautettu konteksti Direct Linelle Käytä muuttujan nimeä, jonka luot Dynamics 365 Contact Center. Luomasi mukautetut kontekstimuuttujat voidaan välittää avain-arvo-pareina Activity.ChannelData.ConversationContext-kohteessa, kun DirectLine-asiakasohjelma aloittaa keskustelun. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center mukautetun kontekstimuuttujan Copilot Studion muuttujatyypillä:
  • Merkkijono: käyttäjän koko vastaus
  • Boolean: Boolean
  • Numero, Liukuluku: numero
Työn luokittelusääntöjen määrittämät muuttujat Käytä Contact Centerin hallintakeskuksessa luomaasi muuttujan nimeä. Työn luokittelusääntöjen osana luodut mukautetut muuttujat edellyttävät lisäkäsittelyaikaa kontekstin luomiseksi. Määritä tekoälyagentisi työluokittelukontekstin aikakatkaisu. Lisätietoja on artikkelissa Yleisten muuttujien määrittäminen ulkoisista lähteistä. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center mukautetun kontekstimuuttujan Copilot Studion muuttujatyypillä:
  • Merkkijono: käyttäjän koko vastaus
  • Boolean: Boolean
  • Numero, Liukuluku: numero
Keskustelu msdyn_ConversationId Käytä kontekstimuuttujaa, joka sisältää keskustelun tunnuksen meneillään olevaa keskustelua varten, ja voit noutaa ja suorittaa toimintoja tietueelle Microsoft Dataverse. Merkkijono: käyttäjän koko vastaus.
Vain viesti -muuttujat msdyn_CustomerType 1 Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn asiakkuus- tai yhteyshenkilötietueen asiakastyypin. Valitse monikanavaisen laajennuksen ratkaisumuuttuja.
msdyn_CustomerName 1 Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn asiakkuus- tai yhteyshenkilötietueen asiakkaan nimen. Valitse monikanavaisen laajennuksen ratkaisumuuttuja.
msdyn_CustomerId 1 Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn asiakkuus- tai yhteyshenkilötietueen asiakastunnuksen. Valitse monikanavaisen laajennuksen ratkaisumuuttuja.
msdyn_CaseId 1 Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn palvelupyyntötietueen tunnuksen. Tiedot noudetaan Dataverse-ympäristöstä osana automaattista asiakkaan tunnistamista. Näin ollen tekoälyagenttisi saattaa kokea viivettä tietojen vastaanottamisessa. Valitse monikanavaisen laajennuksen ratkaisumuuttuja.
msdyn_CaseTitle 1 Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn palvelupyyntötietueen otsikon. Valitse monikanavaisen laajennuksen ratkaisumuuttuja.
msdyn_ChannelInstanceId Channel Instance -tietueen Dataverse-yksilöivä tunnus, esimerkiksi määritetyn chat-pienoissovelluksen yksilöivä tunnus tai Facebook-sivu. Merkkijono: käyttäjän koko vastaus.
msdyn_WorkstreamId Kanavaesiintymään liittyvän työvirran Dataverse-yksilöllinen tunnus. Merkkijono: käyttäjän koko vastaus.
msdyn_Locale Määritetty kieliasetuskoodi kanavan esiintymässä, esimerkiksi keskustelupienoissovellus tai Facebook-sivu. Tätä voidaan käyttää esimerkiksi monikielisten Copilot Studio -agenttien kanssa. Merkkijono: käyttäjän koko vastaus.
msdyn_SocialProfileId Keskusteluun liittyvän yhteisöpalveluprofiilin Dataverse-tietueen yksilöllinen tunnus. Merkkijono: käyttäjän koko vastaus.
msdyn_LineCustomerName Asiakkaan nimi LINE-ohjelmointirajapinnasta. Merkkijono: käyttäjän koko vastaus.
msdyn_TeamsCustomerName Asiakkaan nimi kohteesta Microsoft Teams. Merkkijono: käyttäjän koko vastaus.
msdyn_TeamsCustomerEmail Microsoft Teams sähköpostiosoite (UPN). Merkkijono: käyttäjän koko vastaus.
msdyn_CapabilityList Apple Messages for Businesses -ominaisuusluetteloarvot eroteltuna merkkijonona. Merkkijono: käyttäjän koko vastaus.
msdyn_AppleMessagesForBusinessGroupId Apple-viestit yrityksille -ryhmän tunnus. Merkkijono: käyttäjän koko vastaus.
msdyn_AppleMessagesForBusinessIntentId Apple Viestit yrityksille Intent-tunnus. Merkkijono: käyttäjän koko vastaus.
msdyn_AppleMessagesForBusinessLocale Aluekohtaiset asetukset, jotka on antanut Apple Messages for Businesses -ohjelmointirajapinta. Merkkijono: käyttäjän koko vastaus.
msdyn_AppleBusinessId Y-tunnus Apple Messages for Business -tililtäsi. Merkkijono: käyttäjän koko vastaus.
msdyn_FacebookCustomerName Asiakkaan nimi Facebookista. Merkkijono: käyttäjän koko vastaus.
msdyn_FacebookLocale Asiakkaan aluekohtaiset asetukset Facebookista. Merkkijono: käyttäjän koko vastaus.
msdyn_FacebookTimezone Asiakkaan aikavyöhyke Facebookista. Merkkijono: käyttäjän koko vastaus.
msdyn_FacebookUserPageScopedId Asiakkaan sivukohtainen käyttäjätunnus Facebookista. Merkkijono: käyttäjän koko vastaus.
msdyn_FacebookPageId PageID Facebook-sivultasi. Merkkijono: käyttäjän koko vastaus.
msdyn_AsiakasPuhelinnumero Puhelinnumero, jossa asiakas soittaa WhatsApp- ja SMS-kanavilla. Merkkijono: käyttäjän koko vastaus.
msdyn_OrganisaationPuhelinnumero Tämä on puhelinnumero, joka vastaanottaa viestejä asiakkaalta (organisaatiosi numero). Huomaa, että tätä ei välitetty WhatsAppissa Azure Communication Services kautta. Merkkijono: käyttäjän koko vastaus.
msdyn_WhatsAppCustomerFirstMessage Jos käytät esitäytettyä sanomaa WhatsAppin yleislinkissä, nämä tiedot välitetään tähän muuttujaan. Merkkijono: käyttäjän koko vastaus.
Vain ääni -muuttujat 2 Activity.From.Name Käytä tätä kontekstimuuttujaa asiakkaan Puhelintoiminta-aktiviteetin puhelinnumeroon. Määritä tämä muuttuja yleiseen muuttujaan Keskustelun aloitus -aiheessa. Lue lisää kohdasta Kontekstimuuttujien määrittäminen Copilot Studio -agentille. Valitse järjestelmämuuttuja Microsoft Copilot Studio.
Activity.Recipient.Name Käytä tätä kontekstimuuttujaa organisaation Puhelintoiminta-aktiviteetin puhelinnumeroon. Määritä tämä muuttuja yleiseen muuttujaan Keskustelun aloitus -aiheessa. Lue lisää kohdasta Kontekstimuuttujien määrittäminen Copilot Studio -agentille. Valitse järjestelmämuuttuja Microsoft Copilot Studio.
Laajennusmenetelmän nimi. va_KyselynSuostumus Tämän valintaikkunan avulla voit selvittää, onko asiakas suostunut osallistumaan kyselyihin keskustelun aikana. Tämän menetelmän avulla voit eskaloida keskustelun tiedot Dynamics 365 Contact Centerille.
va_CustomerLocale Tämän valintaikkunan avulla voit siirtää agentille parhaillaan puhuvan käyttäjän toiseen agenttiin, joka puhuu eri kielellä. Määritä koodi valitsemalla syötemuuttuja ja käyttämällä oikeaa maakoodia.

1 Jos haluat käyttää muita kontekstimuuttujia, voit hankkia ne Copilot Studiosta. Lisätietoja on kohdassa Muuttujien käsitteleminen.

kontekstimuuttujien määrittäminen Copilot agentille

Jos haluat Copilot agentin lukevan kontekstimuuttujia Dynamics 365 Contact Center, toimi seuraavasti:

  1. Valitse Aiheet-sivullaLisää aihe>tyhjästä. Käytä aihetta, jota ei ole käynnistetty tai joka on jo olemassa, koska muuten kontekstimuuttuja ei toimi.

  2. Anna aiheelle nimi, kuten Määritä kontekstimuuttujat, ja tallenna se.

  3. Lisää uusi solmu aiheeseen ja valitse Muuttujan hallinta > Määritä muuttujan arvo.

  4. Valitse Luo uusi muuttuja uuden solmusi kohdassa Määritä muuttuja.

  5. Avaa Muuttujan ominaisuudet -ruutu valitsemalla uusi muuttujan nimi. Määritä ruudussa Muuttujan nimi vastaamaan kokokanavan kontekstimuuttujan nimeä tarkasti (kirjainkoko on merkitsevä).

  6. Valitse Viittaus-osassa pystysuuntaiset kolme pistettä ja valitse sitten Nouda arvo tästä solmusta, jos se on tyhjä. Copilot Studio -agentti noutaa muuttuja-arvon tästä solmusta suorituksen aikana.

  7. Usage -osassa valitse Global (mikä tahansa aihe voi käyttää) ja External-lähteet voivat määrittää arvoja niin, että Copilot Studio -agentti hyväksyy monikanavan tiedot ja tätä muuttujaa voidaan käyttää missä tahansa aiheessa.

  8. Jos käytät muuttujassa työn luokittelusääntöjen tietoja, varmista, että määrität muuttujan määrityksessä aikakatkaisun pituuden. Lisätietoja on artikkelissa Yleisten muuttujien määrittäminen ulkoisista lähteistä.

  9. Sulje Muuttujan ominaisuudet -ruutu.

  10. Kirjoita solmussasi kenttään To value arvo, joka vastaa agenttisi odottamaa tietotyyppiä.

    Screen-kuva kontekstimuuttujasta aiheessa Copilot Studio.

  11. Tallenna ja julkaise muutokset.

Huomautus

Muuttujaa Activity.From.Name voi käyttää vain keskustelun aloittamisen ohjeaiheessa. On suositeltavaa luoda yleinen muuttuja Keskustelun aloitus -aiheessa, määrittää muuttujan arvoksi Activity.From.Name ja käyttää sitten yleistä muuttujaa muissa aiheissa. Näin voit käyttää asiakkaan puhelinnumeroa missä tahansa Copilot Studio -agentin aiheessa.

Keskustelun aikana yhteyskeskuksen kontekstimuuttujan tiedot määritetään Copilot Studio -muuttujiin, ja niitä voidaan käyttää agentin logiikassa.

Asiakaspalvelija voi määrittää myös monikanavan kontekstimuuttujia keskustelun aikana. Jos haluat määrittää monikanavamuuttujan Copilot Studio -logiikasta, varmista, että agentti käyttää oikeaa muuttujan nimeä, ja määritä muuttujanhallintasolmusi To-arvo-ominaisuuden arvo. Copilot Studio poistaa muuttujan monikanavan käytöstä, kun se siirretään asiakaspalveluedustajalle. Tätä käytetään usein keskustelun linkittämiseen palvelupyyntöön, kun agentti eskaloi keskustelun palveluedustajalle. Lisätietoja monikanavan näihin tietoihin perustuvien tietueiden linkittämisestä: Asiakkaan ja palvelupyynnön linkittäminen keskusteluun

Copilot Studiossa luodut yleiset muuttujat voidaan välittää Dynamics 365 Contact Center, kun keskustelu eskaloituu. Täydellinen luettelo on ohjeaiheessa Käytettävissä olevat tilannekohtaiset muuttujat luovutuksen yhteydessä.

Jäsennä JSON-objekti tietuetunnuksen hakemiseksi

Varmista, että sinulla on seuraavat tiedot:

  • Dynamics 365 Contact Center kontekstimuuttuja, kuten msdyn_contact_msdyn_ocliveworkitem_Customer.
  • Rakenteen tiedot.

Mallirakenteen tietojen kopio on seuraavanlainen:

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

PrimaryDisplayValue sisältää määritteen arvon Dataverse-entiteeteissä. Entiteettimääritteiden yhdistämismääritys on seuraava:

  • Palvelupyynnöt: Palvelupyynnön otsikko
  • Yhteyshenkilöt: Koko nimi
  • Asiakkaat: Nimi

Esimerkkikontekstitietue.

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

Azure agenttien kontekstimuuttujat

Seuraava taulukko sisältää luettelon Dynamics 365 Contact Center kontekstimuuttujista, joita voit käyttää määrittämässä Azure agentteja.

Kontekstimuuttujan tyyppi Kontekstimuuttujan nimi Description Kuinka tehdä kartoitus Azuren avulla
Keskustelua edeltävä kysely Käytä keskustelua edeltävän kyselyn kysymyksen nimeä, jonka luot Dynamics 365 Contact Center. Järjestelmä tallentaa keskustelua edeltävän kyselyn vastaukset kontekstimuuttujina. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center kysymyksen nimen Azure muuttujatyyppiin:
  • Yksi rivi: merkkijono
  • Useita rivejä: merkkijono
  • Asetusjoukko: merkkijono
  • Käyttäjän suostumus: totuusarvo
Mukautettu konteksti Käytä muuttujan nimeä, jonka luot Dynamics 365 Contact Center tai välitettä käyttämällä setContextProvider-ohjelmointirajapintaa. Luomasi mukautetut kontekstimuuttujat voidaan välittää live-keskustelun SDK:n kautta. Kartasta käyttäjän vastaus JSON mukautetun kontekstimuuttujan käyttämiseksi Dynamics 365 Contact Center.
Mukautettu konteksti Direct Linelle Käytä muuttujan nimeä, jonka luot Dynamics 365 Contact Center Luomasi mukautetut kontekstimuuttujat voidaan välittää avain-arvo-pareina Activity.ChannelData.ConversationContext-kohteessa, kun DirectLine-asiakasohjelma aloittaa keskustelun. Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Center mukautetun kontekstimuuttujan Copilot Studion muuttujatyypillä:
  • Merkkijono: käyttäjän koko vastaus
  • Boolean: Boolean
  • Numero, Liukuluku: numero
Keskustelu msdyn_ConversationId Käytä kontekstimuuttujaa, joka sisältää keskustelun tunnuksen meneillään olevaa keskustelua varten, ja voit noutaa ja suorittaa toimintoja tietueelle Microsoft Dataverse. Merkkijono: merkkijono
Yhteyshenkilö msdyn_contact_msdyn_ocliveworkitem_Customer Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn asiakkaan (yhteyshenkilön) tietueen tunnuksen. Jäsennä JSON tietueen tunnuksen poimimista varten
Tili msdyn_account_msdyn_ocliveworkitem_Customer Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn asiakastietueen tunnuksen. Jäsennä JSON tietueen tunnuksen poimimista varten
Palvelupyyntö msdyn_incident_msdyn_ocliveworkitem Käytä tätä kontekstimuuttujaa, joka sisältää keskusteluun linkitetyn palvelupyyntötietueen tunnuksen. Jäsennä JSON tietueen tunnuksen poimimista varten
Kanavainstanssi msdyn_ChannelInstanceId Channel Instance -tietueen Dataverse-yksilöivä tunniste – esimerkiksi määritetyn chat-pienoissovelluksen yksilöivä tunnus tai Facebook-sivu Merkkijono: käyttäjän koko vastaus.
Työvaihe msdyn_WorkstreamId Kanavaesiintymään liittyvän työvirran Dataverse-yksilöllinen tunnus. Merkkijono: käyttäjän koko vastaus.
Kanavan aluekohtaiset asetukset msdyn_Locale Kanavaesiintymän määritetty kieliasetuskoodi. Esimerkiksi keskustelupienoissovellus tai Facebook-sivu. Tätä voidaan käyttää esimerkiksi monikielisten Copilot Studio -agenttien kanssa. Merkkijono: käyttäjän koko vastaus.
Yhteisöpalveluprofiili msdyn_SocialProfileId Keskusteluun liittyvän yhteisöpalveluprofiilin Dataverse-tietueen yksilöllinen tunnus. Merkkijono: käyttäjän koko vastaus.
Riviasiakkaan nimi msdyn_LineCustomerName Asiakkaan nimi LINE-ohjelmointirajapinnasta. Merkkijono: käyttäjän koko vastaus.
Teams-asiakkaan nimi msdyn_TeamsCustomerName Asiakkaan nimi kohteesta Microsoft Teams. Merkkijono: käyttäjän koko vastaus.
Teams-asiakkaan sähköposti msdyn_TeamsCustomerEmail Microsoft Teams sähköpostiosoite (UPN). Merkkijono: käyttäjän koko vastaus.
Applen ominaisuusluettelo msdyn_CapabilityList Apple Messages for Businesses -ominaisuusluetteloarvot eroteltuna merkkijonona. Merkkijono: käyttäjän koko vastaus.
Apple Group ID msdyn_AppleMessagesForBusinessGroupId Apple-viestit yrityksille -ryhmän tunnus. Merkkijono: käyttäjän koko vastaus.
Apple Intent ID msdyn_AppleMessagesForBusinessIntentId Apple Viestit yrityksille Intent-tunnus. Merkkijono: käyttäjän koko vastaus.
Applen aluekohtaiset asetukset msdyn_AppleMessagesForBusinessLocale Aluekohtaiset asetukset, jotka on antanut Apple Messages for Businesses -ohjelmointirajapinta. Merkkijono: käyttäjän koko vastaus.
Apple Business ID msdyn_AppleBusinessId Y-tunnus Apple Messages for Business -tililtäsi. Merkkijono: käyttäjän koko vastaus.
Facebook-asiakkaan nimi msdyn_FacebookCustomerName Asiakkaan nimi Facebookista. Merkkijono: käyttäjän koko vastaus.
Facebook-asiakkaan kieliasetus msdyn_FacebookLocale Asiakkaan aluekohtaiset asetukset Facebookista. Merkkijono: käyttäjän koko vastaus.
Facebook-asiakkaan aikavyöhyke msdyn_FacebookTimezone Asiakkaan aikavyöhyke Facebookista. Merkkijono: käyttäjän koko vastaus.
Facebook-asiakassivun suodatettu tunnus msdyn_FacebookUserPageScopedId Asiakkaan sivukohtainen käyttäjätunnus Facebookista. Merkkijono: käyttäjän koko vastaus.
Facebook-sivun tunnus msdyn_FacebookPageId PageID Facebook-sivultasi. Merkkijono: käyttäjän koko vastaus.
Asiakkaan puhelinnumero msdyn_AsiakasPuhelinnumero Puhelinnumero, jossa asiakas soittaa WhatsApp- ja SMS-kanavilla. Merkkijono: käyttäjän koko vastaus.
Organisaation puhelinnumero msdyn_OrganisaationPuhelinnumero Tämä on puhelinnumero, joka vastaanottaa viestejä asiakkaalta (organisaatiosi numero). Huomaa, että tätä ei välitetä WhatsAppissa Azure Communication Services Merkkijono: käyttäjän koko vastaus.
WhatsApp Universal -linkkiviesti msdyn_WhatsAppCustomerFirstMessage Jos käytät esitäytettyä sanomaa WhatsAppin yleislinkissä, nämä tiedot välitetään tähän muuttujaan. Merkkijono: käyttäjän koko vastaus.

Huomautus

Käytä kontekstimuuttujien nimiä sellaisina kuin ne on määritetty, äläkä muuta niitä, kun luot työnkulkuja Azure tai Copilot Studio -agenteissa. Varmista, että kontekstimuuttujaan välitettävässä arvossa on käytössä tarkka vastaavuus, koska arvon kirjainkoolla on merkitystä. Jos ilmenee ristiriita, tietuetta ei tunnisteta automaattisesti. Lisätietoja: Tietueiden tunnistaminen automaattisesti

Integroi Copilot Studio -agentti
Sigraa Azure agentti
Agenttien määrittäminen eskaloimaan ja lopettamaan keskustelut
Reaaliaikaisen keskustelun SDK-viite