Loading
Agentforce og Einstein Generative AI
Opsæt filuploads for en agent

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Hurtigstart din Einstein Generative AI-løsning

Opsæt filuploads for en agent

Føj filuploadunderstøttelse til din agent, så dine brugere kan dele skærmbilleder, kvitteringer og PDF'er. Din agent kan fortolke individuelle filer eller en gruppe af filer, besvare spørgsmål baseret på en eller flere filer og føje filer til en Salesforce-registrering.

EditionsHeading

Tilgængelig i: Lightning Experience
Tilgængelig i: Enterprise, Performance, Unlimited og Developer Edition. Krav til tilføjelsesprogramlicenser varierer efter agenttype.
Brugertilladelser påkrævet
Hvis du vil opsætte filuploads i en AI-agent: Administrer AI-agenter OG de krævede tilladelser for din agenttype

Før du går i gang, skal du gennemse supporten og kravene til tilføjelse af filuploads til din agent.

Understøttelse af Agentforce
Agenttyper

Agentforce, Agentforce

Agenter skal oprettes i eller opgraderes til Agent Script og Agentforce Builder i Agentforce Studio.
Kanaler

Forbedret Chat v1, Forbedret Chat v2, Lightning Experience

Mobil understøttes aktuelt ikke.

På nogle tredjepartsmeddelelsesklienter (Line, WeChat, WhatsApp) opdeles flere vedhæftninger i individuelle meddelelser og behandles af agenten individuelt.
Modeller

Kun OpenAI GPT 4.1. Azure OpenAI understøttes aktuelt ikke. LLM Multimodal Support grænser gælder.

HyperClassifier-modellen understøtter ikke billeder. Hvis du bruger HyperClassifier-modellen til underagentklassificering, kan du ikke bruge agentdistributøren til at oprette uploads eller distribuere samtaler baseret på indholdet af filuploads.
Filer

PNG, JPEG, PDF

Filer kan være på op til 5 MB hver.

En agent kan acceptere op til 5 filer pr. meddelelse (varierer efter kanal) og op til 10 filer pr. samtale. Hvis en bruger uploader mere end 10 filer, gemmer agenten de seneste 10.
  1. Fra listen Agenter i Agentforce Studio-appen skal du åbne den agent, du vil modtage filuploads.
  2. Føj eventuelt file_upload-underblokken til agentens script og angiv den tilstand, som du ønsker, at din agent skal bruge til håndtering af filuploads.

    Brug denne indstilling for agentscript til at definere, hvordan din agent bruger og lagrer uploadede filer. Du kan også bruge denne indstilling til at inaktivere filuploads for din agent. Hvis du ikke angiver en tilstand, og din agent kan modtage filuploads, anvendes automatisk tilstand som standard.

    1. Hvis du får vist agenten i lærredsvisning, skal du skifte til scriptvisning.
    2. Tilføj feltet file_upload i din agents config og angiv en mode-værdi. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Tilgængelige tilstande:

      • auto – Filer behandles og gemmes i samtalehistorikken. Brug denne tilstand til at tillade agenten automatisk at administrere, hvordan og hvornår filer bruges.
      • managed – Filer gemmes i systemvariablen uploaded_files (@system_variables.uploaded_files), og du bruger variablen til at styre, hvordan filer bruges. Filer gemmes ikke i samtalehistorikken. Brug denne tilstand til eksplicit at administrere, hvordan filer sendes til LLM, hvilke underagenter der kan få adgang til filerne, og hvordan filerne sendes og bruges af andre handlinger. Hvis du vil give agenten adgang til uploadede filer, skal du referere til variablen direkte i underagentinstruktioner eller tildele den til handlingsinput og output.
      • disabled – Filuploads deaktiveres stille. Se Deaktiver filuploads for en agent.
      • error – Filuploads deaktiveres, og agenten sender en fejlmeddelelse. Se Deaktiver filuploads for en agent.
  3. Tilpas dine underagenter og handlinger.
    1. Giv din agent filhåndteringsinstruktioner. For at opnå de bedste resultater anbefaler vi, at du opretter en dedikeret underagent til håndtering af filuploads, så du kan angive detaljerede instruktioner og kontrollere underagentdistribution for din forretningssag. Du ønsker f.eks. at angive entydige instruktioner for, hvordan du håndterer PDF-filer kontra billedfiler.
      Bemærk
      Bemærk Uden eksplicitte instruktioner om, at din agent kan acceptere filuploads, når din agent modtager en fil, kan din agent omdirigere samtalen til systemunderagenten Ikke-emne. I et minimum skal du i en underagent, som du ønsker at bruge til filhåndtering, bede din agent om at bruge underagenten til at behandle filer.

      Her er et eksempel på agentscript for en underagentblok for fil- og billedanalyse.

      subagent File_and_Image_Analysis:
   label: "File and Image Analysis"
   description: |
       Use this topic when the user uploads a PDF, document, or image file and asks to summarize, analyze, describe, extract text from, or answer questions about its contents.
   reasoning:
       instructions: ->
           | 1. Evaluate standard user requests involving uploaded attachments (PDFs, images, or documents).
           | 2. When a user asks to describe, summarize, or extract text from an uploaded PDF or image:
           |    - Identify the primary topics, main takeaways, key data points, and structural highlights from the document or visual content.
           |    - Provide a clear, structured summary using bullet points or concise paragraphs.
           |    - Do not guess or fabricate information not present in the attached file.
           | 3. If the document content is unclear or incomplete, politely ask the user for clarification while describing what is currently visible.
    2. Hvis du bruger managed-tilstand, skal du sørge for, at uploaded_files-systemvariablen er føjet til din agent. Hvis du vil give din agent adgang til uploadede filer, skal du referere til variablen i agentinstruktioner, tildele den til agenthandlingsinput eller -output eller begge.
      Hvis du vil vide mere om brug af uploaded_files-systemvariablen, kan du se Agentforce Developer Guide: Systemvariabler. Hvis du vil vide mere om at arbejde med listevariabler, kan du se Agentforce Developer Guide: Brug af listevariabler.
  4. Gem dine ændringer.
  5. Hvis du tilslutter en agent til Forbedret chat:
    1. Fra siden Indstillinger for Meddelelser i Opsætning skal du aktivere fildeling for slutbrugere. Du kan også angive tilladte filtyper og maksimal filstørrelse. Se Tilpas fildelingsoplevelsen i Forbedret chat.
    2. Sørg for, at din agentbruger har den krævede adgang.
      • Systemtilladelser: Chatter Intern bruger, Få adgang til samtaleoplysninger
      • Objekttilladelser: Meddelelsessession
      • Objektindstillinger: Meddelelsessession, Meddelelsesbruger
      Bemærk
      Bemærk Hvis du oprettede en agentbruger, da du oprettede din agent, tildeles din agentbruger som standard de krævede objekttilladelser og indstillinger for Meddelelsessession.
  6. Hvis du tilslutter din agent til en Experience Cloud-lokalitet, der tillader gæstebrugere, skal du give dem tilladelse til at uploade filer. Gæstebrugere kan kun uploade filer til en registrering, når der findes delingsregler for gæstebrugere.
    1. Skriv Salesforce Files i feltet Find hurtigt i Opsætning, og vælg derefter Generelle indstillinger.
    2. Vælg Tillad lokalitetsgæstebrugere at uploade filer.
  7. Før du implementerer din agent, skal du teste din agents filuploadkonfiguration. Start en eksempelvisningssamtale i Agentforce Builder, og send en fil. Filuploads kan testes end til end.
 
Indlæser
Salesforce Help | Article