Risoluzione dei problemi MCP per Agentforce

Il mio agente non trova un server MCP.

Nessuna risposta da un server MCP registrato in Salesforce.

• Controllare la connessione di rete.
• Verificare che il server MCP sia attivo e funzionante correttamente.
• Controllare le impostazioni di registrazione del server MCP. È cambiato qualcosa sul lato server, ad esempio l'URL? Lo strumento è ancora disponibile sul server MCP? Aggiornare le impostazioni di registrazione in base alle esigenze. Vedere Modifica dei dettagli.
• Per i server MCP ospitati da Salesforce, vedere anche Errori di connessione.

Risolvere eventuali problemi e riprovare a connettersi al server.

Il mio agente non può accedere a uno strumento del server MCP (errore di autenticazione).

Gli errori di autenticazione possono essere dovuti a credenziali errate o scadute o ad altre modifiche lato server. MCP per Agentforce supporta questi tipi:

• nessuna autenticazione
• Credenziale client OAuth 2.0

Controllare le impostazioni di autenticazione per il server MCP registrato in Salesforce. È necessario rinnovare le credenziali? È cambiato qualcos'altro sul lato server? Ad esempio, il server ora richiede le credenziali di autenticazione quando in precedenza non lo richiedeva? Aggiornare le impostazioni di autenticazione di conseguenza. Vedere Modifica dei dettagli.

Per i server MCP ospitati da Salesforce, vedere anche Problemi di autenticazione.

Il mio agente sta ricevendo un errore di non sincronizzazione.

Le modifiche lato server nei server MCP registrati in Salesforce possono causare la mancata sincronizzazione delle impostazioni di registrazione e dell'elenco consentiti correnti. Ad esempio, gli aggiornamenti di uno strumento server (ad esempio una descrizione modificata, differenze nello schema di input o output o persino la rimozione dello strumento) possono influire negativamente sugli agenti che dipendono da quello strumento.

MCP per Agentforce identifica tali problemi, contrassegna un server MCP o uno strumento server registrato come Non sincronizzato e invia una notifica a un amministratore. Vedere Risoluzione dei problemi del server MCP non sincronizzato.

Il mio agente riceve un errore di timeout MCP.

Gli errori di timeout correlati a MCP si verificano quando:

• uno strumento del server MCP registrato in Salesforce non è disponibile o richiede più di 60 secondi per rispondere
• vengono chiamati più server e la risposta complessiva richiede più di 120 secondi (timeout del motore di ragionamento Atlas)

Iniziare determinando se l'alta latenza è dovuta a operazioni correlate a MCP. Utilizzare gli strumenti di debug descritti in "Risorse per la risoluzione dei problemi" (ad esempio Plan Tracer nel Generatore di agenti e i registri di traccia) per isolare la posizione in cui si verificano i timeout nella soluzione Agentforce.

Se è stato confermato che le operazioni MCP causano errori di timeout:

• Controllare la connessione di rete.
• Verificare che il server MCP sia attivo e funzionante correttamente.
• Per i server MCP ospitati da Salesforce, utilizzare gli strumenti amministrativi per risolvere i ritardi causati dalle operazioni correlate all'MCP. (la visibilità sui server MCP di terze parti è limitata.)

Risolvere eventuali problemi, testare e distribuire le correzioni e continuare a monitorare i timeout.

Il mio agente ha altri problemi correlati all'MPC.

• Assicurarsi che la soluzione Agentforce sia conforme ai requisiti per MCP per Agentforce.
• Consultare le Considerazioni sull'MCP per Agentforce per determinare se sono necessarie modifiche applicabili per la soluzione Agentforce.
• Contattare l'assistenza Salesforce tramite i canali di assistenza dell'organizzazione.

Risorse per la risoluzione dei problemi

Agentforce offre strumenti e funzioni che consentono di identificare gli schemi, analizzare le cause profonde e intraprendere azioni correttive.

• In Agent Builder, utilizzare Plan Tracer nel riquadro di anteprima della conversazione per isolare gli errori di traffico di rete tra il client e il server MCP. Esaminare passo per passo le decisioni e le azioni dettagliate intraprese dall'agente durante una conversazione o un test di flusso di lavoro. Concentrarsi sulle operazioni correlate all'MPC.
• Utilizzare i registri eventi ottimizzati per fornire dettagli dettagli dettagliati sulle conversazioni degli agenti.
• Utilizzare Agent Analytics per monitorare le prestazioni degli agenti e rilevare le tendenze degli errori. Analizzare gli schemi e le cause principali a livello di sessione (vedere Analisi dei dati con ottimizzazione degli agenti).
• In Monitoraggio dello stato degli agenti, impostare soglie di avviso per attivare notifiche quando le prestazioni degli agenti superano i livelli di soglia.
• Per i server MCP ospitati da Salesforce, diagnosticare e risolvere i problemi utilizzando gli strumenti amministrativi che accompagnano il server MCP.