Sie befinden sich hier:
Aufrufen eines Agenten über eine Flow- oder Apex-Klasse
Erteilen Sie Ihren Benutzern Zugriff auf die Themen, Aktionen und Argumentationsfunktionen Ihres Agenten, um sich wiederholende Aufgaben zu automatisieren und Unterstützung in Echtzeit bereitzustellen. Verwenden Sie aufrufbare Aktionen, um einen Agentforce Serviceagenten, Agentforce Employee Agent oder Agentforce (Standard) über einen Flow oder eine Apex Klasse aufzurufen. Sie können einen Agenten anrufen, um Hintergrund- oder ereignisgesteuerte Aufgaben überall dort auszuführen, wo Sie einen Flow oder eine Apex Klasse aufrufen können.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise, Performance, Unlimited und Developer Edition. Erforderliche Add-On-Lizenzen variieren je nach Agententyp. |
Salesforce bietet benutzerdefinierte und standardmäßige aufrufbare Aktionen zum Aufrufen eines Agenten über einen Flow oder eine Apex-Klasse.
- Aufrufbare Aktionen für benutzerdefinierte Agenten
-
Aufrufbare benutzerdefinierte Agentenaktionen verarbeiten mehr Unterhaltungen automatisch und werden für die meisten Anwendungsfälle empfohlen. Salesforce bietet für jeden Agentforce Serviceagenten, Agentforce Employee Agent und Agentforce (Standard) in Ihrer Organisation eine aufrufbare benutzerdefinierte Agentenaktion.
Mit benutzerdefinierten Agentenaktionen können Sie das Verhalten Ihres Agenten ganz einfach mit Klicks statt mit Code konfigurieren. Wenn Sie beispielsweise einer Apex-Klasse oder einem Flow eine aufrufbare Aktion für benutzerdefinierte Agenten hinzufügen, verwenden Sie eine Benutzeroberfläche, um die Bedingungen anzugeben, die den Agenten auslösen, die zu erledigende Aufgabe und die zum Erledigen der Aufgabe erforderlichen Daten. Sie definieren die Aufgabe, die der Agent ausführen soll, indem Sie eine Benutzermeldung angeben. Der Agent verwendet sie, um Themen und Aktionen auszuwählen, wie wenn ein Benutzer eine Frage gestellt oder eine Anforderung in einem Chat-Fenster gestellt hätte. Sie können auch die Felder definieren, auf die Ihr Agent antworten soll, und diese Feldwerte dann in Ihrem Flow oder Ihrer Apex Klasse verwenden.
Fügen Sie je nach Anwendungsfall einem Flow oder einer Apex Klasse mehrere aufrufbare Aktionen für benutzerdefinierte Agenten hinzu. Sie können beispielsweise einen Agenten anrufen, um einen Servicevorgang zusammenzufassen, und dann einen zweiten Anruf tätigen, um diese Zusammenfassung zum Entwerfen einer E-Mail-Antwort zu verwenden. Sie können denselben Agenten mehrmals über denselben Flow aufrufen, um separate, aber zugehörige Aufgaben zu erledigen. Alternativ können Sie mehrere Agenten über denselben Flow anrufen, um speziellere Aufgaben zu erledigen.
- Aufrufbare Standardaktionen der Agenten-API
Aufrufbare Standardaktionen der Agenten-API bieten Ihnen direkten Zugriff auf die Agenten-API über einen Flow oder eine Apex-Klasse. Sie bieten genauere Kontrolle über das Verhalten des Agenten während einer Sitzung als benutzerdefinierte aufrufbare Aktionen, erfordern jedoch eine zusätzliche Konfiguration. Sie werden nur für erweiterte Anwendungsfälle empfohlen.
Verwenden Sie beispielsweise die Aktion "Sitzung beenden", um sicherzustellen, dass eine Sitzung beendet wird, wenn bestimmte Bedingungen erfüllt sind. Alternativ können Sie die Aktion "Feedback senden" verwenden, um Benutzerfeedback zur Unterhaltung zu erfassen und in Data Cloud zu speichern.
Salesforce bietet die folgenden standardmäßigen Agenten-API-Aktionen.
- Sitzung beenden
- Send Message (Nachricht senden)
- Sitzung starten
- Feedback einreichen
Aufrufbare Aktionen für benutzerdefinierte Agenten und aufrufbare API-Standardaktionen für Agenten werden für Experience Cloud-Site-Benutzer und Plattformintegrationsbenutzer nicht unterstützt. Der Plattformintegrationsbenutzer wird auch als Systembenutzer oder Systemkontext bezeichnet.
Flows, die einen Agentforce Serviceagenten aufrufen, werden im Kontext des Agentenbenutzers ausgeführt. Flows, die einen Agentforce Employee-Agenten oder Agentforce (Standard) aufrufen, werden im Kontext des authentifizierten Endbenutzers ausgeführt.
In Flows können Sie nur aufrufbare Aktionen für benutzerdefinierte Agenten und aufrufbare Aktionen der Standard-Agenten-API in asynchronen Pfaden aufrufen, nicht in Pfaden, die sofort ausgeführt werden.
Vorbereiten des Anrufs eines Agenten über eine Apex-Klasse oder einen Flow
Erstellen eines Agentforce Serviceagenten, Agentforce Employee Agent oder Agentforce (Standard).
Bereiten Sie die Themen und Aktionen Ihres Agenten vor. Da Standardthemen und -aktionen für Unterhaltungsanwendungsfälle konzipiert sind, funktionieren sie möglicherweise nicht wie erwartet mit Agenten-aufrufbaren Aktionen. Ziehen Sie in Erwägung, Standardthemen und -aktionen aus Ihrem Agenten zu entfernen und benutzerdefinierte Aktionen für Ihre Anwendungsfälle zu erstellen.
Aufrufbare Aktionen für benutzerdefinierte Agenten unterstützen weder benutzerdefinierte Variablen noch die folgenden Standardkontextvariablen: $Context.EndUserId, $Context.RoutableId, $Context.EndUserLanguage, and $Context.EndUserContactId.
Wenn Sie einen Agentforce Serviceagenten verwenden, stellen Sie sicher, dass Ihr Agent über den erforderlichen Zugriff auf alle Datensätze verfügt, die von Ihren Agentenaktionen verwendet werden. Wenn Ihr Agent beispielsweise einen Kundenvorgang zusammenfassen können soll, erstellen Sie einen Berechtigungssatz und ändern Sie die Objekteinstellungen, um Lesezugriff für das Kundenvorgangsobjekt zu erteilen. Weisen Sie dann dem Agentenbenutzer den Berechtigungssatz zu.
- Einrichten einer aufrufbaren Aktion für benutzerdefinierte Agenten in Flow Builder
Fügen Sie einem neuen oder vorhandenen Flow eine aufrufbare benutzerdefinierte Agentenaktion hinzu, um eine Aufgabe automatisch mit Ihrem Agentforce Serviceagenten oder standardmäßigen Agentforce Agenten abzuschließen. - Aufrufbare Aktion für benutzerdefinierte Agenten: Beispiel-Apex-Klassen
Rufen Sie eine aufrufbare Aktion für benutzerdefinierte Agenten aus einer Apex-Klasse auf, um eine Aufgabe automatisch mit Ihrem Agentforce Serviceagenten oder standardmäßigen Agentforce Agenten abzuschließen. Die Apex Klasse muss die Antwort des Agenten zurückgeben.
