Considerazioni per MCP per Agentforce

Server MCP e registrazioni

• MCP per Agentforce supporta i server che utilizzano il protocollo Streamable HTTP transport. HTTP+SSE e altri protocolli non sono supportati.
• MCP per Agentforce non supporta solo l'autenticazione e le credenziali client OAuth 2.0. Gli altri flussi OAuth non sono supportati, inclusi codice di autorizzazione, CIMD, DCR, bearer JWT e PKCE. Alcuni schemi di autenticazione avanzati sono disponibili con una configurazione aggiuntiva, incluse le credenziali client OAuth 2.1.
• L'autenticazione a livello di utente non è supportata. Al momento non sono supportati casi d'uso che richiedono ID utente individuali o risposte personalizzate. Ad esempio, non è possibile utilizzare MCP per Agentforce per concedere un rimborso a un singolo utente, ma è possibile utilizzarlo per ottenere tutte le fatture dei clienti.
• MCP per Agentforce supporta solo gli strumenti server. Le app, i prompt e le risorse del server MCP non sono supportati.
• I nomi degli strumenti possono contenere fino a 128 caratteri e supportano i seguenti caratteri: ^a-zA-Z0-9./-{1.128}$
• Quando un server MCP non è sincronizzato o non è disponibile, la visualizzazione elenco Registrazioni e la pagina del record del server mostrano attualmente il server come connesso. Sta arrivando una correzione.
• Le modifiche apportate alla registrazione di un server o al server stesso possono interrompere le azioni dello strumento MCP associato in un agente. Prima di apportare modifiche, inclusa l'eliminazione della registrazione, rimuovere tutte le azioni associate dall'agente, eliminare le azioni dell'agente associate dalla libreria di asset ed eliminare la registrazione del server. Quindi è possibile registrare nuovamente il server e aggiungere le nuove azioni dello strumento MCP all'agente.

Imballaggio e distribuzione

Per garantire la sicurezza, Salesforce supporta la creazione di pacchetti o la distribuzione di agenti che contengono azioni dello strumento MCP, ma i metadati di registrazione del server MCP non sono inclusi nei pacchetti. Le azioni dello strumento MCP aggiunte all'agente non funzionano immediatamente.

Prima di distribuire un pacchetto nel nuovo ambiente, registrare i server MCP e inserire nell'elenco consentiti gli strumenti utilizzati dall'agente. Dopo la distribuzione, rimuovere tutte le azioni dello strumento MCP esistenti dall'agente e sostituirle con le nuove azioni dalla libreria di asset.

I metadati degli agenti possono essere inseriti in pacchetti per bozze o agenti confermati. Se l'agente è in stato bozza nel nuovo ambiente, è possibile modificarlo. Se lo stato dell'agente è confermato, creare una nuova bozza per apportare le modifiche.

Supporto per piattaforma Agentforce e generatore

• Le azioni degli agenti che fanno riferimento ad azioni del server MCP (azioni dello strumento MCP) vengono fatturate alla stessa tariffa delle altre azioni degli agenti. I rapporti sull'utilizzo sono disponibili in Digital Wallet. Vedere Agenteforce e Generative AI Usage and Billing.
• Il supporto di Agentforce Builder è più efficace per i valori primitivi e l'accesso ai campi superficiale. Pertanto, selezionare gli strumenti del server MCP con risposte JSON strutturate semplici o modificare le risposte, ove possibile. Sono supportati gli oggetti di livello massimo, le proprietà degli oggetti di livello massimo e le matrici di oggetti di livello massimo. Le forme più complesse non sono attualmente supportate end-to-end, incluse le proprietà nidificate, le matrici di oggetti e i payload di oggetti dinamici. Ulteriori informazioni.
• Agentforce Builder utilizza i tipi Lightning per visualizzare gli input e gli output delle azioni. Non tutti gli schemi di input e output degli strumenti MCP vengono mappati ai tipi Lightning. Quando i dati di un'azione strumento MCP non possono essere risolti in un tipo Lightning, è comunque possibile utilizzare l'azione con il proprio agente. Tuttavia, l'input o l'output non possono essere memorizzati in una variabile. Ulteriori informazioni.
• Quando si aggiunge un'azione strumento MCP all'agente:
  • Le etichette di input e output di alcuni tipi di dati (ad esempio, i numeri) possono essere sostituite dall'etichetta "stringa". Ciò non influisce sulla logica o sul ragionamento dell'agente. Tuttavia, per semplicità d'uso, si consiglia di sostituire le etichette con i valori originali dell'azione dello strumento MCP nella libreria di asset o dello schema di input o output dello strumento MCP. Sta arrivando una correzione.
  • Il campo Tipo di azione di riferimento viene visualizzato vuoto. L'azione può essere eseguita senza un tipo di azione di riferimento, anche se è identificata come campo obbligatorio, perché l'azione di riferimento è compilata. Se si fa clic sul campo Tipo di azione di riferimento o lo si modifica, l'azione di riferimento viene reimpostata e non può essere reimpostata manualmente sullo strumento MCP. In questo caso, rimuovere l'azione dall'agente e aggiungerla nuovamente dalla libreria di asset. Sta arrivando una correzione.
  • Per i server e gli strumenti MCP, le proprietà devono essere inferiori o uguali a 255 caratteri. Una proprietà che supera i 255 caratteri non è attualmente supportata.
• Le risposte del server MCP sono soggette alle seguenti finestre di timeout. Ove possibile, modificare le risposte per adattarle a questi limiti.
  • Il limite di timeout client MCP è 60 secondi. Ad esempio, quando un server non è disponibile o richiede più di 60 secondi per rispondere.
  • Il timeout del motore di ragionamento Atlas è di 120 secondi. Ad esempio, quando vengono chiamati più server e la risposta complessiva richiede più di 120 secondi.
• In Visualizzazione script, non modificare il nome sviluppatore di un'azione MCP in un subagente. In questo esempio di script agente, il nome sviluppatore (UUID) è a4ace7b43ff031459019d3f5c350629a.

     actions:
        a4ace7b43ff031459019d3f5c350629a:
           description:
              Retrieves a list of customer support cases for a given customer Id.
           label: "custom_cases_by_id"
           require_user_confirmation: False
           include_in_progress_indicator: False
           source: "a4ace7b43ff031459019d3f5c350629a"
           target: "mcpTool://mcptoolx5xf5customerxfcasesxfbyxfid"

  Tuttavia, è possibile modificare l'alias di un'azione MCP e fare riferimento a tale alias nelle istruzioni. In questo esempio, get_cases_from_id è l'alias dell'azione MCP a cui si fa riferimento nella sezione instructions e definita in actions.

  Get customer support cases and answer questions
     reason:
        instructions:
           Get customer cases by customer id by calling {{actions.get_cases_from_id}}.
           If customer provides only email, call {{actions.customer_id_from_email}}
           to get the customer id first.
        actions:
           get_cases_from_id: @actions.a4ace7b43ff031459019d3f5c350629a
              with customer_id = ...
           customer_id_from_email: @actions.a365abc?3dabf237b28ce87f636204384
              with email = ...