Loading
Agentforce ja Einstein Generative AI
Tiedostojen latausten määrittäminen agentille

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Einstein Generative AI -ratkaisusi pika-aloitus

Tiedostojen latausten määrittäminen agentille

Lisää tiedostojen lataustukea agentillesi, jotta käyttäjäsi voivat jakaa ruutukaappauksia, kuittauksia ja PDF-tiedostoja. Agenttisi voi tulkita yksittäisiä tiedostoja tai tiedostojen ryhmää, vastata kysymyksiin yhden tai useamman tiedoston perusteella ja lisätä tiedostoja Salesforce-tietueeseen.

Vaaditut versiot

Käytettävissä: Lightning Experiencessa
Käytettävissä: Enterprise Edition-, Performance Edition-, Unlimited Edition- ja Developer Edition -versioissa. Pakolliset lisäosalisenssit vaihtelevat agentin tyypin mukaan.
Tarvittavat käyttöoikeudet
Tiedostojen latausten määrittäminen tekoälyagenteille: AI-agenttien hallintaoikeus JA agenttityyppisi vaaditut käyttöoikeudet

Ennen kuin aloitat, tutustu tukeen ja vaatimuksiin, jotka koskevat tiedostojen lataamista palvelimelle agentillesi.

Agentforce latauksen tuki
Agenttien tyypit

Agentforce Service -agentit, Agentforce Employee -agentit

Agentit täytyy luoda tai päivittää Agent Script- ja Agentforce Builder -komentosarjoihin Agentforce Studiossa.
Kanavat

Parannettu Chat-versio 1, Parannettu Chat-versio 2, Lightning Experience

Mobiililaitetta ei tueta tällä hetkellä.

Joissakin kolmannen osapuolen viestintäasiakkaissa (Line, WeChat, WhatsApp) useat liitetiedostot jaetaan yksittäisiin viesteihin ja agentti käsittelee ne erikseen.
Mallit

Vain OpenAI GPT 4.1. Azure OpenAI ei ole tällä hetkellä tuettu. LLM Multimodal -tuen rajoitukset ovat voimassa.

HyperClassifier-malli ei tue kuvia. Jos käytät alitason agenttien luokitteluun HyperClassifier-mallia, et voi käyttää agenttien reititystä tiedostojen lataamiseen tai keskusteluiden reitittämiseen tiedostojen latausten sisällön perusteella.
Tiedostot

PNG, JPEG, PDF

Tiedostot voivat olla enintään 5 Mt.

