Overwegingen bij MCP voor Agentforce

MCP-servers en -registraties

• MCP voor Agentforce ondersteunt servers die het Streamable HTTP-transportprotocol gebruiken. HTTP+SSE en andere protocollen worden niet ondersteund.
• MCP voor Agentforce ondersteunt alleen geen authenticatie en OAuth 2.0-clientinloggegevens. Andere OAuth-stromen worden niet ondersteund, inclusief autorisatiecode, CIMD, DCR, JWT-bearer en PKCE. Sommige geavanceerde authenticatiepatronen zijn beschikbaar met aanvullende configuratie, waaronder OAuth 2.1-clientinloggegevens.
• Authenticatie op gebruikersniveau wordt niet ondersteund. Momenteel ondersteunen we geen gebruikscases die individuele gebruikers-ID's of gepersonaliseerde reacties vereisen. Zo kunt u MCP voor Agentforce niet gebruiken om een afzonderlijke gebruiker een restitutie te geven, maar kunt u het gebruiken om alle facturen van uw klanten te ontvangen.
• MCP voor Agentforce ondersteunt alleen servertools. MCP-serverapps, aanwijzingen en resources worden niet ondersteund.
• Toolnamen kunnen maximaal 128 lettertekens lang zijn en ondersteunen de volgende lettertekens: ^a-zA-Z0-9./-{1.128}$
• Wanneer een MCP-server niet gesynchroniseerd of niet beschikbaar is, tonen de lijstweergave Registraties en de serverrecordpagina momenteel de server als verbonden. Er komt een oplossing aan.
• Wijzigingen die worden aangebracht aan een serverregistratie of de server zelf, kunnen de gekoppelde MCP-toolacties in een agent verbreken. Voordat u wijzigingen aanbrengt, inclusief het verwijderen van de registratie, verwijdert u alle gekoppelde acties uit uw agent, verwijdert u de gekoppelde agentacties uit de activumbibliotheek en verwijdert u vervolgens uw serverregistratie. Vervolgens kunt u uw server opnieuw registreren en de nieuwe MCP-toolacties toevoegen aan uw agent.

Verpakking en implementatie

Om de beveiliging te waarborgen, ondersteunt Salesforce wel het in een pakket opnemen of implementeren van agenten die MCP-toolacties bevatten, maar worden metagegevens voor MCP-serverregistratie niet in een pakket opgenomen. Alle MCP-toolacties die aan de agent worden toegevoegd, werken niet kant-en-klaar.

Voordat u een pakket implementeert in de nieuwe omgeving, registreert u de MCP-servers en plaatst u de tools die de agent gebruikt op een goedgekeurde lijst. Verwijder vervolgens na de implementatie alle bestaande MCP-toolacties uit de agent en vervang deze door de nieuwe acties uit de activumbibliotheek.

Metagegevens van agenten kunnen worden opgenomen in een pakket voor conceptagenten of toegewijde agenten. Als de agent een conceptstatus heeft in uw nieuwe omgeving, kunt u deze bewerken. Als de agent een toegewezen status heeft, maakt u een nieuw concept om de wijzigingen aan te brengen.

Ondersteuning voor Agentforce Platform en Builder

• Agentacties die verwijzen naar MCP-serveracties (MCP-toolacties) worden gefactureerd tegen hetzelfde tarief als andere agentacties. Rapportage over gebruik is beschikbaar in Digital Wallet. Zie Agentforce en genererend AI-gebruik en facturering.
• Agentforce Builder-ondersteuning is het sterkst voor primitieve waarden en ondiepe veldtoegang. Selecteer daarom MCP-servertools met eenvoudige gestructureerde JSON-responsen of pas uw responsen waar mogelijk aan. Objecten op het hoogste niveau, objecteigenschappen op het hoogste niveau en arrays van objecten op het hoogste niveau worden ondersteund. Complexere vormen worden momenteel niet van begin tot eind ondersteund, inclusief geneste eigenschappen, arrays van objecten en dynamische objectpayloads. Meer informatie.
• Agentforce Builder gebruikt Lightning typen voor het weergeven van actie-invoer en -uitvoer. Niet alle invoer- en uitvoerschema's van MCP-tools worden toegewezen aan Lightning typen. Wanneer de gegevens van een MCP-toolactie niet kunnen worden omgezet naar een Lightning type, kunt u de actie nog steeds gebruiken met uw agent. De invoer of uitvoer kan echter niet worden opgeslagen in een variabele. Meer informatie.
• Wanneer u een MCP-toolactie toevoegt aan uw agent:
  • De invoer- en uitvoerlabels voor bepaalde gegevenstypen (bijvoorbeeld getallen) kunnen worden vervangen door het label "tekenreeks". Dit heeft geen invloed op de logica of redenering van uw agent. Voor het gebruiksgemak wordt echter aangeraden om de labels te vervangen door de oorspronkelijke waarden uit de MCP-toolactie in de activumbibliotheek of het invoer- of uitvoerschema van de MCP-tool. Er komt een oplossing aan.
  • Het veld Type verwijzingsactie wordt leeg weergegeven. De actie kan worden uitgevoerd zonder verwijzingsactietype, ook al is deze aangeduid als een verplicht veld, omdat de verwijzingsactie is ingevuld. Als u in het veld Type verwijzingsactie klikt of dit wijzigt, wordt de verwijzingsactie opnieuw ingesteld en kan deze niet handmatig opnieuw worden ingesteld op de MCP-tool. In dit geval verwijdert u de actie uit uw agent en voegt u deze opnieuw toe vanuit de activumbibliotheek. Er komt een oplossing aan.
  • Voor MCP-servers en -tools moeten eigenschappen kleiner zijn dan of gelijk zijn aan 255 lettertekens. Een eigenschap van meer dan 255 lettertekens wordt momenteel niet ondersteund.
• MCP-serverreacties zijn onderworpen aan deze time-outvensters. Pas responsen aan om deze limieten te halen, waar mogelijk.
  • De time-outlimiet voor MCP-clients is 60 seconden. Bijvoorbeeld wanneer een server niet beschikbaar is of er langer dan 60 seconden over doet om te reageren.
  • De time-out van de Atlas-redeneringsengine is 120 seconden. Bijvoorbeeld wanneer meerdere servers worden aangeroepen en er gezamenlijk meer dan 120 seconden over doen om te reageren.
• Wijzig in Scriptweergave niet de ontwikkelaarsnaam van een MCP-actie in een subagent. In dit voorbeeld van Agentscript is de naam van de ontwikkelaar (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"

  U kunt echter wel de alias van een MCP-actie wijzigen en naar die alias verwijzen in de instructies. In dit voorbeeld is get_cases_from_id de alias van de MCP-actie waarnaar wordt verwezen in de sectie instructions en die is gedefinieerd onder 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 = ...