Fehlerbehebung im Eingabeaufforderungsgenerator

Meine Vorschau oder mein Test schlägt mit einem Fehler fehl.

Wenn Sie auf Vorschau klicken und ein Fehler wie Internal Server Error angezeigt wird, überprüfen Sie diese Elemente, bevor Sie sich an den Salesforce-Kundensupport wenden.

• Überprüfen Sie, ob der Eingabeaufforderungsgenerator in Ihrer Salesforce-Edition und Ihren Add-Ons enthalten ist. Unterstützte Editionen werden oben auf dieser Seite angezeigt.
• Überprüfen Sie, ob Einstein aktiviert ist. Geben Sie unter "Setup" im Feld "Schnellsuche" den Text Einstein Setup ein und wählen Sie dann Einstein Setup aus. Weitere Informationen zum Aktivieren des Eingabeaufforderungsgenerators.
• Stellen Sie sicher, dass Ihnen der Berechtigungssatz "Aufforderungsvorlagenmanager" oder "Aufforderungsvorlagenbenutzer" zugewiesen ist und dass der Berechtigungssatz "Aufforderungsvorlagen ausführen" enthält. Weitere Informationen zum Aktivieren des Eingabeaufforderungsgenerators.
• Wenn Sie Einstein, Lizenzen und Berechtigungen überprüft haben und der Fehler weiterhin auftritt, warten Sie einige Minuten und versuchen Sie es erneut. Das Problem ist oft eine vorübergehende Serviceunterbrechung. Überprüfen Sie Salesforce Trust, bevor Sie einen Support-Kundenvorgang erstellen.

Meine Aufforderungsvorlage funktioniert in der Vorschau, schlägt jedoch fehl, wenn sie in einem Agenten verwendet wird.

Eine Eingabeaufforderungsvorlage kann eine Antwort im Eingabeaufforderungsgenerator generieren und schlägt dennoch fehl, wenn dieselbe Vorlage über Agentforce Builder aufgerufen oder in einer Agentenunterhaltung ausgeführt wird. Der Agent kann andere Eingabewerte übergeben als die, die Sie in der Vorschau ausgewählt haben.

• Wenn die Vorlage einen Abrufer verwendet, überprüfen Sie, ob die Datenquelle des Abrufers aktiv ist und ob der Abrufer Ergebnisse selbst zurückgibt. Erfahren Sie mehr über einzelne Abrufer.
• Wenn Sie die Vorlage mit einer Agentforce-Datenbibliothek oder unstrukturierten Dateien verbinden, überprüfen Sie, ob die Indizierung abgeschlossen ist. Weitere Informationen zur Fehlerbehebung in der Agentforce Data Library finden Sie hier.
• Zeigen Sie die Vorlage erneut mit denselben Eingabewerten an, die der Agent zur Laufzeit übergeben hat. Weitere Informationen zur Vorschau einer generierten Antwort finden Sie hier.

Wenn die Einstein Trust Layer aktiviert ist, fehlen in meiner strukturierten Antwort Felder oder sind leer.

Wenn die Einstein Trust Layer aktiviert ist und Sie strukturierte Ausgaben zum Generieren einer JSON-Antwort verwenden, können einige Felder leer oder null zurückgegeben werden. Die Einstein Trust Layer maskiert persönliche Informationen wie Namen oder E-Mail-Adressen, bevor die Aufforderung an das AI-Modell gesendet wird. Wenn ein Feld nach dem Zurückgeben der Antwort nicht wiederhergestellt wird, kann es leer angezeigt werden.

Öffnen Sie im Abschnitt "Antwort" die Option Maskierungsdetails und notieren Sie sich, welche Felder maskiert wurden und ob sie personenbezogene Daten enthalten. Maskierte persönliche Daten sind die häufigste Ursache. Weitere Informationen zu strukturierten Ausgaben. Informationen zum Überprüfen der Maskierungseinstellungen finden Sie unter Einstein Trust Layer Settings.

Meine Aufforderungsvorlage verwendet nicht den Datenzugriff des aktuellen Benutzers.

Wenn eine Vorlage Daten zurückgibt, die einem Benutzer nicht angezeigt werden sollen, oder Daten auslässt, die ihm angezeigt werden sollen, fügen Sie eine Apex- oder Flow-Aktion hinzu, die Datensätze filtert, bevor diese Daten in der Aufforderungsvorlage gespeichert werden. Weitere Informationen zum Hinzufügen einer Aktion finden Sie hier.

Meine Datei ist zu groß, um sie für die Kontextbildung zu verwenden.