Agentti voi hyväksyä enintään 5 tiedostoa per viesti (vaihtelee kanavan mukaan) ja enintään 10 tiedostoa per keskustelu. Jos käyttäjä lataa palvelimelle yli 10 tiedostoa, agentti tallentaa 10 viimeisintä tiedostoa.
  1. Avaa Agentforce Studio -sovelluksen Agentit-luettelosta agentti, jolle haluat lähettää tiedostoja palvelimelle.
  2. Lisää halutessasi agenttiesi komentosarjaan file_upload-alataso ja määritä tila, jota haluat agenttisi käyttävän tiedostojen palvelimelle lataamiseen.

    Käytä tätä Agent Script -asetusta määrittääksesi, miten agenttisi käyttää ja tallentaa palvelimelle ladattuja tiedostoja. Voit käyttää tätä asetusta myös poistaaksesi tiedostojen lataukset agentiltasi käytöstä. Jos et määritä tilaa ja agenttisi voi vastaanottaa tiedostoja palvelimelle, automaattinen tila on oletusarvoisesti käytössä.

    1. Jos tarkastelet agenttia esitysalueen näkymässä, siirry Komentosarja-näkymään.
    2. Lisää agenttisi config-lohkoon file_upload-kenttä ja määritä mode-arvo. 
      config:
    file_upload:
        mode: "auto" | "managed" | "disabled" | "error"

      Käytettävissä olevat tilat:

      • auto — Tiedostot käsitellään ja tallennetaan keskusteluhistoriaan. Käytä tätä tilaa salliaksesi agentin hallita automaattisesti, miten ja milloin tiedostoja käytetään.
      • managed — Tiedostot tallennetaan järjestelmämuuttujaan uploaded_files (@system_variables.uploaded_files) ja käytät muuttujaa hallitaksesi tiedostojen käyttötapoja. Tiedostoja ei tallenneta keskusteluhistoriaan. Käytä tätä tilaa hallitaksesi tarkalleen, miten tiedostoja lähetetään LLM-organisaatioon, ketkä agenteista voivat käyttää tiedostoja ja miten tiedostoja lähetetään ja käytetään muissa toiminnoissa. Jos haluat sallia agentin käyttää palvelimelle ladattuja tiedostoja, viittaa muuttujaan suoraan alitason agenttien ohjeissa tai kohdista se toimintojen input- ja output-arvoihin.
      • disabled — Tiedostojen lataaminen palvelimelle poistetaan käytöstä hiljaa. Lisätietoja on kohdassa Agenttien tiedostojen latausten poistaminen käytöstä.
      • error — Tiedostojen lataaminen palvelimelle poistetaan käytöstä ja agentti lähettää virheviestin. Lisätietoja on kohdassa Agenttien tiedostojen latausten poistaminen käytöstä.
  3. Mukauta alaisia agenttejasi ja toimintojasi.
    1. Anna agenteillesi ohjeita tiedostojen käsittelyyn. Suosittelemme luomaan tiedostojen palvelimelle lataamiseen tarkoitetun alaagentin parhaiden tulosten aikaansaamiseksi, jotta voit tarjota yksityiskohtaisia ohjeita ja hallita alaagenttien reititystä yrityksesi tapaukselle. Saatat esimerkiksi haluta tarjota yksilöllisiä ohjeita PDF-tiedostojen ja kuvatiedostojen käsittelyyn.
      Huomautus
      Huomautus Kun agenttisi vastaanottaa tiedoston, hän voi ohjata keskustelun Järjestelmäagentin poissa-agentille ilman erillisiä ohjeita, joiden mukaan agenttisi voi hyväksyä tiedostojen lataukset palvelimelle. Pyydä agenttiasi käsittelemään tiedostoja vähintään alitason agentilla, jota haluat käyttää tiedostojen käsittelyyn.

      Alla on esimerkki agenttikomentosarjasta tiedosto- ja kuvanalyysin alitason agenttilohkolle.

      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. Jos käytät managed-tilaa, varmista, että agentillesi on lisätty järjestelmämuuttuja uploaded_files. Jos haluat sallia agenttiesi käyttää palvelimelle ladattuja tiedostoja, viittaa muuttujaan agentin ohjeissa, kohdista se agentin toimintojen input-arvoihin tai output-arvoihin tai molempiin.
      Lisätietoja uploaded_files-järjestelmämuuttujan käyttämisestä on kohdassa Agentforce Developer Guide: Järjestelmämuuttujat. Lisätietoja luettelomuuttujien käyttämisestä on kohdassa Agentforce Developer Guide: Luettelomuuttujien käyttäminen.
  4. Tallenna muutokset.
  5. Jos yhdistät agenttia parannettuun chattiin:
    1. Ota tiedostojen jakaminen käyttöön loppukäyttäjille Määritykset-valikon Messaging-asetukset-sivulta. Voit myös määrittää sallitut tiedostotyypit ja tiedoston enimmäiskoko. Lisätietoja on kohdassa Tiedostojen jakokokemuksen mukauttaminen parannetussa chatissa.
    2. Varmista, että agenttikäyttäjälläsi on vaaditut käyttöoikeudet.
      • Järjestelmäoikeudet: Sisäinen Chatter, Käytä keskustelumerkintöjä
      • Objektien käyttöoikeudet: Viestintäistunto
      • Objektiasetukset: Viestintäistunto, Viestintäkäyttäjä
      Huomautus
      Huomautus Jos loit agenttikäyttäjän luodessasi agenttiasi, agenttikäyttäjällesi myönnetään oletusarvoisesti vaaditut Messaging-istunto-objektin käyttöoikeudet ja asetukset.
  6. Jos olet yhdistämässä agenttiasi Experience Cloud -sivustoon, joka sallii vieraskäyttäjät, myönnä hänelle tiedostojen latausoikeus. Vieraskäyttäjät voivat ladata tiedostoja tietueeseen vain, kun vieraskäyttäjien jakosäännöt ovat käytössä.
    1. Kirjoita Määritykset-valikon Pikahaku-kenttään Salesforce Files ja valitse Yleiset asetukset.
    2. Valitse Salli sivuston vieraskäyttäjien ladata tiedostoja palvelimelle.
  7. Ennen kuin otat agenttisi käyttöön, testaa agenttisi tiedostojen latauskokoonpanoa. Aloita keskustelun esikatselu Agentforce Builderissa ja lähetä tiedosto. Tiedostojen latauksia voidaan testata loppuun asti.
 
Ladataan
Salesforce Help | Article