MCP-palvelintyökalujen viite Customer Insights - Data

Yksi MCP-palvelin palvelee sekä Customer Insights - Data että Customer Insights - Journeys, joten agentti kummassakin sovelluksessa voi soittaa mihin tahansa tässä listatuista työkaluista.

Customer Insights Model Context Protocol (MCP) -palvelin tarjoaa Dynamics 365 Customer Insights - Data and Customer Insights - Journeys -ominaisuudet kutsuttavina työkaluina tekoälyagenteille ja suurten kielimallien (LLM) asiakkaille.

Molemmille sovelluksille on yksi MCP-palvelin. Sen sijaan, että kutsuttaisiin sisäisiä API-rajapintoja suoraan, agenttisi työskentelevät yhden turvallisen käyttöliittymän kautta, joka soveltaa samoja sääntöjä kuin Customer Insights muissa paikoissa, mukaan lukien suostumussäännöt, joita sovelletaan matkan suorittamisen aikana.

MCP:n kautta agentti voi:

• Tutustu Customer Insightsiin syötettäviin tietolähteisiin
• Ratkaise tietue lähdejärjestelmästä yhtenäiseen asiakasprofiiliin
• Hae profiilin attribuutit, segmentit, mittarit, ennusteet ja klusterijäsenyys
• Tarkista suostumus ja luo sääntöjen mukaiset peruutuslinkit ennen viestin lähettämistä
• Luo matkoja ja vahvista sähköpostisisältö

Työkalut yhdellä silmäyksellä

create_journey on ainoa työkalu, joka kirjoittaa dataa. Se ei ole vain luku -ominaisuus, tuhoava tai idempotentti, joten kahdesti soittaminen luo kaksi matkaa. Kaikki muut työkalut lukevat vain.

Miten työkalut sopivat yhteen

Useimmat työnkulut noudattavat kaksivaiheista kaavaa: ratkaistaan yhtenäinen asiakastunnus ja käytetään sitä asiakastietojen hakemaan.

Vaihe 1: Ratkaise yhtenäinen asiakastunnus

Valitse työkalu, joka vastaa sitä, mitä jo tiedät asiakkaasta:

• find_customer kun sinulla on henkilön nimi
• get_customer_by_contact kun sinulla on Dataverse, ota yhteyttä GUID:iin
• get_customer_by_source_id kun sinulla on tietue-ID syötetystä lähdejärjestelmästä, kuten lojaalisuus- tai ERP-järjestelmästä

Jos et tiedä, mitkä lähdeyksiköiden nimet ovat päteviä, soita list_data_sources ensin.

Vaihe 2: Hae asiakastiedot

Kun olet ratkaissut ID:n, soita johonkin näistä työkaluista:

• get_customer_details Täydellisen profiilin ja tietojen alkuperän osalta
• get_customer_segments segmenttijäsenyyksille
• get_customer_measures KPI- ja mittausarvoille
• get_customer_predictions tekoälyn ja koneoppimisen pisteille
• get_cluster_information klusterijäsenyys

Asiakasprofiilityökalut

Nämä työkalut lukevat Dataverse-virtuaalientiteeteistä, jotka heijastavat reaaliaikaista yhtenäistä asiakasdataa.

Löydä asiakas

find_customer

Etsii yhtenäisiä asiakasprofiileja etu- tai sukunimen perusteella ja palauttaa vastaavat asiakastunnukset, nimet ja sähköpostiosoitteet. Käytä tätä työkalua ensin, kun käyttäjä antaa henkilön nimen, mutta ei hänen yhtenäistä asiakastunnustaan.

• Käyttäytyminen: Jos et anna nimeä, työkalu listaa profiilit haun sijaan.
• Sivutus: Käytä top sivun koon hallintaan. Vastaus sisältää hasMore sen, että voit nähdä, onko olemassa muita tuloksia nykyisen sivun ulkopuolella.

Ratkaise asiakas lähteen perusteella