Die für die Kontextbildung verwendeten Dateien sind auf 15 MB pro Anforderung begrenzt und die meisten Modelle unterstützen mindestens einen Dateityp. Wenn Ihre Datei die Obergrenze überschreitet, teilen Sie sie in kleinere Dateien auf oder fassen Sie den Inhalt zusammen, bevor Sie ihn als Erdungsquelle hochladen. Nicht unterstützte Dateien werden aus der Anforderung ausgeschlossen und im Bereich "Lösung" aufgeführt. Weitere Informationen zu den Obergrenzen für Eingabeaufforderungsgeneratoren. Weitere Informationen zur Kontextbildung mit Dateieingaben.

Das Feld "Objekt" fehlt.

Ob das Feld Objekt angezeigt wird, hängt vom Eingabeaufforderungsvorlagentyp ab.

• Wählen Sie für eine Feldgenerierungsvorlage beim Erstellen der Vorlage ein Objekt und ein Objektfeld aus, bevor Sie die Arbeitsumgebung öffnen. Weitere Informationen zum Erstellen einer Eingabeaufforderungsvorlage für die Feldgenerierung finden Sie hier.
• Bei einer Flex-Vorlage sind Objektressourcen optional. Fügen Sie sie später auf der Registerkarte "Ressourcen" hinzu. Das Feld Objekt wird auf dem Bildschirm für die anfängliche Einrichtung nicht angezeigt. Weitere Informationen zum Erstellen einer Flex-Aufforderungsvorlage finden Sie hier.

Wenn Sie erwartet haben, dass Objekt sofort angezeigt wird, bestätigen Sie, welchen Vorlagentyp Sie erstellen.

Ich erhalte inkonsistente Ergebnisse aus derselben Aufforderungsvorlage.

Aufforderungsvorlagen verwenden ein großes Sprachmodell (LLM). AI-Modelle geben nicht immer dieselbe Antwort für dieselben Eingaben zurück. Daher können die Ergebnisse je nach Ausführung variieren. Vorlagen, die Abrufer für Aufgaben im Klassifizierungsstil verwenden, können eine Antwort auch nicht als gültige JSON analysieren.

• Zeigen Sie dieselben Eingaben mehrmals in der Vorschau an, um festzustellen, ob das Problem intermittierend ist. Weitere Informationen zur Vorschau einer generierten Antwort finden Sie hier.
• Legen Sie Anweisungen spezifisch fest und fügen Sie eine explizite Verarbeitung für leere oder unerwartete Werte hinzu. Weitere Informationen zum Eingrenzen einer Aufforderungsvorlage finden Sie hier.
• Wiederholen Sie dasselbe Briefvorlagenfeld nicht mehrfach. Wiederholte Briefvorlagenfelder können zu inkonsistenten Ergebnissen führen. Erfahren Sie mehr über das Organisieren komplexer Eingabeaufforderungen.
• Wenn Fehler häufig auftreten, beispielsweise bei etwa jeder zweiten Ausführung, erstellen Sie einen Support-Kundenvorgang und fügen Sie Beispieleingaben hinzu.

Beim Auflösen von Datenanbietern wird ein Fehler angezeigt.

Wenn ein Fehler wie Error occurred while resolving data providers; cannot describe data provider angezeigt wird, fehlt eine Aktion auf der Registerkarte "Ressourcen", ist falsch konfiguriert oder nicht verfügbar. Im Eingabeaufforderungsgenerator werden diese Ressourcen als Aktionen bezeichnet. Dazu zählen Flow-, Apex- und Abrufaktionen.

• Öffnen Sie die Registerkarte "Ressourcen" und überprüfen Sie jede Aktion. Überprüfen Sie, ob der referenzierte Flow, die Apex-Klasse oder der Abrufer noch vorhanden ist und ob Sie darauf zugreifen können. Weitere Informationen zum Hinzufügen einer Aktion finden Sie hier.
• Wenn Sie einen Flow oder eine Klasse kürzlich umbenannt, gelöscht oder deaktiviert haben, aktualisieren oder ersetzen Sie die Aktion in der Aufforderungsvorlage und speichern Sie sie erneut und zeigen Sie eine Vorschau an.

Ich kann eine Eingabe nicht löschen.

Eine Eingabe, auf die noch von einer Aktion verwiesen wird, kann nicht gelöscht werden. Entfernen oder aktualisieren Sie auf der Registerkarte "Ressourcen" die Flow-, Apex- oder Retriever-Aktion, die die Eingabe verwendet. Löschen Sie dann die Eingabe. Weitere Informationen zum Hinzufügen einer Eingabe.

Meine Ressourcen oder Flows fehlen nach dem Speichern und Aktivieren.

