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ä

Työkalu Näyttönimi Toiminnot Vain luku
find_customer Löydä asiakas Hae yhtenäisiä asiakasprofiileja etu- tai sukunimen perusteella Yes
get_customer_by_source_id Ratkaise asiakas lähteen perusteella Ratkaisee yhtenäisen asiakas-ID:n lähdejärjestelmätietueen ID:stä Yes
get_customer_by_contact Ratkaise asiakas yhteydenotolla Ratkaisee yhtenäisen asiakas-ID:n Dataverse-kontaktikäyttöliittymästä Yes
get_customer_details Hanki asiakastiedot Palauttaa koko Customer 360 -näkymän yhdelle asiakkaalle Yes
get_customer_segments Hanki asiakassegmenttejä Listaa segmentit, joihin asiakas kuuluu Yes
get_customer_measures Hanki asiakasmittarit Lasketut mittarit ja KPI:t Yes
get_customer_predictions Hanki asiakasennusteita Palauttaa koneoppimisen ennusteita, kuten churn-todennäköisyyttä Yes
get_cluster_information Hanki klusteritiedot Palauttaa klusterijäsenyyden, kuten kotitalouden, ja muut jäsenet Yes
list_data_sources Listaa tietolähteet Luettelo vastaanotetut tietolähteet ja niiden tietuemäärät Yes
check_consent Tarkista suostumus Tarkistaa suostumuksen yhteydenottopisteelle, kanavalle, tarkoitukselle ja aiheelle Yes
get_unsubscribe_link Hanki tilauksen peruutuslinkki Luo vastaanottajalle yhteensopivan peruutuslinkin Yes
create_journey Luo matka Vahvistaa, rikastuttaa ja luo matkan Ei
validate_email Vahvista sähköposti Vahvistaa olemassa olevan sähköpostin muuttamatta sitä Yes

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.

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.

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:

Parametri Arvo
Yhteyspiste +111111111
Kanavatyyppi tekstiviesti
Yhteensopivuusprofiilin tunnus 7f4a6355-1811-4cde-bde3-fee8c85f56b1
Tarkoitus Kaupallinen (tunnus: 10000000-0000-0000-0000-00000000003)
Aihe Kaupallinen aihe 001 (tunnus: 23db4a4d-ba9f-f011-bbd3-6045bd194648)
Liiketoimintayksikkö c507f51d-8f0c-ee11-8f6e-6045bd6ef763
Suostumus ✅ Myönnetty

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.

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:

Parametri Arvo
Yhteyspiste +111111111
Yksikkötyyppi Ota yhteyttä
Entiteetin tunnus f56302b0-875e-f111-a826-7ced8d6d1623
Viestimallin tunnus 226abb7d-855e-f111-a826-7ced8d6d1e7c
Yhteensopivuusprofiilin tunnus 7f4a6355-1811-4cde-bde3-fee8c85f56b1
Tarkoituksen tunnus 10000000-0000-0000-0000-000000000003
Aiheen tunnus 23db4a4d-ba9f-f011-bbd3-6045bd194648
Liiketoimintayksikön tunnus c507f51d-8f0c-ee11-8f6e-6045bd6ef763

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.

Important

create_journey on ainoa työkalu Customer Insights MCP -palvelimessa, joka luo dataa. Se ei ole idempotentti, joten epäonnistuneen kutsun uudelleenyrittäminen voi luoda kaksoismatkon. Pyydä agenttiasi varmistamaan lopputulos ennen kuin se jatkaa.

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:

Taso Description
Liikenteen suojaus (mTLS) Mutual Transport Layer Security -sertifikaattipohjainen tunnistautuminen asiakkaan ja Dataversen välillä
Mukautetut ohjelmointirajapinnan oikeudet Alusta vahvistaa käyttäjäoikeudet ennen kuin se sallii työkalujen löytämisen tai suorituksen
Työkalutason valtuutus Jokainen työkalu tarkistaa toimijakohtaiset oikeudet, kuten lukuoikeuden suostumustarkoituksiin
Tietotason suojaus Rivitason turvallisuus varmistaa, että käyttäjät pääsevät vain niihin tietoihin, joita heillä on lupa nähdä

Huomautus

Valtuutus pakotetaan käyttöön työkalulogiikan sisällä soittajan käyttäjäkontekstin avulla. MCP-palvelin ei koskaan nosta oikeuksia implisiittisesti. Työkalut toimivat julkisivuina eivätkä koskaan tee mitään muuta kuin mitä soittava käyttäjä saa tehdä.

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öä.

Seuraavat vaiheet

  • Viimeksi päivitetty