Loading
Agentforce och Einstein Generativ AI
Konfigurera filuppladdningar för en agent

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Snabbstarta din Einstein Generative AI-lösning

Konfigurera filuppladdningar för en agent

Lägg till stöd för filuppladdning till din agent så att dina användare kan dela skärmbilder, kvitton och PDF-filer. Din agent kan tolka enskilda filer eller en grupp av filer, svara på frågor baserade på en eller flera filer och lägga till filer i en Salesforce-post.

Versioner som krävs

Tillgängliga i: Lightning Experience
Tillgängliga i: Utgåvorna Enterprise, Performance, Unlimited och Developer. Obligatoriska tilläggslicenser varierar beroende på agenttyp.
Användarbehörigheter som krävs
Konfigurera filuppladdningar i en AI-agent: Hantera AI-agenter OCH de behörigheter som behövs för din agenttyp

Innan du börjar, gå igenom supporten och kraven för att lägga till filuppladdningar till din agent.

Stöd för Agentforce filuppladdning
Agenttyper

Agentforce Service-agenter, Agentforce Medarbetare-agenter

Agenter måste skapas i eller uppgraderas till Agentskript och Agentforce Builder i Agentforce Studio.
Channels

Utökad chatt v1, Utökad chatt v2, Lightning Experience

Mobil stöds för närvarande inte.

På vissa meddelandeklienter från tredje part (Line, WeChat, WhatsApp) delas flera bilagor upp i individuella meddelanden och bearbetas av agenten individuellt.
Modeller

Endast OpenAI GPT 4.1. Azure OpenAI stöds för närvarande inte. LLM Multimodal support-gränser gäller.

Modellen HyperClassifier har inte stöd för bilder. Om du använder HyperClassifier-modellen för underagentklassificering går det inte att använda Agentroutern för att ladda upp filer eller dirigera konversationer baserat på innehållet i filuppladdningar.
Filer

PNG, JPEG, PDF

Filer kan vara upp till 5 MB vardera.

En agent kan acceptera upp till 5 filer per meddelande (varierar beroende på kanal) och upp till 10 filer per konversation. Om en användare laddar upp fler än 10 filer sparar agenten de senaste 10.
  1. Från listan Agenter i Agentforce Studio-appen, öppna den agent du vill ska kunna ta emot filuppladdningar.
  2. Om du vill kan du lägga till underblocket file_upload i din agents skript och specificera det läge du vill att din agent ska använda för att hantera filuppladdningar.

    Använd denna inställning för Agentskript för att definiera hur din agent använder och lagrar uppladdade filer. Du kan även använda denna inställning för att stänga av filuppladdningar för din agent. Om du inte specificerar ett läge och din agent kan ta emot filuppladdningar gäller automatiskt läge som standard.

    1. Om du visar agenten i arbetsytevyn, växla till Skriptvy.
    2. I din agents config, lägg till fältet file_upload och specificera ett mode. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Tillgängliga lägen:

      • auto—Filer bearbetas och sparas i konversationshistoriken. Använd detta läge för att låta agenten automatiskt hantera hur och när filer används.
      • managed—Filer lagras i systemvariabeln uploaded_files (@system_variables.uploaded_files) och du använder variabeln för att styra hur filer används. Filer sparas inte i konversationshistorik. Använd detta läge för att uttryckligen hantera hur filer skickas till LLM, vilka underagenter som kan komma åt filerna och hur filerna skickas och används av andra åtgärder. För att ge agenten åtkomst till uppladdade filer, referera variabeln direkt i underagentinstruktioner eller tilldela den till åtgärdsinmatningar och utmatningar.
      • disabled—Filuppladdningar stängs av tyst. Se Stäng av filuppladdningar för en agent.
      • error—Filuppladdningar stängs av och agenten skickar ett felmeddelande. Se Stäng av filuppladdningar för en agent.
  3. Anpassa dina underagenter och åtgärder.
    1. Ge din agent instruktioner för filhantering. För bästa resultat rekommenderar vi att skapa en dedikerad underagent för hantering av filuppladdningar, så att du kan ge detaljerade instruktioner och styra dirigering av underagenter för ditt verksamhetsfall. Du kanske till exempel vill ge unika instruktioner för att hantera PDF-filer jämfört med bildfiler.
      Anteckning
      Anteckning Utan uttryckliga instruktioner om att din agent kan acceptera filuppladdningar kan din agent omdirigera konversationen till systemunderagenten Off Topic när din agent tar emot en fil. I en underagent som du vill använda för filhantering, be din agent att använda underagenten för att bearbeta filer.

      Här är ett exempel på Agentskript för ett underagentblock för fil- och bildanalys.

      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. Om du använder managed, se till att uploaded_files läggs till i din agent. För att ge din agent åtkomst till uppladdade filer, referera variabeln i agentinstruktioner, tilldela den till agentåtgärdens indata eller utdata, eller båda.
      Mer information om att använda systemvariabeln uploaded_files finns i Agentforce Developer Guide: Systemvariabler. Mer information om att arbeta med listvariabler finns i Agentforce Developer Guide: Använda listvariabler.
  4. Spara dina ändringar.
  5. Om du ansluter en agent till Utökad chatt:
    1. Från sidan Meddelandeinställningar i Inställningar, slå på fildelning för slutanvändare. Du kan även specificera tillåtna filtyper och maximal filstorlek. Se Anpassa fildelningsupplevelsen i utökad chatt.
    2. Se till att din agentanvändare har obligatorisk åtkomst.
      • Systembehörigheter: Chatter intern användare, få åtkomst till konversationsposter
      • Objektbehörigheter: Meddelandesession
      • Objektinställningar: Meddelandesession, Meddelande användare
      Anteckning
      Anteckning Om du skapade en agentanvändare när du skapade din agent beviljas din agentanvändare de objektbehörigheter och inställningar för meddelandesession som behövs som standard.
  6. Om du ansluter din agent till en Experience Cloud-webbplats som tillåter gästanvändare, ge dem behörighet att ladda upp filer. Gästanvändare kan endast ladda upp filer till en post när delningsregler för gästanvändare finns.
    1. I Inställningar, i rutan Snabbsökning, skriv Salesforce Files och välj Allmänna inställningar.
    2. Välj Låt webbplatsgästanvändare ladda upp filer.
  7. Innan du distribuerar din agent, testa din agents filuppladdningskonfiguration. Starta en förhandsvisningskonversation i Agentforce Builder och skicka en fil. Filuppladdningar kan testas från början till slut.
 
Laddar
Salesforce Help | Article