Loading
Agentforce en Einstein Generatieve AI
Bestandsuploads instellen voor een agent

U bent hier:

  1. Help van Salesforce
  2. Documenten
  3. Snelstart voor uw Einstein Generative AI-oplossing

Bestandsuploads instellen voor een agent

Voeg ondersteuning voor het uploaden van bestanden toe aan uw agent, zodat uw gebruikers screenshots, ontvangstbewijzen en PDF-bestanden kunnen delen. Uw agent kan afzonderlijke bestanden of een groep bestanden interpreteren, vragen beantwoorden op basis van een of meer bestanden en bestanden toevoegen aan een Salesforce-record.

Vereiste editions

Beschikbaar in: Lightning Experience
Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition. Vereiste uitbreidingslicenties variëren per type agent.
Vereiste gebruikersmachtigingen
Bestandsuploads instellen in een AI-agent: AI-agenten beheren EN de vereiste machtigingen voor uw agenttype

Neem voordat u begint de ondersteuning en vereisten door voor het toevoegen van bestandsuploads aan uw agent.

Ondersteuning voor uploaden van Agentforce
Agenttypen

Agentforce Service-agenten, Agentforce Medewerker-agenten

Agenten moeten zijn gemaakt in of een upgrade hebben uitgevoerd naar Agent Script en Agentforce Builder in Agentforce Studio.
Kanalen

Uitgebreide chat v1, Uitgebreide chat v2, Lightning Experience

Mobiel wordt momenteel niet ondersteund.

Op sommige berichtenverkeersclients van derden (Line, WeChat, WhatsApp) worden meerdere bijlagen opgesplitst in afzonderlijke berichten en worden ze door de agent afzonderlijk verwerkt.
Modellen

Alleen OpenAI GPT 4.1. Azure OpenAI wordt momenteel niet ondersteund. LLM Multimodal Support-limieten zijn van toepassing.

Het HyperClassifier-model ondersteunt geen afbeeldingen. Als u het HyperClassifier-model gebruikt voor subagentclassificatie, kunt u de Agent-router niet gebruiken voor bestandsuploads of het routeren van gesprekken op basis van de inhoud van bestandsuploads.
Bestanden

PNG, JPEG, PDF

Bestanden kunnen elk maximaal 5 MB groot zijn.

Een agent kan maximaal 5 bestanden per bericht accepteren (varieert per kanaal) en maximaal 10 bestanden per gesprek. Als een gebruiker meer dan 10 bestanden uploadt, slaat de agent de recentste 10 bestanden op.
  1. Open vanuit de lijst Agenten in de Agentforce Studio-app de agent die u bestandsuploads wilt laten ontvangen.
  2. Voeg optioneel het subblok file_upload toe aan het script van uw agent en geef de modus op die uw agent moet gebruiken voor het afhandelen van bestandsuploads.

    Gebruik deze instelling Agentscript om te definiëren hoe uw agent geüploade bestanden gebruikt en opslaat. U kunt deze instelling ook gebruiken om bestandsuploads uit te schakelen voor uw agent. Als u geen modus opgeeft en uw agent bestandsuploads kan ontvangen, is de automatische modus standaard van toepassing.

    1. Als u de agent weergeeft in de doekweergave, schakelt u over naar de scriptweergave.
    2. Voeg in het config van uw agent het veld file_upload toe en geef een mode op. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Beschikbare modi:

      • auto—Bestanden worden verwerkt en opgeslagen in de gesprekshistorie. Gebruik deze modus om de agent automatisch te laten beheren hoe en wanneer bestanden worden gebruikt.
      • managed—Bestanden worden opgeslagen in de systeemvariabele uploaded_files (@system_variables.uploaded_files) en u gebruikt de variabele om te bepalen hoe bestanden worden gebruikt. Bestanden worden niet opgeslagen in de gesprekshistorie. Gebruik deze modus om expliciet te beheren hoe bestanden naar de LLM worden verzonden, welke subagenten toegang tot de bestanden hebben en hoe de bestanden worden verzonden en gebruikt door andere acties. Als u de agent toegang wilt geven tot geüploade bestanden, verwijst u rechtstreeks naar de variabele in subagentinstructies of wijst u deze toe aan actie-invoer en -uitvoer.
      • disabled—Bestandsuploads worden stil uitgeschakeld. Zie Bestandsuploads uitschakelen voor een agent.
      • error—Bestandsuploads zijn uitgeschakeld en de agent verzendt een foutbericht. Zie Bestandsuploads uitschakelen voor een agent.
  3. Pas uw subagenten en acties aan.
    1. Geef uw agent instructies voor het afhandelen van bestanden. Voor de beste resultaten wordt aangeraden om een speciale subagent te maken voor het afhandelen van bestandsuploads, zodat u gedetailleerde instructies kunt geven en de routering van subagenten voor uw bedrijfscase kunt bepalen. Zo wilt u wellicht unieke instructies geven voor de omgang met PDF-bestanden versus afbeeldingsbestanden.
      Opmerking
      Opmerking Zonder expliciete instructies dat uw agent bestandsuploads kan accepteren, kan uw agent het gesprek omleiden naar de systeemsubagent Off-onderwerp. Geef in een subagent die u wilt gebruiken voor bestandsafhandeling ten minste aan dat uw agent de subagent moet gebruiken om bestanden te verwerken.

      Hier is een voorbeeld van Agentscript voor een subagentblok Bestands- en afbeeldingsanalyse.

      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. Als u de managed gebruikt, zorgt u ervoor dat de variabele van het uploaded_files is toegevoegd aan uw agent. Als u uw agent toegang wilt geven tot geüploade bestanden, verwijst u naar de variabele in agentinstructies, wijst u deze toe aan invoer of uitvoer van agentacties, of beide.
  4. Sla uw wijzigingen op.
  5. Als u een agent verbindt met Uitgebreide chat:
    1. Schakel vanaf de pagina Berichtenverkeersinstellingen in Set-up het delen van bestanden voor eindgebruikers in. U kunt ook toegestane bestandstypen en maximale bestandsgrootte opgeven. Zie De omgeving voor het delen van bestanden aanpassen in Uitgebreide chat.
    2. Zorg ervoor dat uw agentgebruiker de vereiste toegang heeft.
      • Systeemmachtigingen: Chatter Interne gebruiker, Toegang tot gespreksitems
      • Objectmachtigingen: Berichtenverkeerssessie
      • Objectinstellingen: Berichtenverkeerssessie, Gebruiker van berichtenverkeer
      Opmerking
      Opmerking Als u een agentgebruiker hebt gemaakt toen u uw agent maakte, krijgt uw agentgebruiker standaard de vereiste machtigingen en instellingen voor het object Berichtenverkeerssessie.
  6. Als u uw agent verbindt met een Experience Cloud-site die gastgebruikers toestaat, geeft u ze de machtiging om bestanden te uploaden. Gastgebruikers kunnen alleen bestanden uploaden naar een record wanneer regels voor delen voor gastgebruikers gelden.
    1. Geef vanuit Set-up Salesforce Files op in het vak Snel zoeken en selecteer vervolgens Algemene instellingen.
    2. Selecteer Gastgebruikers van site bestanden laten uploaden.
  7. Test voordat u uw agent implementeert de configuratie voor het uploaden van bestanden van uw agent. Start een voorbeeldgesprek in Agentforce Builder en verzend een bestand. Bestandsuploads kunnen van begin tot eind worden getest.
 
Wordt geladen
Salesforce Help | Article