Ti trovi qui:
Risoluzione dei problemi e suggerimenti del server MCP CRM Analytics
Risolvere i problemi di connessione e autorizzazione e utilizzare prompt e procedure che aiutano i client AI a eseguire query sui dati CRM Analytics in modo più preciso.
Versioni (Edition) richieste
| Disponibile in Lightning Experience. |
| Disponibile con CRM Analytics, disponibile a sua volta con un supplemento di prezzo nelle versioni Enterprise Edition, Performance Edition e Unlimited Edition. |
Problemi generali di connettività
- La connessione al server non riesce: Verificare che il server MCP CRM Analytics sia attivo in Imposta in Server MCP. Verificare inoltre di aver creato un'app client esterna con l'URL di richiamata corretto. Confermare quindi di aver eseguito l'accesso all'organizzazione che contiene l'app prima di avviare il flusso OAuth.
- Non vengono visualizzati strumenti: Verificare che il client MCP utilizzi l'URL server corretto per il tipo di organizzazione e che ogni utente abbia completato OAuth con le proprie credenziali Salesforce. Il server MCP CRM Analytics non supporta i token account di servizio.
- Organizzazione di produzione: Il server MCP CRM Analytics è disponibile nelle organizzazioni di produzione, nonché nelle organizzazioni Sandbox e vuote. Utilizzare l'URL del server corrispondente al tipo di organizzazione:
- Produzione:
https://api.salesforce.com/platform/mcp/v1/analytics/crma-beta - Sandbox o organizzazione vuota:
https://api.salesforce.com/platform/mcp/v1/sandbox/analytics/crma-beta
- Produzione:
Accesso a dati e strumenti
La sessione MCP viene eseguita come l'utente. Poiché l'autenticazione utilizza le credenziali Salesforce, ogni richiesta rispetta la protezione a livello di campo (FLS), la protezione a livello di oggetto (OLS), la protezione a livello di riga (RLS) e le regole di condivisione. Il client AI non può mai visualizzare dati o asset che non è possibile visualizzare in CRM Analytics.
- Serie di dati, cruscotti digitali o lenti mancanti: Se il cliente segnala che un asset non è disponibile o se una chiamata di
list_restituisce un numero di voci inferiore a quello previsto, probabilmente non si dispone dell'autorizzazione per quell'asset. Confermare di avere accesso all'app o all'asset e che l'insieme di autorizzazioni concede l'accesso a CRM Analytics. - Limite API: Le chiamate agli strumenti MCP vengono conteggiate nei limiti dell'API Wave dell'organizzazione. Controllare l'utilizzo in Imposta in Utilizzo API.
Per ulteriori informazioni, vedere la Guida alla risoluzione dei problemi.
Suggerimenti per risultati migliori
- Descrivere l'obiettivo, non lo strumento: Dire "Mostra opportunità aperte per fase" anziché "chiama list_datasets". Il client AI seleziona gli strumenti.
- Migliorare la precisione delle query con le descrizioni dei campi: L'aggiunta di etichette e descrizioni di campi ai metadati estesi (XMD) della serie di dati aiuta il client AI a generare SAQL più preciso.
- Perfezionare query complesse: Raggruppamenti nidificati, join multi-serie di dati o funzioni SAQL avanzate possono richiedere prompt di follow-up per ottenere il risultato esatto.
Esempi di prompt
Utilizzare questi prompt in una nuova sessione per scoprire gli asset, esaminare lo schema e porre domande sui dati.
| Prompt utente | Strumento chiamato | Scopo |
|---|---|---|
| A quali app di analisi ho accesso? | list_folders |
Restituisce le cartelle (app) che contengono i cruscotti digitali, le serie di dati e le lenti. Utilizzare i risultati per circoscrivere le ricerche successive. |
| A quali serie di dati CRM Analytics ho accesso in questo momento? | list_datasets |
Recupera i nomi, le etichette e gli ID delle serie di dati disponibili nel contesto di sicurezza. |
| Visualizzare tutti i cruscotti digitali nella cartella Applicazione di vendita. | list_dashboards |
Individua i cruscotti digitali predefiniti per un'app o un'unità operativa specifica. |
| Elencare tutte le esplorazioni salvate che sono autorizzato a visualizzare. | list_lenses |
Raccoglie un inventario delle lenti salvate e delle serie di dati a cui fanno riferimento. |
| Dammi i metadati completi della serie di dati Executive Pipeline. | get_dataset |
Restituisce i dettagli della serie di dati, incluso l'ID versione corrente necessario per eseguire query. |
| Quali sono i campi, le dimensioni e le misure esatte nella serie di dati Opportunità? | get_xmd |
Fornisce nomi API dei campi, tipi di dati ed etichette in modo che il client possa creare SAQL sintatticamente corretto. |
| Quali sono stati i nostri primi 10 account per reddito lo scorso anno fiscale? | execute_query |
Esamina lo schema della serie di dati, genera una query SAQL e restituisce risultati strutturati. |
| Qual è stata la pipeline totale per regione nell'ultimo trimestre? | execute_query |
Esegue raggruppamenti e filtri utilizzando SAQL. |
| Mostrami le prestazioni degli agenti rispetto alla quota questo mese. | execute_query |
Esegue una query e restituisce i metadati di righe e colonne come JSON strutturato. |
Feedback e supporto per la versione beta
Questo server è disponibile come rilascio beta. I commenti danno forma all'esperienza generalmente disponibile.
- Condividere i commenti con il team account Salesforce o inviarli nel gruppo Trailblazer Community per questo programma.
- Controllare le note di rilascio di ogni aggiornamento per individuare problemi e soluzioni note.
- Contattare l'assistenza Salesforce per problemi tecnici durante la configurazione e fare riferimento al server MCP CRM Analytics (beta).
Questo articolo ha risolto il problema?
Facci sapere, così possiamo migliorare!
