Überlegungen zu MCP für Agentforce

MCP-Server und -Registrierungen

• MCP für Agentforce unterstützt Server, die das Streamable HTTP transport Protocol verwenden. HTTP+SSE und andere Protokolle werden nicht unterstützt.
• MCP für Agentforce unterstützt keine Authentifizierung und nur OAuth 2.0-Client-Anmeldeinformationen. Andere OAuth-Flows werden nicht unterstützt, einschließlich Autorisierungscode, CIMD, DCR, JWT-Bearer und PKCE. Einige erweiterte Authentifizierungsmuster sind mit zusätzlicher Konfiguration verfügbar, einschließlich OAuth 2.1-Clientanmeldeinformationen.
• Die Authentifizierung auf Benutzerebene wird nicht unterstützt. Anwendungsfälle, die individuelle Benutzer-IDs oder personalisierte Antworten erfordern, werden derzeit nicht unterstützt. Beispielsweise können Sie MCP für Agentforce nicht verwenden, um einem einzelnen Benutzer eine Rückerstattung zu gewähren, aber Sie können damit alle Rechnungen Ihrer Kunden abrufen.
• MCP für Agentforce unterstützt nur Servertools. MCP-Serveranwendungen, Aufforderungen und Ressourcen werden nicht unterstützt.
• Tool-Namen können bis zu 128 Zeichen umfassen und unterstützen die folgenden Zeichen: ^a-zA-Z0-9./-$
• Wenn ein MCP-Server nicht synchronisiert oder nicht verfügbar ist, wird der Server in der Listenansicht "Registrierungen" und auf der Server-Datensatzseite derzeit als verbunden angezeigt. Eine Korrektur ist unterwegs.
• Änderungen, die an einer Serverregistrierung oder am Server selbst vorgenommen werden, können die zugeordneten MCP-Tool-Aktionen in einem Agenten beeinträchtigen. Bevor Sie Änderungen vornehmen, einschließlich des Löschens der Registrierung, entfernen Sie alle zugeordneten Aktionen von Ihrem Agenten, löschen Sie die zugeordneten Agentenaktionen aus der Datenbestandsbibliothek und löschen Sie dann Ihre Serverregistrierung. Anschließend können Sie Ihren Server erneut registrieren und Ihrem Agenten die neuen MCP-Tool-Aktionen hinzufügen.

Paketerstellung und Bereitstellung

Aus Sicherheitsgründen unterstützt Salesforce die Paketerstellung oder Bereitstellung von Agenten, die MCP-Tool-Aktionen enthalten. Die Metadaten zur MCP-Serverregistrierung werden jedoch nicht in ein Paket aufgenommen. Alle dem Agenten hinzugefügten MCP-Tool-Aktionen funktionieren nicht vorkonfiguriert.

Registrieren Sie vor dem Bereitstellen eines Pakets in der neuen Umgebung die MCP-Server und setzen Sie die Tools, die der Agent verwendet, auf die Zulassungsliste. Entfernen Sie dann nach der Bereitstellung alle vorhandenen MCP-Toolaktionen aus dem Agenten und ersetzen Sie sie durch die neuen Aktionen aus der Datenbestandsbibliothek.

Agentenmetadaten können für Entwurfs- oder übernommene Agenten in Pakete aufgenommen werden. Wenn sich der Agent in Ihrer neuen Umgebung in einem Entwurfsstatus befindet, können Sie ihn bearbeiten. Wenn sich der Agent in einem übernommenen Zustand befindet, erstellen Sie einen neuen Entwurf, um die Änderungen vorzunehmen.

Unterstützung von Agentforce Platform und Generator

• Agentenaktionen, die auf MCP-Serveraktionen (MCP-Tool-Aktionen) verweisen, werden mit derselben Rate abgerechnet wie andere Agentenaktionen. Berichte zur Nutzung sind in Digital Wallet verfügbar. Entsprechende Informationen finden Sie unter Agentforce and Generative AI Usage and Billing (Nutzung und Abrechnung generativer AI).
• Die Agentforce Builder-Unterstützung ist für primitive Werte und flachen Feldzugriff am stärksten. Wählen Sie daher MCP-Servertools mit einfachen strukturierten JSON-Antworten aus oder passen Sie Ihre Antworten nach Möglichkeit an. Objekte der obersten Ebene, Objekteigenschaften der obersten Ebene und Arrays von Objekten der obersten Ebene werden unterstützt. Komplexere Formen werden derzeit nicht durchgängig unterstützt, einschließlich verschachtelter Eigenschaften, Arrays von Objekten und dynamischer Objektnutzlasten. Erfahren Sie mehr.
• Agentforce Builder verwendet Lightning-Typen zum Darstellen von Eingaben und Ausgaben für Aktionen. Nicht alle Eingabe- und Ausgabeschemas für MCP-Tools sind Lightning-Typen zugeordnet. Wenn die Daten einer MCP-Tool-Aktion nicht in einen Lightning-Typ aufgelöst werden können, können Sie die Aktion weiterhin mit Ihrem Agenten verwenden. Die Eingabe oder Ausgabe kann jedoch nicht in einer Variablen gespeichert werden. Erfahren Sie mehr.
• Wenn Sie Ihrem Agenten eine MCP-Toolaktion hinzufügen:
  • Die Eingabe- und Ausgabebezeichnungen für einige Datentypen (z. B. Zahlen) können durch die Bezeichnung "Zeichenfolge" ersetzt werden. Dies wirkt sich nicht auf die Logik oder die Argumentation Ihres Agenten aus. Aus Gründen der Benutzerfreundlichkeit wird jedoch empfohlen, die Bezeichnungen durch die ursprünglichen Werte aus der MCP-Tool-Aktion in der Datenbestandsbibliothek oder dem MCP-Tool-Eingabe- oder -Ausgabeschema zu ersetzen. Eine Korrektur ist unterwegs.
  • Das Feld "Referenzaktionstyp" wird leer angezeigt. Die Aktion kann ohne Referenzaktionstyp ausgeführt werden, obwohl sie als Pflichtfeld identifiziert wird, da die Referenzaktion ausgefüllt ist. Wenn Sie in das Feld "Referenzaktionstyp" klicken oder es ändern, wird die Referenzaktion zurückgesetzt und kann nicht manuell auf das MCP-Tool zurückgesetzt werden. Entfernen Sie in diesem Fall die Aktion aus Ihrem Agenten und fügen Sie sie aus der Datenbestandsbibliothek erneut hinzu. Eine Korrektur ist unterwegs.
  • Bei MCP-Servern und -Tools müssen die Eigenschaften kleiner oder gleich 255 Zeichen sein. Eine Eigenschaft, die 255 Zeichen überschreitet, wird derzeit nicht unterstützt.
• MCP-Serverantworten unterliegen diesen Zeitüberschreitungsfenstern. Passen Sie die Antworten nach Möglichkeit an diese Obergrenzen an.
  • Die Obergrenze für die MCP-Client-Zeitüberschreitung beträgt 60 Sekunden. Wenn ein Server beispielsweise nicht verfügbar ist oder länger als 60 Sekunden dauert.
  • Die Zeitüberschreitung des Atlas-Überlegungenmoduls beträgt 120 Sekunden. Wenn beispielsweise mehrere Server aufgerufen werden und die Antwort insgesamt länger als 120 Sekunden dauert.