get_customer_by_source_id

Ratkaisee yhtenäisen asiakastunnuksen tietueen tunnisteesta syötetyssä lähdejärjestelmässä. Käytä sitä, kun sinulla on tunniste jostain lähteestä, kuten kanta-asiakas- tai ERP-järjestelmästä, ja tarvitset vastaavan Customer Insights -profiilin.

Kutsu list_data_sources ensin löytääksesi kelvolliset lähdeentiteetin nimet, kuten contact, lead, tai mukautettu taulu.

Ratkaise asiakas yhteydenotolla

get_customer_by_contact

Ratkaisee yhtenäisen asiakastunnuksen Dataverse-yhteystietokäyttöliittymästä. Käytä sitä, kun työnkulku alkaa kontaktitietueella ja tarvitsee siihen liittyvän Customer Insights -profiilin.

Tämä työkalu on pikakuvake, get_customer_by_source_id jossa lähdeentiteetti on asetettu arvoon contact.

Hanki asiakastiedot

get_customer_details

Palauttaa täydellisen Customer 360 -näkymän yhdelle yhtenäiselle asiakkaalle. Tuloksena ovat:

• Ydinprofiilin attribuutit, kuten nimi, sähköposti ja osoite, ilman järjestelmäsarakkeita
• Segmenttijäsenyydet
• Asiakasmittarit
• Klusterit
• Ennusteet
• Lähdetiedot , jotka osoittavat datan yhtenäisyyden alkuperän

Jokainen lähdetietue sisältää lähdeyksikön ei-järjestelmälliset attribuutit, sen, miten nämä ominaisuudet vastaavat yhtenäisiä profiiliattribuutteja, sekä lipun, joka tunnistaa, mikä lähde antoi voittoarvon kullekin yhtenäiselle kentälle.

Käytä tätä työkalua, kun olet ratkaissut asiakastunnuksen ja haluat koko kuvan yhdellä puhelulla.

Hanki asiakassegmenttejä

get_customer_segments

Listaa segmentit tai yleisöt, joihin yhtenäinen asiakas kuuluu. Jokainen tulos sisältää segmentin nimen, näyttönimen ja segmentin tunnuksen.

Hanki asiakasmittarit

get_customer_measures

Palautukset laskivat asiakasmittarit ja KPI:t, kuten elinikäisen arvon, tilausmäärät ja sitoutumispisteet. Työkalu yhdistää Customer Insights -dataasetteluun tallennetut mittarit yhdeksi tulokseksi.

Käytä sitä hakemaan koottuja arvoja, kuten kokonaisostoja, keskimääräistä tilausarvoa tai räätälöityjä liiketoimintamittareita.

Hanki asiakasennusteita

get_customer_predictions

Palauttaa koneoppimisen ennusteet yhtenäiselle asiakkaalle, kuten churn-todennäköisyys, ennustettu elinkaaren arvo, todennäköisyyspisteet ja seuraavaksi parhaan tuotteen ehdotukset. Jokainen tulos sisältää mallin ja palveluntarjoajan, josta se on peräisin.

Hanki klusteritiedot

get_cluster_information

Palauttaa klusterit, joihin asiakas kuuluu, sekä kunkin klusterin muut jäsenet ja heidän affiniteettipisteensä. Klusterityyppejä löydetään dynaamisesti Customer Insights -mallin metatiedoista.

Klusteri on yhdistämisen jälkeinen sääntö, joka ryhmittelee yhtenäiset profiilit, jotka täyttävät joukon ehtoja. Esimerkiksi kotitalous on yhteinen ryhmä ihmisiä, joilla on sama sukunimi ja osoite.

Listaa tietolähteet

list_data_sources

