Loading
Agentforce og Einstein Generative AI
Konfigurere filopplastinger for en agent

Du er her:

  1. Salesforce Hjelp
  2. Dokumenter
  3. Hurtigstart Einstein generative AI-løsning

Konfigurere filopplastinger for en agent

Legg til støtte for filopplasting til agenten slik at brukerne kan dele skjermbilder, kvitteringer og PDF-filer. Agenten kan tolke individuelle filer eller en gruppe filer, svare på spørsmål basert på én eller flere filer og legge til filer i en Salesforce-post.

Nødvendige utgaver

Tilgjengelig i Lightning Experience
Tilgjengelig i Enterprise, Performance, Unlimited og Developer Edition. Nødvendige tilleggslisenser varierer etter agenttype.
Nødvendig brukertillatelse
For å konfigurere filopplastinger i en AI-agent: Behandle AI-agenter OG de nødvendige tillatelsene for agenttypen

Før du begynner bør du se gjennom støtten og kravene for å legge til filopplastinger i agenten.

Støtte for Agentforce
Agenttyper

Agentforce Service-agenter, Agentforce Ansatte agenter

Agenter må opprettes i eller oppgraderes til Agent Script og Agentforce Builder i Agentforce Studio.
Kanaler

Forbedret Chat v1, Forbedret Chat v2, Lightning Experience

Mobil støttes for øyeblikket ikke.

I enkelte tredjeparts meldingsklienter (Line, WeChat, WhatsApp) deles flere vedlegg opp i individuelle meldinger og behandles av agenten individuelt.
Modeller

Bare OpenAI GPT 4.1. Azure OpenAI støttes for øyeblikket ikke. Grenser for LLM Multimodal Support gjelder.

HyperClassifier-modellen støtter ikke bilder. Hvis du bruker HyperClassifier-modellen til underagentklassifisering, kan du ikke bruke Agent-ruteren til å arkivere opplastinger eller rute samtaler basert på innholdet i filopplastinger.
Filer

PNG, JPEG, PDF

Filer kan være på opptil 5 MB hver.

En agent kan godta opptil 5 filer per melding (varierer etter kanal) og opptil 10 filer per samtale. Hvis en bruker laster opp mer enn 10 filer, lagrer agenten de siste 10.
  1. Åpne agenten du vil motta filopplastinger, fra Agenter-listen i Agentforce Studio-appen.
  2. Legg eventuelt til file_upload-underblokken i agentens skript og angi modusen du vil at agenten skal bruke til å håndtere filopplastinger.

    Bruk denne agentskriptinnstillingen til å definere hvordan agenten bruker og lagrer opplastede filer. Du kan også bruke denne innstillingen til å slå av filopplastinger for agenten. Hvis du ikke angir en modus og agenten kan motta filopplastinger, brukes automatisk modus som standard.

    1. Hvis du viser agenten i lerretsvisning, bytter du til Skriptvisning.
    2. I agentens config-blokk legger du til file_upload-feltet og angir en mode-verdi. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Tilgjengelige moduser:

      • auto: Filer behandles og lagres i samtalehistorikken. Bruk denne modusen til å la agenten automatisk styre hvordan og når filer brukes.
      • managed: Filer lagres i systemvariabelen uploaded_files (@system_variables.uploaded_files), og du bruker variabelen til å bestemme hvordan filer brukes. Filer lagres ikke i samtalehistorikk. Bruk denne modusen til å eksplisitt styre hvordan filer sendes til LLM, hvilke underagenter som har tilgang til filene, og hvordan filene sendes og brukes av andre handlinger. Hvis du vil gi agenten tilgang til opplastede filer, refererer du direkte til variabelen i underagentinstruksjoner eller tildeler den til handlingsinndata og utdata.
      • disabled: Filopplastinger slås av stille. Se Avbryt filopplastinger for en agent.
      • error: Filopplastinger er slått av, og agenten sender en feilmelding. Se Avbryt filopplastinger for en agent.
  3. Tilpass dine underagenter og handlinger.
    1. Gi agenten instruksjoner om håndtering av filer. For å få best mulig resultat anbefaler vi å opprette en dedikert underagent for håndtering av filopplastinger slik at du kan gi detaljerte instruksjoner og kontrollere underagentruting for forretningssaken. Du kan for eksempel gi unike instruksjoner om hvordan du håndterer PDF-filer kontra bildefiler.
      Merk
      Merk Uten eksplisitte instruksjoner om at agenten kan godta filopplastinger, kan agenten omdirigere samtalen til systemunderagenten Ikke emne når agenten mottar en fil. I en underagent som du vil bruke til filbehandling, ber du minst agenten om å bruke underagenten til å behandle filer.

      Her er et eksempel på Agent-skript for en underagentblokk for fil- og bildeanalyse.

      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 bruker managed-modus, må du forsikre deg om at uploaded_files-systemvariabelen er lagt til i agenten. Hvis du vil gi agenten tilgang til opplastede filer, refererer du til variabelen i agentinstruksjoner, tildeler den til inndata eller utdata for agenthandlinger eller begge deler.
      Hvis du vil vite mer om hvordan du bruker uploaded_files-systemvariabelen, kan du se Agentforce Developer Guide: Systemvariabler. Hvis du vil vite mer om hvordan du arbeider med listevariabler, kan du se Agentforce Developer Guide: Bruke listevariabler.
  4. Lagre endringene.
  5. Hvis du kobler en agent til Forbedret chat:
    1. Slå på fildeling for sluttbrukere på siden Meldinger-innstillinger i Oppsett. Du kan også angi tillatte filtyper og maksimal filstørrelse. Se Tilpasse fildelingsopplevelsen i Forbedret chat.
    2. Kontroller at agentbrukeren har nødvendig tilgang.
      • Systemtillatelser: Intern Chatter, tilgang til samtaleoppføringer
      • Objekttillatelser: Meldingsøkt
      • Objektinnstillinger: Meldingsøkt, Meldingsbruker
      Merk
      Merk Hvis du opprettet en agentbruker da du opprettet agenten, gis agentbrukeren de nødvendige tillatelsene og innstillingene for Meldingsøkt-objektet som standard.
  6. Hvis du kobler agenten til et Experience Cloud-nettsted som tillater gjestebrukere, gir du dem tillatelse til å laste opp filer. Gjestebrukere kan bare laste opp filer til en post når delingsregler for gjestebrukere er på plass.
    1. Skriv inn Salesforce Files i Hurtigsøk-feltet i Oppsett, og velg Generelle innstillinger.
    2. Velg La gjestebrukere på stedet laste opp filer.
  7. Før du distribuerer agenten må du teste agentens filopplastingskonfigurasjon. Start en forhåndsvisningsdiskusjon i Agentforce Builder og send en fil. Filopplastinger kan testes fra ende til slutt.
 
Laster
Salesforce Help | Article