Att tänka på vad gäller MCP för Agentforce

MCP-servrar och registreringar

• MCP för Agentforce har stöd för servrar som använder transportprotokollet Streamable HTTP. HTTP+SSE och andra protokoll stöds inte.
• MCP för Agentforce har endast stöd för ingen autentisering och OAuth 2.0-klientuppgifter. Andra OAuth-flöden stöds inte, inklusive auktoriseringskod, CIMD, DCR, JWT-bärare och PKCE. Vissa avancerade autentiseringsmönster är tillgängliga med ytterligare konfiguration, inklusive OAuth 2.1-klientuppgifter.
• Autentisering på användarnivå stöds inte. Vi har för närvarande inte stöd för användningsfall som kräver individuella användar-ID:n eller personliga svar. Du kan till exempel inte använda MCP för Agentforce för att ge en enskild användare en återbetalning, men du kan använda det för att få alla dina kunders fakturor.
• MCP för Agentforce har endast stöd för serververktyg. MCP-serverappar, uppmaningar och resurser stöds inte.
• Verktygsnamn kan vara upp till 128 tecken och har stöd för följande tecken: ^a-zA-Z0-9./-{1 128}$
• Om en MCP-server inte är synkroniserad eller otillgänglig visar listvyn Registreringar och serverpostsidan för närvarande servern som ansluten. En fix är på väg.
• Ändringar som görs av en serverregistrering eller själva servern kan förstöra de associerade MCP-verktygsåtgärderna i en agent. Innan du gör några ändringar, inklusive att ta bort registreringen, ta bort alla associerade åtgärder från din agent, ta bort de associerade agentåtgärderna från tillgångsbiblioteket och ta sedan bort din serverregistrering. Sedan kan du registrera din server igen och lägga till de nya MCP-verktygsåtgärderna till din agent.

Paketering och distribuering

För att säkerställa säkerhet har Salesforce stöd för paketering eller distribuering av agenter som innehåller MCP-verktygsåtgärder, men metadata för MCP-serverregistrering paketeras inte. Alla MCP-verktygsåtgärder som läggs till i agenten fungerar inte direkt.

Innan du distribuerar ett paket i den nya miljön, registrera MCP-servrarna och tillåtelselista de verktyg agenten använder. Efter att du har distribuerat, ta bort befintliga MCP-verktygsåtgärder från agenten och ersätt dem med de nya åtgärderna från tillgångsbiblioteket.

Agentmetadata kan paketeras för utkast eller överlämnade agenter. Om agenten är i utkastläge i din nya miljö kan du redigera den. Om agenten är i ett överlämnat läge, skapa ett nytt utkast för att göra ändringarna.

Stöd för Agentforce Platform och Builder

• Agentåtgärder som refererar MCP-serveråtgärder (MCP-verktygsåtgärder) faktureras med samma taxa som andra agentåtgärder. Rapporter om användning finns i Digital Wallet. Se Användning och fakturering av Agentforce och Generativ AI.
• Agentforce Builder har starkast stöd för primitiva värden och ytlig fältåtkomst. Välj därför MCP-serververktyg med enkla strukturerade JSON-svar eller justera dina svar där det är möjligt. Objekt på högsta nivå, objektegenskaper på högsta nivå och objektmatriser på högsta nivå stöds. Mer komplexa former stöds för närvarande inte från början till slut, inklusive kapslade egenskaper, matriser av objekt och dynamiska objektbelastningar. Läs mer.
• Agentforce Builder använder Lightning typer för att återge indata och utdata för åtgärder. Inte alla indata- och utdatascheman för MCP-verktyg mappas till Lightning. Om en MCP-verktygsåtgärds data inte kan lösas till en Lightning kan du fortfarande använda åtgärden med din agent. Indata eller utdata kan dock inte lagras i en variabel. Läs mer.
• När du lägger till en MCP-verktygsåtgärd till din agent:
  • Indata- och utdataetiketter för vissa datatyper (till exempel nummer) kan ersättas med etiketten “sträng”. Detta påverkar inte din agents logik eller resonemang. För enkel användning rekommenderar vi dock att ersätta etiketterna med de ursprungliga värdena från MCP-verktygsåtgärden i tillgångsbiblioteket eller MCP-verktygets indata- eller utdataschema. En fix är på väg.
  • Fältet Referensåtgärdstyp visas tomt. Åtgärden kan köras utan en referensåtgärdstyp, även om den är identifierad som ett obligatoriskt fält, eftersom referensåtgärden är ifylld. Om du klickar på eller ändrar fältet Referensåtgärdstyp återställs referensåtgärden och kan inte återställas till MCP-verktyget manuellt. I detta fall, ta bort åtgärden från din agent och lägg till den igen från tillgångsbiblioteket. En fix är på väg.
  • För MCP-servrar och -verktyg måste egenskaperna vara mindre än eller lika med 255 tecken. En egenskap som överskrider 255 tecken stöds för närvarande inte.
• MCP-serversvar är föremål för dessa timeoutfönster. Justera svar så att de passar dessa gränser, där så är möjligt.
  • Gränsen för MCP-klienttimeout är 60 sekunder. Till exempel om en server inte är tillgänglig eller tar längre tid än 60 sekunder att svara.
  • Timeout för Atlas resonemangsmotor är 120 sekunder. Till exempel när flera servrar anropas och det tillsammans tar längre än 120 sekunder att svara.
• I Skriptvy, ändra inte utvecklarnamnet på en MCP-åtgärd i en underagent. I detta exempel på Agentskript är utvecklarnamnet (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"

  Du kan dock ändra aliaset för en MCP-åtgärd och hänvisa till detta alias i instruktionerna. I detta exempel är get_cases_from_id aliaset för MCP-åtgärden som refereras i sektionen instructions och definieras under 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 = ...