Sie befinden sich hier:
Einrichten von Datei-Uploads für einen Agenten
Fügen Sie Ihrem Agenten Unterstützung für das Hochladen von Dateien hinzu, damit Ihre Benutzer Screenshots, Belege und PDFs freigeben können. Ihr Agent kann einzelne Dateien oder eine Gruppe von Dateien interpretieren, Fragen anhand einer oder mehrerer Dateien beantworten und einem Salesforce-Datensatz Dateien hinzufügen.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise, Performance, Unlimited und Developer Edition. Erforderliche Add-On-Lizenzen variieren je nach Agententyp. |
| Erforderliche Benutzerberechtigungen | |
|---|---|
| Einrichten von Datei-Uploads in einem AI-Agenten: | "AI-Agenten verwalten" UND die erforderlichen Berechtigungen für Ihren Agententyp |
Machen Sie sich zunächst mit der Unterstützung und den Anforderungen für das Hinzufügen von Datei-Uploads zu Ihrem Agenten vertraut.
| Unterstützung für das Hochladen von Agentforce-Dateien | |
|---|---|
| Agententypen | Agentforce Service-Agenten, Agentforce Employee-Agenten Agenten müssen in Agentforce Studio erstellt oder auf Agentenskript und Agentforce Builder aktualisiert werden. |
| Kanäle | Erweiterter Chat v1, Erweiterter Chat v2, Lightning Experience Mobile wird derzeit nicht unterstützt. Bei einigen Drittanbieter-Messaging-Clients (Line, WeChat, WhatsApp) werden mehrere Anhänge in einzelne Nachrichten aufgeteilt und vom Agenten einzeln verarbeitet. |
| Modelle | Nur OpenAI GPT 4.1. Azure OpenAI wird derzeit nicht unterstützt. Es gelten Obergrenzen für die multimodale Unterstützung von LLM. Das HyperClassifier-Modell unterstützt keine Bilder. Wenn Sie das HyperClassifier-Modell für die Subagentenklassifizierung verwenden, können Sie den Agenten-Router nicht verwenden, um Uploads zu erstellen oder Unterhaltungen anhand des Inhalts von Datei-Uploads weiterzuleiten. |
| Dateien | PNG, JPEG, PDF Dateien können jeweils bis zu 5 MB groß sein. Ein Agent kann bis zu 5 Dateien pro Nachricht (variiert je nach Kanal) und bis zu 10 Dateien pro Unterhaltung akzeptieren. Wenn ein Benutzer mehr als 10 Dateien hochlädt, speichert der Agent die neuesten 10. |
- Öffnen Sie in der Agentforce Studio-Anwendung in der Liste "Agenten" den Agenten, der hochgeladen werden soll.
-
Fügen Sie optional dem Skript Ihres Agenten den Unterblock
file_uploadhinzu und geben Sie den Modus an, den Ihr Agent für die Verarbeitung von Datei-Uploads verwenden soll.Verwenden Sie diese Agentenskript-Einstellung, um zu definieren, wie Ihr Agent hochgeladene Dateien verwendet und speichert. Sie können diese Einstellung auch verwenden, um Datei-Uploads für Ihren Agenten zu deaktivieren. Wenn Sie keinen Modus angeben und Ihr Agent Datei-Uploads empfangen kann, wird standardmäßig der automatische Modus angewendet.
- Wenn Sie den Agenten in der Zeichenbereichsansicht anzeigen, wechseln Sie zur Skriptansicht.
-
Fügen Sie im
configIhres Agenten das Feldfile_uploadhinzu und geben Sie einenmodean.config: file_upload: mode: "auto" | "managed" | "disabled" | "error"Verfügbare Modi:
auto: Dateien werden verarbeitet und im Unterhaltungsverlauf gespeichert. Verwenden Sie diesen Modus, damit der Agent automatisch verwalten kann, wie und wann Dateien verwendet werden.managed: Dateien werden in der Systemvariablen uploaded_files (@system_variables.uploaded_files) gespeichert und Sie verwenden die Variable, um zu steuern, wie Dateien verwendet werden. Dateien werden nicht im Unterhaltungsverlauf gespeichert. Verwenden Sie diesen Modus, um explizit zu verwalten, wie Dateien an das LLM gesendet werden, welche Unteragenten auf die Dateien zugreifen können und wie die Dateien gesendet und von anderen Aktionen verwendet werden. Wenn Sie dem Agenten Zugriff auf hochgeladene Dateien erteilen möchten, verweisen Sie direkt in Unteragentenanweisungen auf die Variable oder weisen Sie sie Aktionseingaben und -ausgaben zu.disabled: Datei-Uploads werden stillschweigend deaktiviert. Entsprechende Informationen finden Sie unter Deaktivieren von Datei-Uploads für einen Agenten.error: Datei-Uploads werden deaktiviert und der Agent sendet eine Fehlermeldung. Entsprechende Informationen finden Sie unter Deaktivieren von Datei-Uploads für einen Agenten.
-
Passen Sie Ihre Unteragenten und Aktionen an.
-
Erteilen Sie Ihrem Agenten Anweisungen zur Dateiverarbeitung. Für optimale Ergebnisse sollten Sie einen speziellen Unteragenten für die Verarbeitung von Datei-Uploads erstellen, damit Sie detaillierte Anweisungen bereitstellen und die Weiterleitung von Unteragenten für Ihren Geschäftsfall steuern können. Beispielsweise können Sie eindeutige Anweisungen für die Handhabung von PDF-Dateien im Vergleich zu Bilddateien bereitstellen.
Hinweis Ohne explizite Anweisungen, dass Ihr Agent Datei-Uploads akzeptieren kann, kann Ihr Agent die Unterhaltung an den Systemunteragenten "Off Topic" umleiten, wenn Ihr Agent eine Datei erhält. Weisen Sie Ihren Agenten mindestens in einem Unteragenten, den Sie für die Dateiverarbeitung verwenden möchten, an, den Unteragenten zum Verarbeiten von Dateien zu verwenden.Im Folgenden finden Sie ein Beispiel für ein Agentenskript für einen Unteragentenblock für die Datei- und Bildanalyse.
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. -
Wenn Sie den
managedverwenden, stellen Sie sicher, dass Ihrem Agenten die Systemvariableuploaded_fileshinzugefügt wurde. Wenn Sie Ihrem Agenten Zugriff auf hochgeladene Dateien erteilen möchten, verweisen Sie in Agentenanweisungen auf die Variable, weisen Sie sie Agentenaktioneningaben oder -ausgaben zu oder beidem.Weitere Informationen zur Verwendung der Systemvariablenuploaded_filesfinden Sie im Agentforce Developer Guide: Systemvariablen. Weitere Informationen zum Arbeiten mit Listenvariablen finden Sie im Agentforce Developer Guide: Verwenden von Listenvariablen.
-
Erteilen Sie Ihrem Agenten Anweisungen zur Dateiverarbeitung. Für optimale Ergebnisse sollten Sie einen speziellen Unteragenten für die Verarbeitung von Datei-Uploads erstellen, damit Sie detaillierte Anweisungen bereitstellen und die Weiterleitung von Unteragenten für Ihren Geschäftsfall steuern können. Beispielsweise können Sie eindeutige Anweisungen für die Handhabung von PDF-Dateien im Vergleich zu Bilddateien bereitstellen.
- Speichern Sie Ihre Änderungen.
-
Wenn Sie einen Agenten mit dem erweiterten Chat verbinden:
- Aktivieren Sie unter "Setup" auf der Seite "Messaging-Einstellungen" die Dateifreigabe für Endbenutzer. Sie können auch zulässige Dateitypen und die maximale Dateigröße angeben. Entsprechende Informationen finden Sie unter Anpassen der Dateifreigabeerfahrung im erweiterten Chat.
-
Stellen Sie sicher, dass Ihr Agentenbenutzer über den erforderlichen Zugriff verfügt.
- Systemberechtigungen: Interner Chatter-Benutzer, Zugriff auf Unterhaltungseinträge
- Objektberechtigungen: Messaging-Sitzung
- Objekteinstellungen: Messaging-Sitzung, Messaging-Benutzer
Hinweis Wenn Sie beim Erstellen Ihres Agenten einen Agentenbenutzer erstellt haben, erhalten Ihre Agentenbenutzer standardmäßig die erforderlichen Objektberechtigungen und Einstellungen für Messaging-Sitzungen.
-
Wenn Sie Ihren Agenten mit einer Experience Cloud-Site verbinden, die Gastbenutzern das Hochladen von Dateien ermöglicht, erteilen Sie ihnen die Berechtigung. Gastbenutzer können Dateien nur dann in einen Datensatz hochladen, wenn Freigaberegeln für Gastbenutzer vorhanden sind.
- Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Salesforce Files ein und wählen Sie Allgemeine Einstellungen aus.
- Wählen Sie Site-Gastbenutzern das Hochladen von Dateien erlauben aus.
- Testen Sie vor dem Bereitstellen Ihres Agenten die Datei-Upload-Konfiguration Ihres Agenten. Starten Sie eine Vorschauunterhaltung im Agentforce Builder und senden Sie eine Datei. Datei-Uploads können durchgängig getestet werden.
- Deaktivieren von Datei-Uploads für einen Agenten
Wenn Sie nicht mehr möchten, dass Ihr Agent Dateien empfangen kann, deaktivieren Sie die Funktionen zum Hochladen von Dateien auf Agentenebene. - Beispiel: Anzeigen hochgeladener Dateien in der Agentforce-Sitzungsverfolgung
Verwenden Sie dieses Beispielskript, um die während einer Agentenunterhaltung hochgeladenen Datenbestände mit der Sitzung im Agentforce Session Tracing (STDM) zu verbinden.
