Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
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:
|
| 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ä:
|
| 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ä:
|
| 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ä:
|
| 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:
Valitse Aiheet-sivullaLisää aihe>tyhjästä. Käytä aihetta, jota ei ole käynnistetty tai joka on jo olemassa, koska muuten kontekstimuuttuja ei toimi.
Anna aiheelle nimi, kuten Määritä kontekstimuuttujat, ja tallenna se.
Lisää uusi solmu aiheeseen ja valitse Muuttujan hallinta > Määritä muuttujan arvo.
Valitse Luo uusi muuttuja uuden solmusi kohdassa Määritä muuttuja.
Avaa Muuttujan ominaisuudet -ruutu valitsemalla uusi muuttujan nimi. Määritä ruudussa Muuttujan nimi vastaamaan kokokanavan kontekstimuuttujan nimeä tarkasti (kirjainkoko on merkitsevä).
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.
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.
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ä.
Sulje Muuttujan ominaisuudet -ruutu.
Kirjoita solmussasi kenttään To value arvo, joka vastaa agenttisi odottamaa tietotyyppiä.
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:
|
| 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ä:
|
| 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
Liittyvät tiedot
Integroi Copilot Studio -agentti
Sigraa Azure agentti
Agenttien määrittäminen eskaloimaan ja lopettamaan keskustelut
Reaaliaikaisen keskustelun SDK-viite