Overvejelser i forbindelse med MCP for Agentforce

MCP-servere og registreringer

• MCP for Agentforce understøtter servere, der bruger Streamable HTTP-transportprotokollen. HTTP+SSE og andre protokoller understøttes ikke.
• MCP for Agentforce understøtter kun godkendelse og OAuth 2.0-klientlegitimationsoplysninger. Andre OAuth-forløb understøttes ikke, herunder autorisationskode, CIMD, DCR, JWT Bearer og PKCE. Nogle avancerede godkendelsesmønstre er tilgængelige med yderligere konfiguration, herunder OAuth 2.1-klientlegitimationsoplysninger.
• Godkendelse på brugerniveau understøttes ikke. Vi understøtter aktuelt ikke anvendelsessituationer, der kræver individuelle bruger-id'er eller personlige svar. Du kan f.eks. ikke bruge MCP for Agentforce til at give en individuel bruger en refusion, men du kan bruge det til at hente alle dine kunders fakturaer.
• MCP for Agentforce understøtter kun serverværktøjer. MCP-serverapps, -meddelelser og -ressourcer understøttes ikke.
• Værktøjsnavne kan være på op til 128 tegn og understøtter følgende tegn: ^a-zA-Z0-9./-{1,128}$
• Når en MCP-server er ude af synkronisering eller utilgængelig, viser listevisningen Registreringer og serverregistreringssiden aktuelt serveren som tilsluttet. En løsning er på vej.
• Ændringer, der er foretaget i en serverregistrering eller selve serveren, kan afbryde de tilknyttede MCP-værktøjshandlinger i en agent. Før du foretager ændringer, herunder sletning af registreringen, skal du fjerne eventuelle tilknyttede handlinger fra din agent, slette de tilknyttede agenthandlinger fra aktivbiblioteket og derefter slette din serverregistrering. Derefter kan du registrere din server igen og føje de nye MCP-værktøjshandlinger til din agent.

Pakning og implementering

For at sikre sikkerheden understøtter Salesforce pakning eller implementering af agenter, der indeholder MCP-værktøjshandlinger, men MCP-serverregistreringsmetadata er ikke pakket. Alle MCP-værktøjshandlinger, der føjes til agenten, fungerer ikke korrekt.

Før du implementerer en pakke i det nye miljø, skal du registrere MCP-servere og sætte de værktøjer på tilladelseslisten, som agenten bruger. Når du har implementeret det, skal du fjerne alle eksisterende MCP-værktøjshandlinger fra agenten og erstatte dem med de nye handlinger fra aktivbiblioteket.

Agentmetadata kan pakkes til kladde- eller bekræftede agenter. Hvis agenten er i kladdetilstand i dit nye miljø, kan du redigere den. Hvis agenten er i en forpligtet tilstand, skal du oprette en ny kladde for at foretage ændringerne.

Agentforce Platform og Konstruktør Support

• Agenthandlinger, der refererer til MCP-serverhandlinger (MCP-værktøjshandlinger), faktureres med den samme sats som andre agenthandlinger. Rapportering om brug er tilgængelig i Digital Wallet. Se Agentforce og Generativ AI-anvendelse og fakturering.
• Agentforce Builder-understøttelse er stærkest for primitive værdier og fladfeltadgang. Vælg derfor MCP-serverværktøjer med enkle strukturerede JSON-svar, eller juster dine svar, hvor det er muligt. Objekter på topniveau, objektegenskaber på topniveau og matrikser på topniveau af objekter understøttes. Mere komplekse figurer understøttes aktuelt ikke end-til-end, herunder indlejrede egenskaber, matrikser af objekter og dynamiske objektdata. Læs mere.
• Agentforce bruger Lightning til at gengive handlingsinput og -output. Ikke alle MCP-input- og outputskemaer er tilknyttet Lightning. Når en MCP-værktøjs handlings data ikke kan løses til en Lightning, kan du stadig bruge handlingen med din agent. Men input eller output kan ikke lagres i en variabel. Læs mere.
• Når du føjer en MCP-værktøjshandling til din agent:
  • Input- og outputbetegnelserne for nogle datatyper (f.eks. tal) kan erstattes med betegnelsen "streng". Dette påvirker ikke din agents logik eller argumentation. Men af hensyn til brugervenligheden anbefaler vi, at du erstatter betegnelserne med de oprindelige værdier fra MCP-værktøjshandlingen i aktivbiblioteket eller MCP-værktøjsinput- eller outputskemaet. En løsning er på vej.
  • Feltet Referencehandlingstype vises som tomt. Handlingen kan køre uden en referencehandlingstype, selvom den er identificeret som et påkrævet felt, fordi referencehandlingen er udfyldt. Hvis du klikker på eller ændrer feltet Referencehandlingstype, nulstilles referencehandlingen og kan ikke manuelt nulstilles til MCP-værktøjet. I denne situation skal du fjerne handlingen fra din agent og tilføje den igen fra aktivbiblioteket. En løsning er på vej.
  • For MCP-servere og værktøjer skal egenskaberne være på mindre end eller lig med 255 tegn. En egenskab, der overskrider 255 tegn, understøttes aktuelt ikke.
• MCP-serversvar er underlagt disse timeoutvinduer. Juster svar, så de passer til disse grænser, hvor det er muligt.
  • MCP-klienttimeoutgrænsen er 60 sekunder. F.eks. når en server er utilgængelig eller tager mere end 60 sekunder at svare.
  • Atlas-reageringssystemets timeout er 120 sekunder. Når f.eks. flere servere kaldes og det i alt tager mere end 120 sekunder at svare.
• I Scriptvisning skal du ikke ændre udviklernavnet på en MCP-handling i en underagent. I dette agentscripteksempel er udviklernavnet (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 dog ændre aliasset for en MCP-handling og henvise til dette alias i instruktionerne. I dette eksempel er get_cases_from_id alias for den MCP-handling, der refereres til i instructions og defineres 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 = ...