Considérations relatives à MCP pour Agentforce

Serveurs et enregistrements MCP

• MCP pour Agentforce prend en charge les serveurs qui utilisent le protocole de transport HTTP Streamable. HTTP+SSE et les autres protocoles ne sont pas pris en charge.
• MCP pour Agentforce prend en charge uniquement l'authentification et les identifiants client OAuth 2.0. Les autres flux OAuth ne sont pas pris en charge, notamment le code d'autorisation, CIMD, DCR, le porteur JWT et PKCE. Certains modèles d'authentification avancés sont disponibles avec une configuration supplémentaire, notamment les identifiants client OAuth 2.1.
• L'authentification au niveau de l'utilisateur n'est pas prise en charge. Actuellement, nous ne prenons pas en charge les cas d'utilisation qui nécessitent des ID d'utilisateur individuels ou des réponses personnalisées. Par exemple, vous ne pouvez pas utiliser MCP pour Agentforce pour rembourser un utilisateur individuel, mais vous pouvez l'utiliser pour récupérer toutes les factures de vos clients.
• MCP pour Agentforce prend en charge uniquement les outils serveur. Les applications, les invites et les ressources du serveur MCP ne sont pas prises en charge.
• Les noms d'outils peuvent inclure jusqu'à 128 caractères et prennent en charge les caractères suivants : ^a-zA-Z0-9./-{1,128}$
• Lorsqu'un serveur MCP n'est pas synchronisé ou n'est pas disponible, la vue de liste Inscriptions et la page d'enregistrement du serveur affichent actuellement le serveur comme connecté. Une réparation est en route.
• Les modifications apportées à l'enregistrement d'un serveur ou au serveur lui-même peuvent rompre les actions d'outil MCP associées dans un agent. Avant d'apporter des modifications, notamment supprimer l'inscription, retirez toutes les actions associées de votre agent, supprimez les actions associées de la bibliothèque d'actifs, puis supprimez l'inscription de votre serveur. Vous pouvez ensuite réinscrire votre serveur et ajouter les nouvelles actions de l'outil MCP à votre agent.

Empaquetage et déploiement

Pour plus de sécurité, Salesforce prend en charge l'empaquetage ou le déploiement d'agents qui contiennent des actions d'outil MCP, mais les métadonnées d'enregistrement du serveur MCP ne sont pas empaquetées. Toutes les actions d'outil MCP ajoutées à l'agent ne fonctionnent pas prêtes à l'emploi.

Avant de déployer un package dans le nouvel environnement, enregistrez les serveurs MCP et ajoutez les outils que l'agent utilise à la liste d'autorisations. Après le déploiement, retirez toutes les actions d'outil MCP existantes de l'agent et remplacez-les par les nouvelles actions de la bibliothèque d'actifs.

Les métadonnées des agents peuvent être empaquetées pour des agents brouillons ou engagés. Si l'agent est à l'état brouillon dans votre nouvel environnement, vous pouvez le modifier. Si l'agent est engagé, créez un brouillon pour apporter les modifications.

Prise en charge d'Agentforce Platform et du Générateur

• Les actions de l'agent qui référencent des actions du serveur MCP (actions de l'outil MCP) sont facturées au même taux que les autres actions de l'agent. Les rapports sur l'utilisation sont disponibles dans Digital Wallet. Consultez Utilisation et facturation d'Agentforce et de l'IA générative. Agentforce et IA générative Utilisation et facturation
• La prise en charge d'Agentforce Builder est plus forte pour les valeurs primitives et l'accès aux champs peu profond. Par conséquent, sélectionnez les outils du serveur MCP avec de simples réponses JSON structurées ou ajustez vos réponses, si possible. Les objets de niveau supérieur, les propriétés des objets de niveau supérieur et les tableaux d'objets de niveau supérieur sont pris en charge. Actuellement, les formes plus complexes ne sont pas prises en charge de bout en bout, notamment les propriétés imbriquées, les tableaux d'objets et les charges utiles d'objets dynamiques. En savoir plus.
• Agentforce Builder utilise des types Lightning pour restituer les entrées et les sorties d'actions. Les schémas d'entrée et de sortie d'outils MCP ne sont pas tous mappés avec des types Lightning. Lorsque les données d'une action d'outil MCP ne peuvent pas être résolues dans un type Lightning, vous pouvez toujours utiliser l'action avec votre agent. Cependant, l'entrée ou la sortie ne peut pas être stockée dans une variable. En savoir plus.
• Lorsque vous ajoutez une action d'outil MCP à votre agent :
  • Les étiquettes d'entrée et de sortie de certains types de données (par exemple des chiffres) peuvent être remplacées par l'étiquette « chaîne ». Cela n'affecte pas la logique ou le raisonnement de votre agent. Cependant, pour faciliter leur utilisation, nous recommandons de remplacer les étiquettes par les valeurs d'origine de l'action d'outil MCP dans la bibliothèque d'actifs ou le schéma d'entrée ou de sortie de l'outil MCP. Une réparation est en route.
  • Le champ Type d'action de référence est vide. L'action peut être exécutée sans type d'action de référence, même si elle est identifiée comme un champ obligatoire, car l'action de référence est remplie. Si vous cliquez sur ou modifiez le champ Type d'action de référence, l'action de référence est réinitialisée et ne peut pas être réinitialisée manuellement sur l'outil MCP. Dans ce cas, retirez l'action de votre agent et ajoutez-la de nouveau à la bibliothèque d'actifs. Une réparation est en route.
  • Pour les serveurs et outils MCP, les propriétés doivent être inférieures ou égales à 255 caractères. Actuellement, une propriété qui dépasse 255 caractères n'est pas prise en charge.
• Les réponses du serveur MCP sont soumises à ces périodes d'expiration. Ajustez les réponses pour les adapter à ces limites, si possible.
  • La limite en expiration client MCP est de 60 secondes. Par exemple, lorsqu'un serveur n'est pas disponible ou que sa réponse prend plus de 60 secondes.
  • L'expiration du moteur de raisonnement Atlas est de 120 secondes. Par exemple, lorsque plusieurs serveurs sont appelés et que la réponse collective prend plus de 120 secondes.
• Dans la vue Script, ne changez pas le nom du développeur d'une action MCP dans un sous-agent. Dans cet exemple de script Agent, le nom du développeur (UUID) est 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"

  Vous pouvez toutefois changer l'alias d'une action MCP et référencer cet alias dans les instructions. Dans cet exemple, get_cases_from_id est l'alias de l'action MCP référencée dans la section instructions et définie sous 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 = ...