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 erillisversioina
Huomautus
Copilot Studio -botti nimetään uudelleen Copilot-agenttiiksi (agentiksi tai tekoälyagentiksi). Ihmisagentti nimetään nyt uudelleen customer service edustajaksi (palveluedustajaksi tai edustajaksi). Saatat löytää viittauksia vanhoihin ja uusiin termeihin, kun päivitämme tuotteen käyttöliittymää, dokumentaatiota ja koulutussisältöä.
Tässä artikkelissa on luettelo Azure- ja Copilot-agenttien kontekstimuuttujista ja siitä, miten voit määrittää ne Dynamics 365 Contact Centerissä. Tietoja kontekstimuuttujien luomisesta on ohjeaiheessa Kontekstimuuttujien hallinta.
Copilot-agenttien kontekstimuuttujat
Seuraava taulukko sisältää luettelon Dynamics 365 Contact Centerissä käytettävissä olevista kontekstimuuttujista, joita voit käyttää Copilot-agenttien määrittämiseen.
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 | Kuvaus | Kuinka kartoittaa Copilot Studiossa |
|---|---|---|---|
| Keskustelua edeltävä kysely | Käytä keskustelua edeltävän kyselyn kysymyksen nimeä, jonka luot Dynamics 365:n yhteystietokeskuksessa. | Järjestelmä tallentaa keskustelua edeltävän kyselyn vastaukset kontekstimuuttujina. | Seuraavien tietojen avulla voit yhdistää kysymyksen nimen Dynamics 365 Contact Centerissä Copilot Studion muuttujatyyppiin:
|
| Mukautettu konteksti keskustelulle | Käytä Dynamics 365 Contact Centerissä tai välitystoiminnossa luomaasi muuttujan nimeä setContextProvider -ohjelmointirajapinnalla. | Luomasi mukautetut kontekstimuuttujat voidaan välittää live-keskustelun SDK:n kautta. | Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Centerin mukautetun kontekstimuuttujan Copilot Studion muuttujatyyppiin:
|
| Direct Linen mukautettu konteksti | Käytä Dynamics 365 Contact Centerissä luomaasi muuttujan nimeä. | 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 Centerin mukautetun kontekstimuuttujan Copilot Studion muuttujatyyppiin:
|
| 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 Centerin mukautetun kontekstimuuttujan Copilot Studion muuttujatyyppiin:
|
| Keskustelu | msdyn_ConversationId | Käytä kontekstimuuttujaa, joka sisältää käynnissä olevan keskustelun tunnuksen ja joka voi noutaa ja suorittaa toimintoja Microsoft Dataversen tietueelle. | 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ää skenaarioissa, kuten monikieliset Copilot Studio -agentit. | Merkkijono: käyttäjän koko vastaus. | |
| msdyn_SocialProfileId | Keskusteluun liittyvän yhteisöpalveluprofiilin Dataverse-tietueen yksilöllinen tunniste. | Merkkijono: käyttäjän koko vastaus. | |
| msdyn_LineCustomerName | Asiakkaan nimi LINE-ohjelmointirajapinnasta. | Merkkijono: käyttäjän koko vastaus. | |
| msdyn_TeamsCustomerName | Asiakkaan nimi Microsoft Teamsista. | Merkkijono: käyttäjän koko vastaus. | |
| msdyn_TeamsCustomerEmail | Sähköpostiosoite (UPN) Microsoft Teamsista. | 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 Servicesin 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 Studiosta. |
| 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 Studiosta. | |
| 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 Muita äänen kontekstimuuttujia voi hankkia Copilot Studiosta. Lisätietoja on kohdassa Muuttujien käsitteleminen.
Copilot-agentin kontekstimuuttujien määrittäminen
Jos haluat Copilot-agentin lukevan kontekstimuuttujia Dynamics 365 Contact Centeristä, 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 muuttujan arvon tästä solmusta suorituksen aikana.
Valitse Käyttö-osiossaYleinen (mikä tahansa aihe voi käyttää) ja Ulkoiset lähteet voivat määrittää arvoja niin, että Copilot Studio -agentti hyväksyy tietoja monikanavasta 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 contact center -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 Centeriin, 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>"
}
Kontekstimuuttujat Azure-agenteille
Seuraavassa taulukossa on luettelo Dynamics 365 Contact Centerin kontekstimuuttujista, joita voit käyttää Azure-agenttien määrittämiseen.
| Kontekstimuuttujan tyyppi | Kontekstimuuttujan nimi | Kuvaus | Kuinka tehdä kartoitus Azuren avulla |
|---|---|---|---|
| Keskustelua edeltävä kysely | Käytä keskustelua edeltävän kyselyn kysymyksen nimeä, jonka luot Dynamics 365:n yhteystietokeskuksessa. | Järjestelmä tallentaa keskustelua edeltävän kyselyn vastaukset kontekstimuuttujina. | Seuraavien tietojen avulla voit yhdistää Dynamics 365 Contact Centerissä kysymyksen nimen Azuren muuttujatyyppiin:
|
| Mukautettu konteksti | Käytä Dynamics 365 Contact Centerissä tai välitystoiminnossa luomaasi muuttujan nimeä setContextProvider -ohjelmointirajapinnalla. | Luomasi mukautetut kontekstimuuttujat voidaan välittää live-keskustelun SDK:n kautta. | Liitä käyttäjän vastaus JSON-muotoon mukautetun kontekstimuuttujan käyttämiseksi Dynamics 365 Contact Centerissä. |
| Direct Linen mukautettu konteksti | Dynamics 365 Contact Centerissä luomasi muuttujan nimen käyttäminen | 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 Centerin mukautetun kontekstimuuttujan Copilot Studion muuttujatyyppiin:
|
| Keskustelu | msdyn_ConversationId | Käytä kontekstimuuttujaa, joka sisältää käynnissä olevan keskustelun tunnuksen ja joka voi noutaa ja suorittaa toimintoja Microsoft Dataversen tietueelle. | Merkkijono: merkkijono |
| Kontakti | 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 |
| Laatikko | 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ää skenaarioissa, kuten monikieliset Copilot Studio -agentit. | Merkkijono: käyttäjän koko vastaus. |
| Yhteisöpalveluprofiili | msdyn_SocialProfileId | Keskusteluun liittyvän yhteisöpalveluprofiilin Dataverse-tietueen yksilöllinen tunniste. | 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 Microsoft Teamsista. | Merkkijono: käyttäjän koko vastaus. |
| Teams-asiakkaan sähköposti | msdyn_TeamsCustomerEmail | Sähköpostiosoite (UPN) Microsoft Teamsista. | 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ä WhatsAppille Azure Communication Servicesin kautta | 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
Copilot Studio -agentin integrointi
Azure-agentin integroiminen
Agenttien määrittäminen eskaloimaan ja lopettamaan keskustelut
Reaaliaikaisen keskustelun SDK-viite