Listaa Customer Insightsiin syötetyt tietolähteet. Jokaiselle lähteelle työkalu raportoi lähdeentiteetin, tietueiden määrän ja näkyvätkö kyseisen lähteen sarakkeet yhtenäisessä profiilissa. Se myös merkitsee lähteitä, joiden kentät eivät ratkenneet, profiilisarakkeiksi, mikä on hyödyllistä yhdistämisen vianetsinnässä.

Syötettä ei tarvita. Käytä tätä työkalua löytääksesi kelvolliset lähde-entiteetin nimet ennen kuin kutsut get_customer_by_source_id.

Suostumus- ja vaatimustenmukaisuustyökalut

Nämä työkalut delegoivat saman backend-suostumuspalvelun kuin Customer Insights - Journeys matkan toteutuksen aikana, joten agentin päätös vastaa aina sitä, mitä matka tekisi. Suostumuspalvelu voi toimia itsenäisesti täydellisestä Customer Insights -asennuksesta, joten nämä työkalut ovat käytettävissä myös ympäristöissä, joissa käytössä on vain Dynamics 365 Sales tai Contact Center.

Tarkista suostumus

check_consent

Tarkistaa yhteydenottopisteen, viestintäkanavan, tarkoituksen ja aiheen suostumustilan. Soita siihen ennen kuin suosittelet tai lähetät viestin, jotta varmistat, että vastaanottaja on oikeutettu. Työkalu käynnistää msdynmkt_checkconsent Dataverse-mukautetun API:n ja palauttaa suostumuspalvelun päätöksen, mukaan lukien syyn, miksi viesti estetään.

Tyypillinen käyttötapaus

Välittäjä, joka valmistautuu lähettämään kaupallisen viestin, soittaa check_consent varmistaakseen, että vastaanottaja on valinnut kyseisen tarkoituksen ja kanavan.

Esimerkki

Tarkista yhteyspisteen +111111111, yhteensopivuusprofiilin 7f4a6355-1811-4cde-bde3-fee8c85f56b1, tarkoituksen Commercial (10000000-0000-0000-0000-000000000003), kanavatyypin SMS, liiketoimintayksikön c507f51d-8f0c-ee11-8f6e-6045bd6ef763ja aiheen Commercial Topic 001 (23db4a4d-ba9f-f011-bbd3-6045bd194648) suostumus.

Tulos:

Yhteydenottopisteellä on vakiintunut suostumus, joka vaaditaan sekä kaupalliseen tarkoitukseen että kaupalliseen aiheeseen 001 , joten tekstiviestien lähettäminen tälle yhteyspisteelle on sallittua nykyisten vaatimustenmukaisuusasetusten puitteissa.

Hanki tilauksen peruutuslinkki

get_unsubscribe_link

Luo yhteensopivan peruutuslinkin vastaanottajalle ja viestin kontekstille. Pyyntö tunnistaa vastaanottajan toimijan, tarkoituksen, vaatimustenmukaisuusasetukset, viestipohjan ja yhteydenottopisteen. Työkalu käynnistää msdynmkt_getunsubscribelink Dataverse-mukautetun API:n.

Jokainen linkki on yksilöllinen yhteyspisteen ja viestin kontekstin mukaan, joten saat täyden jäljitettävyyden ja auditoitavuuden.

Kun vastaanottaja valitsee linkin, se avaa mieltymyskeskuksen sivun, joka liittyy vaatimustenmukaisuusprofiiliin. Preferenssikeskus antaa vastaanottajille mahdollisuuden hallita viestintämieltymyksiään, esimerkiksi kieltäytyä tietyistä tarkoituksista tai aiheista, päivittää yhteyspisteitä tai peruuttaa tilauksen kaikesta. Se antaa asiakkaille todellisen kontrollin sen sijaan, että he voisivat käyttää kaikki tai ei mitään -kieltoa.

Voit mukauttaa asetuskeskuksen ulkoasua vastaamaan brändiäsi, mukaan lukien tekstin päivittäminen, tarkoitusten ja aiheiden lisääminen, sivun muotoilu mukautetulla CSS:llä ja mukautetun JavaScriptin lisääminen. Lue lisää Luo brändättyjä, räätälöityjä mieltymyskeskuksia.

