Loading
CRM Analytics
Referens för CRM Analytics MCP-serververktyg

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. CRM Analytics

Referens för CRM Analytics MCP-serververktyg

Skrivskyddade verktyg som låter MCP-kompatibla AI-klienter upptäcka appar, inspektera scheman, köra SAQL-frågor och läsa metadata för instrumentpaneler och linser.

Versioner som krävs

Finns i Lightning Experience.
Tillgängligt med CRM Analytics som finns mot en tilläggskostnad i versionerna Enterprise, Performance och Unlimited.

När du har anslutit anropar du inte dessa verktyg själv. Ställ en fråga på naturligt språk till din MCP-kompatibla AI-klient, som ChatGPT, Claude eller Markör. Klienten väljer verktygen för uppgiften.

Om du till exempel frågar "Vilka var våra 10 bästa konton efter intäkter förra räkenskapsåret?" inspekterar AI-klienten datauppsättningsschemat, skapar Salesforce Analytics Query Language (SAQL) och returnerar strukturerade resultat med execute_query.

Ett typiskt arbetsflöde för sökfrågor är list_datasets till get_dataset (insamling av currentVersionId) till get_xmd (exakta fältnamn) till execute_query.

Kolumnen Beskrivning/Inmatningar noterar de parametrar som behövs. Andra parametrar är valfria.

Organisation och Discovery-verktyg

Externa MCP-kompatibla AI-klienter använder dessa verktyg för att hitta mappar (appar) som innehåller instrumentpaneler, datauppsättningar och linser, och för att läsa in fullständiga mappmetadata.

Verktygsnamn Beskrivning / Indata Returer Använd när
list_folders

Returnerar mappar (appar) som den anslutna användaren har åtkomst till.

Indata: q (söktermer; verktyget lägger till ett jokertecken till den sista token), scope (CreatedByMe, Mru, SharedWithMe), sort (Name, Mru, LastModified, LastModifiedBy), isPinned, pageSize (1–200, standard 25), page.

 Mappobjekt med ID, etikett, beskrivning, mallkälla och behörigheter. Du behöver mapp-ID:n för att utöka senare listanrop, eller så vill du ha ett lager av appar.
get_folder

Returnerar fullständiga metadata för en mapp (app).

Indata: folderId (obligatoriskt). Upptäck ID:n med list_folders.

 Ett mappobjekt med etikett, beskrivning, mallkälla och behörigheter. Du behöver fullständiga metadata för en specifik app.

Data- och schemaverktyg

Externa MCP-kompatibla AI-klienter använder dessa verktyg för att lista datauppsättningar och hämta de fältnamn, datatyper och etiketter som behövs för att skapa giltig SAQL.

Verktygsnamn Beskrivning / Indata Returer Använd när
list_datasets

Returnerar datauppsättningar i en app eller i hela organisationen.

Indata: q, folderId, datasetTypes (Default, Live, StagedData, Trended), scope, sort (Name Mru, LastModified, TotalRowsCreatedDate, LastRefreshed CreatedBy, LastQueried, ConnectionName), order (Ascending, Descending)includeCurrentVersion, pageSize (1–200, standard 25), page.

 Datauppsättningsobjekt med namn, typer och senaste ändringsdatum. Du behöver namn och ID:n för datauppsättningar innan du inspekterar ett schema eller kör en sökfråga.
get_dataset

Returnerar fullständiga metadata för en datauppsättning, inklusive aktuell versionsinformation.

Indata: datasetIdOrApiName (obligatoriskt).

 Datauppsättningsmetadata inklusive fältnamn, datatyper, dimensions- och måttetiketter och aktuellt versions-ID. Du behöver currentVersionId innan du ringer get_xmd eller execute_query.
get_xmd

Returnerar utökade metadata (XMD) för en datauppsättningsversion, inklusive exakta fält-API-namn, datatyper, etiketter och formatering.

Indata: datasetIdOrApiName (obligatoriskt), versionId (obligatoriskt; ID på 18 tecken som börjar med 0Fc från get_dataset), xmdType (main standard, redo för frågor; system; user).

 Utökade metadata för datauppsättningsversionen, inklusive fältens API-namn, datatyper, etiketter och visningsformatering. Du behöver exakta fält-API-namn så att klienten kan bygga syntaktiskt korrekt SAQL.

Sökfråge- och analysverktyg

Externa MCP-kompatibla AI-klienter använder detta verktyg för att köra SAQL mot en CRM Analytics-datauppsättning och returnera strukturerade resultat. Klienten skapar SAQL från din begäran på naturligt språk.

Verktygsnamn Beskrivning / Indata Returer Använd när
execute_query

Kör en SAQL-fråga mot en CRM Analytics-datauppsättning.

Indata: query (obligatoriskt; SAQL-pipeline; laddningssteget måste använda "<datasetId>/<currentVersionId>"; sluta med q = limit q N;), queryLanguage (låst till Saql), timezone (tidszon i IANA-format, till exempel America/Los_Angeles), version (SAQL-version; utelämna för senaste).

 Strukturerade JSON-sökfrågeresultat med rader, kolumnmetadata och detaljer om utförandet av sökfrågor. Du vill ha grupperade, filtrerade eller rangordnade svar från en datauppsättning. Använd inte detta verktyg för metadataupptäckt.

Instrumentpanel, visualisering och utforskningsverktyg

Externa MCP-kompatibla AI-klienter använder dessa verktyg för att hitta instrumentpaneler och sparade utforskningar (linser) och för att hämta widget-, steg-, filter- och sökfrågedefinitioner.

Verktygsnamn Beskrivning / Indata Returer Använd när
list_dashboards

Returnerar CRM Analytics-instrumentpaneler i en app eller i hela organisationen.

Inmatningar: q, folderId, type (standard Dashboard; även DashboardSnapshot, Component—Komponent kräver redigeringsåtkomst och kan inte returnera några resultat för skrivskyddade användare), templateApiName, mobileOnly, ids, scope, sort, pageSize (1–200, standard 25), page.

 Instrumentpanelobjekt med namn, ID:n, typer och appsammanhang. Du behöver instrumentpanelidentifierare eller vill bläddra bland färdigbyggda instrumentpaneler för en app.
get_dashboard

Returnerar fullständiga metadata för en instrumentpanel, inklusive widgets, steg och filter.

Indata: dashboardIdOrApiName (obligatoriskt).

 Fullständiga instrumentpanelmetadata inklusive widgets, steg, filterkonfigurationer och layoutdetaljer. Du behöver den fullständiga definitionen av en specifik instrumentpanel.
list_lenses

Returnerar sparade utforskningar (linser) som den anslutna användaren har åtkomst till.

Indata: q, folderId, scope, sort, pageSize (1–200, standard 25), page.

 Linsobjekt med namn, ID:n och de datauppsättningar de refererar till. Du behöver en inventering av sparade utforskningar och de datauppsättningar de använder.
get_lens

Returnerar fullständiga metadata för en lins, inklusive sökfrågedefinitionen och datauppsättningsreferensen.

Indata: lensIdOrApiName (obligatoriskt).

 Fullständiga linsmetadata inklusive sökfrågedefinitionen, visualiseringskonfigurationen och datauppsättningsreferensen. Du behöver sökfråge- och visualiseringsdetaljerna för en specifik lins.
 
Laddar
Salesforce Help | Article