Sie befinden sich hier:
Agentenelement ausführen
Verwenden Sie einen Agentforce Agenten, um Aufgaben in Ihrem Flow dynamisch zu bearbeiten. Wählen Sie einen vorhandenen Agenten aus oder erstellen Sie einen Agenten mit benutzerdefinierten Anweisungen und Aktionen.
Erforderliche Editionen
Berechtigungen
Zum Verwenden vorhandener Agenten in Ihren Flows benötigen Sie die Benutzerberechtigung "Setup anzeigen". Zum Erstellen von Agenten in Flow Builder benötigen Sie die Benutzerberechtigung "Anwendung anpassen", "Einstein Copilot Builder", "Einstein Agent Platform Builder" oder "Self-Service Copilot Builder". Benutzer mit dem Profil "Systemadministrator" können Agenten erstellen und verwenden.
Wenn Sie nicht über die Berechtigungen zum Erstellen von Agenten verfügen, wird die Schaltfläche "Agent erstellen" nicht im Agentenauswahlbereich angezeigt. Sie können nur vorhandene Agenten auswählen.
Verwendung
Fügen Sie Ihrem Flow ein Element vom Typ "Ausführensagent" hinzu. Suchen Sie im Feld "Agent" nach einem aktiven Agenten und wählen Sie ihn aus oder klicken Sie auf Agent erstellen, um einen neuen zu erstellen.
Auswählen eines vorhandenen Agenten
Wenn Sie einen vorhandenen Agenten verwenden möchten, suchen Sie im Feld "Agent" nach dem Namen des Agenten. In der Liste werden nur aktive Agenten angezeigt. Konfigurieren Sie nach der Auswahl eines Agenten die Ein- und Ausgaben des Agenten im Eigenschaftenbereich.
Erstellen eines neuen Agenten
Klicken Sie zum Erstellen eines Agenten auf Agent erstellen. Konfigurieren Sie im Fenster "Neuer Agent" die grundlegenden Informationen des Agenten.
| Feld | Beschreibung |
|---|---|
| Bezeichnung | Der Name des Agenten. |
| API-Name | Die Anforderung der Eindeutigkeit gilt nur für Elemente innerhalb des aktuellen Flows. Zwei Elemente können denselben API-Namen besitzen, vorausgesetzt, sie werden in verschiedenen Flows verwendet. Ein API-Name kann Unterstriche und alphanumerische Zeichen ohne Leerzeichen enthalten. Der Name muss mit einem Buchstaben beginnen und darf nicht mit einem Unterstrich enden. Er darf auch keine zwei aufeinander folgenden Unterstriche enthalten. |
| Beschreibung | Eine Beschreibung der Aufgaben des Agenten. |
| Benutzerzugriff | Der Benutzerdatensatz, als der der Agent ausgeführt wird. Wählen Sie einen vorhandenen Benutzer aus oder lassen Sie das System einen Benutzer erstellen. |
| Anweisungen | Anweisungen, die beschreiben, was der Agent tut, und die seine Argumentation anleiten. |
| Aktionen | Die Aktionen, die der Agent verwenden kann. Wählen Sie vorhandene Aktionen aus der Datenbestandsbibliothek aus oder erstellen Sie benutzerdefinierte Aktionen. |
Hinzufügen von Aktionen zum Agenten
Der Agent benötigt mindestens eine Aktion zum Ausführen von Aufgaben. Fügen Sie Aktionen hinzu, bevor Sie auf Erstellen und Aktivieren klicken, oder im Agentforce Builder, nachdem Sie den Agenten aktiviert haben.
Klicken Sie zum Auswählen vorhandener Aktionen auf Aktionen auswählen. Suchen Sie eine oder mehrere Aktionen in der Datenbestandsbibliothek, wählen Sie sie aus und klicken Sie dann auf Zu Agent hinzufügen. Zu den verfügbaren Aktionen zählen Knowledge-Aktionen, als aufrufbare Aktionen konfigurierte Flows und Standardaktionen.
Klicken Sie zum Erstellen einer Aktion auf Aktion erstellen. Konfigurieren Sie die Aktion im Fenster "Aktion erstellen".
| Feld | Beschreibung |
|---|---|
| Bezeichnung des Agententools | Der Name der Aktion. |
| API-Name | Die Anforderung der Eindeutigkeit gilt nur für Elemente innerhalb des aktuellen Flows. Zwei Elemente können denselben API-Namen aufweisen, sofern sie in unterschiedlichen Flows verwendet werden.Ein API-Name darf Unterstriche und alphanumerische Zeichen ohne Leerzeichen enthalten. Der Name muss mit einem Buchstaben beginnen und darf nicht mit einem Unterstrich enden. Er darf auch keine zwei aufeinander folgenden Unterstriche enthalten. |
| Beschreibung | Der Name der Aktion. Der Agent bestimmt anhand dieser Informationen, wie und wann diese Aktion verwendet werden soll. |
| Referenzaktionstyp | Der Aktionstyp, beispielsweise Flow oder Apex. |
| Kategorie der Referenzaktion | Der Untertyp des Referenzaktionstyps. Nicht alle Aktionen weisen eine Referenzaktionskategorie auf. |
| Referenzaktion | Der Name der Aktion, auf die verwiesen werden soll. |
Fügen Sie für jede Eingabe eine Beschreibung dazu hinzu, was die Eingabe bewirkt. Der Agent bestimmt anhand der Beschreibung, wie die Eingabe beim Aufrufen der Aktion verwendet werden soll. Wählen Sie Eingabe zur Ausführung erforderlich aus, um die Eingabe als erforderlich festzulegen.
Fügen Sie für jede Ausgabe eine Beschreibung zu den Ausgaberückgaben und zur Verwendung des Ergebnisses im Flow hinzu. Wählen Sie Aus Agentenkontext filtern aus, um die Ausgabe aus der Argumentation des Agenten auszuschließen. Wählen Sie In Unterhaltung anzeigen aus, um diese Ausgabe in die Antwort des Agenten aufzunehmen.
Klicken Sie auf Erstellen & Aktivieren, um Ihren Agenten zu erstellen und zu aktivieren.
Konfigurieren des Elements
Konfigurieren Sie nach der Auswahl oder Erstellung eines Agenten das Element "Agent ausführen" im Eigenschaftenbereich.
| Feld | Beschreibung |
|---|---|
| Bezeichnung | Die Bezeichnung für die Aktion im Zeichenbereich und im Toolbox-Manager. |
| API-Name | Die Anforderung der Eindeutigkeit gilt nur für Elemente innerhalb des aktuellen Flows. Zwei Elemente können denselben API-Namen aufweisen, sofern sie in unterschiedlichen Flows verwendet werden.Ein API-Name darf Unterstriche und alphanumerische Zeichen ohne Leerzeichen enthalten. Der Name muss mit einem Buchstaben beginnen und darf nicht mit einem Unterstrich enden. Er darf auch keine zwei aufeinander folgenden Unterstriche enthalten. |
| Beschreibung | Die Beschreibung für das Element. |
Eingabewerte festlegen
Konfigurieren Sie die Eingaben des Elements "Agent ausführen" im Eigenschaftenbereich.
| Feld | Beschreibung |
|---|---|
| Agentenanforderung | Eine Frage oder Anforderung, die an den Agenten für diese Flow-Ausführung gesendet werden soll. Der Agent wendet seine Anweisungen auf diese spezifische Anforderung zum Generieren der Ausgabe an. |
| Sitzungs-ID | Optional. Verwenden Sie die Sitzungs-ID, die von einem Element vom Typ "Agent ausführen", das früher im Flow ausgeführt wird, zurückgegeben wird. Der Agent behält seinen vollständigen Argumentationskontext und Speicher aus dieser Unterhaltung bei. Wenn Sie keine Sitzungs-ID angeben, startet der Agent eine neue Unterhaltung. Sie können jedoch jederzeit Ausgaben aus vorherigen Elementen vom Typ "Agent ausführen" als Eingaben angeben. |
Konfigurieren der strukturierten Ausgabe
Definieren Sie strukturierte Ausgabefelder, um zu konfigurieren, dass der Agent strukturierte Daten zurückgibt, die Ihr Flow verwenden kann. Jedes Feld stellt eine Information dar, die der Agent extrahiert oder generiert.
Wenn Sie die strukturierte Ausgabe konfigurieren, gibt der Agent nur strukturierte Daten im Feld "Antwort des strukturierten Agenten" zurück. Das Feld "Agentenantwort" gibt null zurück. Wenn Sie keine strukturierte Ausgabe konfigurieren, gibt der Agent nur unstrukturierten Text im Feld "Agentenantwort" zurück.
Klicken Sie zum Konfigurieren der strukturierten Ausgabe auf Konfigurieren. Konfigurieren Sie die Felder für jedes strukturierte Ausgabefeld:
| Feld | Beschreibung |
|---|---|
| Feldname | Pflichtangabe. Der eindeutige alphanumerische Name für das strukturierte Ausgabefeld. Der Name darf keine Sonderzeichen oder Leerzeichen enthalten. |
| Beschreibung | Eine kurze Beschreibung, die mit dem Feldnamen verwendet wird, um die Genauigkeit des großen Sprachmodells zu erhöhen. |
| Datentyp | Pflichtangabe. Der Datentyp des Felds. Gültige Werte: Zeichenfolge, Zahl, boolesch. |
| Erforderlich | Gibt an, dass der LLM eine Antwort für dieses Ausgabefeld generieren muss. Die Anforderung von Ausgabezeilen kann zu ungenauen oder schädlichen Antworten des LLM führen. |
Ausgabewerte speichern
| Feld | Beschreibung |
|---|---|
| Agentenantwort < | Die unstrukturierte Antwort des Agenten. Gibt null zurück, wenn die strukturierte Ausgabe konfiguriert ist. |
| Sitzungs-ID | Die ID der Unterhaltungssitzung, in der sich die Agentenantwort befindet. |
| Antwort des strukturierten Agenten < | Die strukturierte Ausgabe des Agenten. Gibt null zurück, wenn keine strukturierte Ausgabe konfiguriert ist. |
Strukturierte Ausgabenutzung
Geben Sie vor dem Konfigurieren der strukturierten Ausgabe eine Bezeichnung und einen API-Namen für das Element "Agent ausführen" ein und speichern Sie dann den Flow.
Definieren Sie beim Konfigurieren der strukturierten Ausgabe mindestens 1 strukturiertes Ausgabefeld, bevor Sie speichern.
Für jedes definierte strukturierte Ausgabefeld werden zwei Felder erstellt: eine mit dem definierten Namen und dem zugehörigen booleschen Feld _set. Wenn Sie beispielsweise ein strukturiertes Ausgabefeld mit dem Namen summary definiert haben, wird auch ein boolesches Feld mit dem Namen summary_set erstellt.
| Feld | Beschreibung |
|---|---|
| Wahr | Das Feld war in der Antwort des strukturierten Agenten enthalten, hatte jedoch keinen festgelegten Wert. |
| False | Das Feld war nicht in der Antwort des strukturierten Agenten enthalten. |
Wenn eine definierte strukturierte Ausgabe null zurückgibt, verwenden Sie das zugehörige Feld _set später im Flow, um zu bestimmen, warum das Feld null ist.
Nutzungshinweise
- Testen Sie Ihren Flow vor der Aktivierung, um sicherzustellen, dass das Element "Agent ausführen" wie erwartet funktioniert.
- In Flow Builder im Agentforce Builder erstellte Agenten können jederzeit gefunden und bearbeitet werden.
- Ab API-Version 67.0 sind AI-Agent-Aktionen im Element "Aktion" nicht mehr verfügbar. Verwenden Sie das Element "Agent ausführen", um mit Agenten zu arbeiten. Wenn Sie einen Flow mit einem Aktionselement öffnen, das auf eine AI-Agentenaktion verweist, wird er automatisch als Element vom Typ "Agent ausführen" angezeigt. Ihre ursprüngliche Konfiguration wird beibehalten.