Tyypillinen käyttötapaus

Tiedotusagentti luo viestin ja kutsuu get_unsubscribe_link upottamaan yhden klikkauksen opt-out-linkin viestin runkoon.

Esimerkki

Luo tilauksen peruutuslinkki yhteyspisteelle +111111111, entiteettityypille Contact (f56302b0-875e-f111-a826-7ced8d6d1623), viestimallille 226abb7d-855e-f111-a826-7ced8d6d1e7c, yhteensopivuusprofiilille 7f4a6355-1811-4cde-bde3-fee8c85f56b1, tarkoituksella 10000000-0000-0000-0000-000000000003, aiheelle 23db4a4d-ba9f-f011-bbd3-6045bd194648ja liiketoimintayksikölle c507f51d-8f0c-ee11-8f6e-6045bd6ef763.

Tulos:

Luotu peruutetun tilauksen linkki:

https://public-fra.mkt.dynamics.com/api/v2.0/orgs/7b2fdebc-d216-ee11-a66d-0022483903fc/consent/preferences?contextId=fd436906-0633-42a9-8426-c3a6edca0100

Matka- ja sähköpostityökalut

Luo matka

create_journey

Validoi koko matkan JSON-kuorman, rikastaa sitä, validoi rikastetun hyötykuorman uudelleen ja luo sitten Customer Insights - Journeys -matkatietueen. Vastaus sisältää luodun matkatunnuksen ja validointituloksen.

Vahvista sähköposti

validate_email

Vahvistaa olemassa olevan Customer Insights - Journeys -sähköpostin muokkaamatta sitä. Pyyntö sisältää sähköpostiviestin tunnuksen, sisältöosat, paikkamerkit ja validointikontekstin. Vastaus sisältää viestitason ja paikkamerkkitason validointihavainnot.

Käytä sitä havaitsemaan sisältöongelmia, kuten ratkaisemattomia paikkamerkkejä, ennen kuin matka lähettää viestin.

Esimerkkityönkulkuja

Etsi asiakas nimeltä ja saat hänen koko profiilinsa

1. Soita find_customerja valitse vastaava asiakas ja merkitse heidän yhtenäinen henkilötunnuksensa.
2. Soita get_customer_details saadaksesi profiilin, segmentit, mittarit ja lähteen alkuperän.

Rikastuta tunnettu Dataverse-yhteyshenkilö

1. Soita get_customer_by_contact ja ratkaise yhteystiedot yhtenäiseksi asiakastunnukseksi.
2. Soita get_customer_predictions ja get_cluster_information pyydä churn-pisteet, asiakasarvot ja klusterijäsenyys.

Ratkaise tietue toisesta lähdejärjestelmästä

1. Soita list_data_sources löytääksesi kelvollisen lähdeyksikön nimen.
2. Soita get_customer_by_source_id ja ratkaise lähdetietue yhtenäiseksi asiakastunnukseksi.
3. Soita get_customer_segments tai get_customer_measures saadaksesi segmentti- ja KPI-kontekstia.

Lähetä vaatimustenmukainen viesti

1. Ratkaise asiakas yhdellä ratkaisutyökaluista.
2. Soita check_consent varmistaaksesi, että yhteystieto on valittu siihen tarkoitukseen, aiheeseen, kanavaan ja yhteydenottopisteeseen, jota aiot käyttää.
3. Kutsu get_unsubscribe_link , jotta saat mukautetun suostumuksen sisältävän linkin.
4. Laadi ja lähetä viesti, jossa linkki on upotettuna.

Rakenna ja tarkista matka

1. Soita create_journey matkakuorman kanssa.
2. Soita validate_email matkan käyttämiin sähköposteihin varmistaaksesi, että sisältö ratkeaa oikein.

Näin se toimii