Bestätigen Sie nach dem Speichern und Aktivieren, dass Sie die Version anzeigen, die Ihre Ressourcen enthält. Durch das Aktivieren einer Vorlagenversion wird diese Version unveränderlich, sodass sie nicht bearbeitet werden kann.

• Aktualisieren Sie die Seite und verwenden Sie dann das Dropdown-Menü Version oben in der Arbeitsumgebung für Aufforderungsvorlagen, um die soeben aktivierte Version zu öffnen. Weitere Informationen zur Verwendung mehrerer Versionen.
• Bestätigen Sie, dass die Ressourcen in der jetzt aktiven Version gespeichert wurden. Wenn Sie nach der Aktivierung eine Flow- oder Apex-Aktion hinzugefügt haben, speichern Sie die Arbeit als neue Version und aktivieren Sie diese Version. Weitere Informationen zum Aktivieren und Deaktivieren von Aufforderungsvorlagen finden Sie hier.

Meine Aufforderungsvorlage kann nicht gespeichert werden.

Die Validierung beim Speichern schlägt fehl, wenn ein Briefvorlagenfeld, eine Aktion oder eine erforderliche Eingabe ungültig ist.

• Überprüfen Sie die Briefvorlagenfeldsyntax. Verwenden Sie beispielsweise {!$Input:Account.Id} anstelle der Syntax-{!$account.Id} der Version Winter '24. Weitere Informationen zur Syntax von Ressourcen-Briefvorlagenfeldern.
• Stellen Sie sicher, dass jede erforderliche Eingabe einen Wert aufweist und dass jede Aktion unter "Ressourcen" weiterhin aufgelöst wird. Weitere Informationen zum Hinzufügen einer Eingabe.
• Wenn die Vorlage einen Flow oder eine Apex-Klasse aus dem Eingabeaufforderungsgenerator verwendet, erstellen Sie diese Ressourcen für die aktuelle Syntax neu. Weitere Informationen zu Flow-Änderungen finden Sie nach dem Pilotprogramm. Weitere Informationen zu Änderungen an Apex-Klassen nach dem Pilotprogramm.

Meine Antwort ist maskiert, als schädlicher Inhalt gekennzeichnet oder abgeschnitten.

Die Einstein Trust Layer scannt Aufforderungsvorlagenantworten auf toxische Sprache. Wenn toxische Sprache erkannt wird, wird das Badge für schädliche Inhalte im Abschnitt "Antwort" mit einer Warnanzahl angezeigt. Überprüfen Sie die Aufforderungsvorlage und zeigen Sie erneut eine Vorschau an, bis die Anzahl der Warnungen wieder auf 0 zurückgeht. Weitere Informationen zu Benachrichtigungen zu schädlichen Inhalten finden Sie hier.

Wenn die Antwort abgeschnitten wird, kann die aufgelöste Eingabeaufforderung die Akzeptanz des AI-Modells überschreiten. Wenn eine Eingabeaufforderung zu groß ist, kann der Eingabeaufforderungsgenerator im Bereich "Auflösung" eine Zusammenfassung generieren. Verwenden Sie die zusammengefasste Eingabeaufforderung oder kürzen Sie die Vorlage. Weitere Informationen zum Arbeiten mit großen Eingabeaufforderungen.

Wenn die Einstein Trust Layer sensible Daten durch Platzhalter ersetzt und sie dann wiederherstellt, werden maskierte Werte in der Antwort erwartet. Öffnen Sie Maskierungsdetails im Abschnitt "Antwort", um die Zuordnung zu überprüfen. Weitere Informationen zu Data Trust und Maskierung.

Ich muss meine Aufforderungsvorlagen dokumentieren und debuggen.

Inline-Kommentare im Vorlagentext werden vom Eingabeaufforderungsgenerator nicht unterstützt. Verwenden Sie Versionen, um Änderungen zu vergleichen, und halten Sie kurz fest, was Sie in den einzelnen Versionen geändert haben.

• Klicken Sie vor einer bedeutenden Bearbeitung auf Speichern unter | Speichern als neue Version, um Antworten nebeneinander zu vergleichen. Weitere Informationen zur Verwendung mehrerer Versionen.
• Zeigen Sie jedes Mal eine Vorschau mit demselben Testdatensatz an und notieren Sie sich, welche Anweisung oder Ressource Sie geändert haben.
• Testen Sie bei komplexer Logik den Anweisungstext in der Vorschau selbst, fügen Sie dann Ressourcen hinzu und schauen Sie sich die Vorschau erneut an. Erfahren Sie mehr über das Organisieren komplexer Eingabeaufforderungen.