Olet tässä:
CRM Analyticsin MCP Server Tool -viiteopas
Vain luku -työkalut, jotka sallivat MCP-yhteensopivien tekoälysovellusten löytää sovelluksia, tarkastaa skeemoja, suorittaa SAQL-kyselyitä ja lukea mittaristojen ja linssien metadataa.
Vaaditut versiot
| Käytettävissä Lightning Experiencessa. |
| Saatavilla CRM Analyticsissa lisämaksusta Enterprise Edition-, Performance Edition- ja Unlimited Edition -versioissa. |
Kun olet muodostanut yhteyden, et kutsu näitä työkaluja itse. Kysy MCP-yhteensopivalta tekoälysovellukseltasi, kuten ChatGPT, Claude tai Cursor, kysymys luonnollisella kielellä. Asiakassovellus valitsee tehtävälle työkalut.
Kun kysyt esimerkiksi ”Mikä oli 10 tärkeintä tiliäsi tuoton mukaan viime tilivuodesta?”, tekoälysovellus tarkastaa datajoukon skeeman, luo Salesforce Analytics -kyselyn kielen (SAQL) ja palauttaa rakenteellisia tuloksia, joissa on execute_query.
Tavallinen kyselyiden työnkulku on list_datasets to get_dataset (capture currentVersionId) to get_xmd (exact field names) to execute_query.
Kuvaus / Syötteet -sarakkeen huomautukset vaativat parametrit. Muut parametrit ovat valinnaisia.
Organisaatio- ja Discovery-työkalut
Ulkoiset MCP-yhteensopivat tekoälyasiakkaat käyttävät näitä työkaluja löytääkseen kansioita (sovelluksia), jotka sisältävät mittaristoja, datajoukkoja ja linssejä, ja ladatakseen kansion koko metadatan.
| Työkalun nimi | Kuvaus / Syötteet | Palautukset | Käytä milloin |
|---|---|---|---|
list_folders |
Palauttaa kansiot (sovellukset), joita yhdistetty käyttäjä voi käyttää. Syötteet: |
Kansio-objektit, joilla on tunnus, otsikko, kuvaus, mallin lähde ja käyttöoikeudet. | Tarvitset kansioiden tunnuksia myöhempien luettelopuheluiden laajentamiseen tai haluat sovellusten inventaarion. |
get_folder |
Palauttaa yhden kansion (sovelluksen) koko metadatan. Input: |
Kansio-objekti, jossa on otsikko, kuvaus, mallin lähde ja käyttöoikeudet. | Tarvitset täydellisen metadatan tietylle sovellukselle. |
Datan ja skeeman työkalut
Ulkoiset MCP-yhteensopivat tekoälyasiakkaat käyttävät näitä työkaluja datajoukkojen luettelointiin ja kenttien nimien, datatyyppien ja otsikoiden noutamiseen, joita tarvitaan kelvollisen SAQL:n luomiseen.
| Työkalun nimi | Kuvaus / Syötteet | Palautukset | Käytä milloin |
|---|---|---|---|
list_datasets |
Palauttaa sovelluksessa tai organisaatiossa olevat datajoukot. Input: |
Datajoukkojen objektit, joiden nimiä, tyyppejä ja päivämääriä on viimeksi muokattu. | Tarvitset datajoukon nimet ja tunnukset ennen skeeman tarkastamista tai kyselyn suorittamista. |
get_dataset |
Palauttaa datajoukon koko metadatan, mukaan lukien tämänhetkisen version tiedot. Input: |
Datajoukon metadata, mukaan lukien kenttien nimet, datatyypit, ulottuvuuksien ja mittojen otsikot sekä tämänhetkisen version tunnus. | Tarvitset currentVersionId ennen kuin soitat get_xmd tai execute_query. |
get_xmd |
Palauttaa datajoukon version laajennetun metadatan (XMD), mukaan lukien tarkat kenttien API-nimet, datatyypit, otsikot ja muotoilu. Syötteet: |
Datajoukon version laajennettu metadata, mukaan lukien kenttien API-nimet, datatyypit, otsikot ja näyttömuotoilu. | Tarvitset tarkat kenttien API-nimet, jotta asiakassovellus voi laatia syntaktisesti oikean SAQL:n. |
Kysely- ja analysointityökalut
Ulkoiset MCP-yhteensopivat tekoälyasiakkaat käyttävät tätä työkalua suorittaakseen SAQL:n CRM Analytics -datajoukon perusteella ja palauttaakseen rakenteellisia tuloksia. Asiakassovellus luo SAQL:n luonnollisen kielen pyynnöstäsi.
| Työkalun nimi | Kuvaus / Syötteet | Palautukset | Käytä milloin |
|---|---|---|---|
execute_query |
Suorittaa SAQL-kyselyn CRM Analytics -datajoukolle. Input-arvot: |
Rakenteellisen JSON-kyselyn tulokset sisältävät rivejä, sarakkeiden metadataa ja kyselyn suorituksen lisätietoja. | Haluat datajoukosta ryhmitettyjä, suodatettuja tai lajiteltuja vastauksia. Älä käytä tätä työkalua metadatan tutkimiseen. |
Mittaristo-, visualisointi- ja tutkimistyökalut
Ulkoiset MCP-yhteensopivat tekoälyasiakkaat käyttävät näitä työkaluja löytääkseen mittaristoja ja tallennettuja tutkintoja (linssejä) sekä noutaakseen widget-, vaihe-, suodatin- ja kyselymääritelmiä.
| Työkalun nimi | Kuvaus / Syötteet | Palautukset | Käytä milloin |
|---|---|---|---|
list_dashboards |
Palauttaa CRM Analytics -mittaristot sovelluksessa tai organisaatiossa. Input-arvot: |
Mittaristojen objektit, joiden nimet, tunnukset, tyypit ja sovelluksen asiayhteydet. | Tarvitset mittaristojen tunnisteita tai haluat selata käyttövalmiita mittaristoja sovellukselle. |
get_dashboard |
Palauttaa yhden mittariston täyden metadatan, mukaan lukien widgetit, vaiheet ja suodattimet. Input: |
Täysi mittariston metadata, mukaan lukien widgetit, vaiheet, suodatinkokoonpanot ja asettelun lisätiedot. | Tarvitset tietyn mittariston täydellisen määritelmän. |
list_lenses |
Palauttaa tallennetut tutkinnat (linssit), joita yhdistetty käyttäjä voi käyttää. Syötetään: |
Linssiobjektit, joihin viittaavat nimet, tunnukset ja datajoukot. | Tarvitset tallennettujen tutkintojen ja niiden käyttämien datajoukkojen inventaarion. |
get_lens |
Palauttaa yhden linssin koko metadatan, mukaan lukien kyselyn määritelmän ja datajoukon viitteen. Input: |
Täysi linssin metadata, mukaan lukien kyselyn määritelmä, visualisointikokoonpano ja datajoukon viite. | Tarvitset tietyn linssin kyselyn ja visualisointitiedot. |
