Olet tässä:
CRM Analyticsin MCP-palvelimen vianmääritys ja vihjeitä
Ratkaise yhteys- ja käyttöoikeusongelmia ja käytä kehotteita ja käytäntöjä, jotka auttavat AI-asiakkaita kyselemään CRM Analytics -dataa tarkemmin.
Vaaditut versiot
| Käytettävissä Lightning Experiencessa. |
| Saatavilla CRM Analyticsissa lisämaksusta Enterprise Edition-, Performance Edition- ja Unlimited Edition -versioissa. |
Yleiset yhteysongelmat
- Palvelin yhteys epäonnistuu: Varmista, että CRM Analytics MCP -palvelin on käytössä Määritykset-valikon MCP-palvelimet-osiossa. Varmista myös, että loit ulkoisen asiakassovelluksen oikealla callback-URL-osoitteella. Vahvista sitten, että olet kirjautunut sisään sovelluksen sisältävään organisaatioon ennen kuin aloitit OAuth-kulun.
- Työkaluja ei näytetä: Varmista, että MCP-asiakassovelluksesi käyttää organisaatiotyypillesi oikeaa palvelimen URL-osoitetta ja että jokainen käyttäjä suoritti OAuth-todennuksen omilla Salesforce-tunnuksillaan. CRM Analytics MCP -palvelin ei tue palvelutilien valtuuksia.
- Tuotanto-organisaatio: CRM Analytics MCP -palvelin on käytettävissä tuotanto-organisaatioissa sekä sandbox- ja luonnosorganisaatioissa. Käytä organisaatiotyyppiäsi vastaavaa palvelimen URL-osoitetta:
- Tuotanto:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox- tai luonnosorganisaatio:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Tuotanto:
Tietojen ja työkalujen käyttöoikeudet
MCP-istuntosi suoritetaan sinulle. Koska todennus käyttää Salesforce-tunnuksiasi, kaikki pyynnöt noudattavat kenttätason suojausta (FLS), objektitason suojausta (OLS), rivitason suojausta (RLS) ja jakosääntöjä. AI-asiakassovellus ei voi koskaan nähdä dataa tai omaisuuksia, joita et näe CRM Analyticsissa.
- Datajoukot, mittaristot tai linssit puuttuvat: Jos asiakassovellus ilmoittaa, että omaisuus ei ole käytettävissä tai jos
list_palauttaa odotettua vähemmän kohteita, sinulla ei todennäköisesti ole kyseisen omaisuuden käyttöoikeutta. Varmista, että sinulla on sovelluksen tai omaisuuden käyttöoikeus ja että käyttöoikeusjoukkosi myöntää CRM Analytics -käyttöoikeuden. - API-rajoitukset: MCP-työkalukutsut lasketaan organisaatiosi Wave API -rajoituksiin. Tarkasta käyttö Määritykset-valikon API-käyttö -osiosta.
Lisätietoja on vianmääritysoppaassa.
Vihjeitä parempien tulosten aikaansaamiseksi
- Kirjoita tavoite, älä työkalu: Sano "Näytä minulle avoimet mahdollisuudet vaiheittain" eikä "kutsua list_datasets". AI-asiakassovellus valitsee työkalut.
- Paranna kyselyiden tarkkuutta kenttäkuvauksilla: Kenttien otsikoiden ja kuvausten lisääminen datajoukkosi laajennettuun metadataan (XMD) auttaa tekoälysovellusta luomaan tarkempia SAQL-kyselyitä.
- Monimutkaisten kyselyiden tarkentaminen: Sisäkkäiset ryhmitykset, usean datajoukon liitokset tai edistyneet SAQL-funktiot saattavat vaatia jatkokehotteita saadakseen tarkat tulokset.
Kehotteiden esimerkkejä
Käytä näitä kehotteita uudessa istunnossa löytääksesi omaisuuksia, tarkastaaksesi skeemaa ja esittääksesi kysymyksiä datastasi.
| Käyttäjän kehote | Työkalu kutsuttu | Käyttötarkoitus |
|---|---|---|
| Mitä Analytics-sovelluksia minulla on käyttöoikeus? | list_folders |
Palauttaa kansiot (sovellukset), jotka sisältävät mittaristosi, datajoukkosi ja linssisi. Käytä tuloksia laajentaaksesi myöhempiä hakuja. |
| Minkä CRM Analytics -datajoukkojen käyttöoikeus minulla on tällä hetkellä? | list_datasets |
Hakee suojauskontekstissasi käytettävissä olevat datajoukkojen nimet, otsikot ja tunnukset. |
| Näytä minulle kaikki Myyntisovellus-kansion mittaristot. | list_dashboards |
Löytää käyttövalmiit mittaristot tietylle sovellukselle tai liiketoimintayksikölle. |
| Näytä kaikki tallennetut tutkinnat, joita voin tarkastella. | list_lenses |
Kerää tallennettujen linssien ja niihin viittaavien datajoukkojen inventaarion. |
| Anna minulle Executive Pipeline -datajoukon koko metadata. | get_dataset |
Palauttaa datajoukon lisätiedot, mukaan lukien sen kyselemiseen tarvittavan version tunnuksen. |
| Mitkä ovat mahdollisuuksien datajoukon tarkat kentät, ulottuvuudet ja mitat? | get_xmd |
Tarjoaa kenttien API-nimet, datatyypit ja otsikot, jotta asiakassovellus voi laatia syntaktisesti oikean SAQL:n. |
| Mitkä olivat 10 suosituinta tiliäsi viime tilivuoden tuoton mukaan? | execute_query |
Tarkastaa datajoukon skeeman, luo SAQL-kyselyn ja palauttaa rakenteellisia tuloksia. |
| Mikä oli myyntiputki yhteensä viime vuosineljänneksellä alueittain? | execute_query |
Suorittaa ryhmityksen ja suodattamisen SAQL:n avulla. |
| Näytä myyntiedustajan suorituskyky verrattuna kiintiöön tässä kuussa. | execute_query |
Suorittaa kyselyn ja palauttaa rivien ja sarakkeiden metadatan rakenteellisena JSON-tiedostona. |
Beta-palaute ja tuki
Tämä palvelin on käytettävissä beta-versiossa. Palaute määrittää yleisesti saatavilla olevan (GA) käyttökokemuksen.
- Jaa palautetta Salesforce-asiakastiimillesi tai lähetä se tämän ohjelman Trailblazer Community -ryhmään.
- Tarkasta kunkin päivityksen julkaisuhuomautukset löytääksesi tunnettuja ongelmia ja ratkaisuja.
- Ota yhteyttä Salesforce-tukeen teknisiin ongelmiin määritysten aikana ja ota yhteyttä CRM Analytics MCP -palvelimeen (beta).
Ratkaisiko tämä artikkeli ongelmasi?
Anna palautetta, jotta voimme kehittyä!