Customer Insights -MCP-palvelin perustuu Dataversen mukautettuun ohjelmointirajapintamalliin. Se käyttää työkalujen käsittelemiseen kahta mukautettua ohjelmointirajapintaa:

• Lista työkalut: Luettelee kaikki palvelimelle rekisteröidyt MCP-työkalut.
• Kutsutyökalu: Ajaa tietyn MCP-työkalun nimeltä, välittäen argumentit JSON-muodossa.

Palvelinmääritelmä sijaitsee perusratkaisussa (CxpClient), joka toimitetaan jokaiseen Dynamics 365 -organisaatioon. Customer Insights - Data ja Customer Insights - Journeys -työkalujen tarjoajat on lisätty ratkaisulaajennuksiksi.

Arkkitehtuurin yleiskatsaus

Palvelin noudattaa kerrostettua arkkitehtuuria:

1. Protokollakerros: Mukautetut ohjelmointirajapinnat ja Dataverse-laajennukset käsittelevät MCP-protokollan yhteensopivuutta.
2. Rekisterikerros: Löytää käytettävissä olevat työkalutoimittajat ajonaikaisesti reflektiopohjaisen automaattilöydön avulla.
3. Työkalutaso: MCP-rivittimet, jotka vahvistavat syötteitä ja delegoivat palveluihin.
4. Palvelukerros: Liiketoimintalogiikka, joka kutsuu taustalla olevia Customer Insights -palveluita.
5. Datakerros: Dataverse-virtuaalientiteetit ja Dataverse-tallennus.

Security

MCP-palvelin valvoo turvallisuutta useilla kerroksilla:

Edellytykset

Ennen kuin käytät työkaluja, varmista, että sinulla on:

• Dynamics 365 Customer Insights -ympäristö. Suostumustyökaluissa toimii myös Dynamics 365 -ympäristö, jossa on Shared Consent, esimerkiksi Dynamics 365 Sales with Shared Consent.
• Pääsy Dataverse-taulukoihin, jotka tukevat työkaluja, joita aiot kutsua.
• Suostumustyökaluissa vähintään yksi vaatimustenmukaisuusprofiili tarkoituksineen ja aiheineen. Oletusvaatimustenmukaisuusprofiili sisältää kaupallisen tarkoituksen rajoittavalla valvonnalla ja transaktiotarkoituksen ei-rajoittavalla valvonnalla, joten voit aloittaa heti ilman ylimääräisiä konfiguraatioita.
• Dataversen tietoturvarooli antaa työkalujen vaatimat oikeudet käyttäjän tai agentin identiteetille.

Rajoitukset

Pidä seuraavat rajoitukset mielessä:

• Suostumustyökalut kattavat suostumuksen tarkistukset ja tilauksen peruutuslinkin luomisen. Suostumuksen päivittäminen, hallinnolliset toiminnot kuten tarkoitusten ja aiheiden luominen tai poistaminen sekä suostumusmallin metatietojen hakeminen eivät ole MCP:n kautta paljastuneet.
• Suorituskyky: MCP:n kautta tehdyt puhelut voivat olla viiveempiä kuin suorat palvelukutsut matkan suorituksen aikana. Ota tämä huomioon, kun suunnittelet korkean läpimenon skenaarioita.
• Yksi MCP-palvelin: Yksi palvelin kattaa sekä Customer Insights - Journeys että Customer Insights - Data, ja kaikki työkalut jakavat saman palvelintason laajuusmääritelmän. Työkalutason valtuutus hallitsee yksittäisten työkalujen käyttöä.

Liittyvät tiedot

• Model Context Protocol -määrittely
• Lisää työkaluja ja resursseja MCP-palvelimelta agenttiisi
• Suostumuksen hallinnan yleiskatsaus

Seuraavat vaiheet

• Käytä työkaluja Customer Insights MCP -palvelimessa
• Connect Customer Insights - Data Agent 365 Tooling Gatewayn kautta