Sie befinden sich hier:
Bewährte Vorgehensweisen für Handlungsanweisungen für Agenten
Aktionsanweisungen informieren einen Agenten darüber, was Ihre Aktion bewirkt und wann sie verwendet werden soll. Wenn Sie eine benutzerdefinierte Aktion erstellen, planen und testen Sie Ihre Anweisungen sorgfältig, um sicherzustellen, dass Ihre Aktion wie erwartet ausgeführt wird.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience |
| Verfügbarkeit: Enterprise, Performance, Unlimited und Developer Edition. Erforderliche Add-On-Lizenzen variieren je nach Agententyp. |
Die Namen und Anweisungen für Agentenaktionen sowie deren Ein- und Ausgaben bestimmen, wann und wie eine Aktion verwendet wird. AI-Agenten verwenden ein großes Sprachmodell (LLM) und das Argumentationsmodul, um alle einem Agenten zugewiesenen Unteragenten und Aktionen zu durchsuchen und basierend auf der Frage oder Anforderung des Benutzers einen oder mehrere in der Unterhaltung auszuführende Agenten auszuwählen. Je effektiver die Anweisungen sind, desto vorhersehbarer ist die Leistung der Aktion.
Effektive Anweisungen variieren je nach Aktion und Anwendungsfall. Testen Sie Ihre Aktion im Agentforce Builder und wiederholen Sie sie so lange, bis sie Ihren Anforderungen entspricht, um optimale Ergebnisse zu erzielen.
Anweisungen für Aktionen
Aktionsanweisungen beschreiben, was Ihre Aktion bewirkt und wann sie in einer Unterhaltung verwendet werden soll. Das wichtigste Element von Aktionsanweisungen ist eine präzise Beschreibung der Aktionen in natürlicher Sprache, in der Regel ein bis drei Sätze, die als Anweisung an das LLM geschrieben wurden. Die Beschreibung kann das Ziel oder die Aufgabe der Aktion, alle Anwendungsfälle für die Aktion und die Objekte oder Datensätze, die sie verwendet oder ändert, enthalten. Im Allgemeinen gilt: Je mehr relevante Details Sie in Ihre Anweisungen aufnehmen, desto einfacher ist es für die LLM, zwischen Aktionen zu unterscheiden.
| Beispielaktion für Agenten | Weniger effektive Beschreibung | Effektivere Beschreibung |
|---|---|---|
| Aktualisieren der Kontakttelefonnummer | Aktualisiert eine Telefonnummer. | Aktualisiert die Telefonnummer des Benutzers, die seinem Kontaktdatensatz zugeordnet ist. Wenn kein übereinstimmender Kontakt vorhanden ist, wird ein neuer Kontaktdatensatz erstellt. |
| Abfragedatensätze | Bietet die Möglichkeit, natürliche Sprache zu verwenden, um Informationen zu Salesforce CRM-Datensätzen abzufragen. | Findet und ruft Salesforce CRM-Datensätze basierend auf der Benutzereingabe und bestimmten Bedingungen wie Feldwerten ab. Diese Aktion identifiziert automatisch die richtigen Datensätze und den richtigen Objekttyp. |
| Auftrag verfolgen | Aktion zum Abrufen von Verfolgungsinformationen für einen Auftrag. | Gibt Verfolgungsinformationen für einen Kundenauftrag basierend auf der Verfolgungsnummer und der Ziel-PLZ zurück. |
In vielen Fällen ist die Beschreibung in natürlicher Sprache alles, was ein Agent benötigt, um Ihre Aktion wie erwartet zu verwenden. Einige Aktionen erfordern jedoch nach dem Testen weitere Details. Im Folgenden finden Sie einige Optionen zum Eingrenzen Ihrer Aktionsbeschreibung.
| Einschließen von Elementen | Einsatzmöglichkeiten | Beispiele |
|---|---|---|
| Eine bis drei Äußerungen oder Beispielkundeneingaben | Fügen Sie Beispiele für Kundennachrichten hinzu, die Ihre Aktion auslösen sollen, damit die LLM eine bestimmte Kundeneingabe mit Ihrer Aktion abgleichen kann. Wenn Sie mehrere Äußerungen einschließen, minimieren Sie Überschneidungen.
|
|
| Abhängige Aktionen | Einige Aktionen verwenden andere Aktionen, häufig Systemaktionen, um die erforderlichen Informationen abzurufen. Wenn eine erforderliche Aktion in einem Plan fehlt oder Aktionen nicht in der richtigen Reihenfolge aufgerufen werden, können Sie sie nach API-Namen angeben. | Die Aktion IdentifyRecordByName muss direkt vor dieser Aktion aufgerufen werden, um eine einzelne Datensatz-ID als Eingabe abzurufen. Wenn die Aktion IdentifyRecordByName Teil des Plans ist, muss sie vor GetRecordFieldsAndValues ausgeführt werden. |
| Beispiele für die Funktionsweise der Aktion | Beispiele lassen sich nicht gut verallgemeinern, sie können jedoch hilfreich sein, wenn ein Agent einen durchgängigen Fehler macht. Im Allgemeinen verstehen LLMs Beispiele dafür, was besser zu tun ist, als Beispiele dafür, was nicht zu tun ist. Sie können jedoch beides testen. |
Diese Aktion sollte nur aufgerufen werden, wenn keine spezifischere Zusammenfassungsaktion verfügbar ist. |
Anweisungen für Ein- und Ausgaben
Anweisungen für Eingaben und Ausgaben beschreiben, wie der Parameter formatiert und verwendet wird. Geben Sie in den Anweisungen für eine Eingabe an, welche Informationen zum Ausführen der Aktion erforderlich sind. Geben Sie in den Anweisungen für eine Ausgabe das Ergebnis der Aktion an und geben Sie an, was ein Agent dem Benutzer zurückgibt.
LLMs verfügen nicht über ein vollständiges Verständnis des Kontexts, einschließlich des Salesforce-Kontexts. Anders ausgedrückt: Ein LLM kennt nicht immer die Anzahl der Zeichen in einer Salesforce-Datensatz-ID oder die Namen von Salesforce-Objekten. Prägnante, aber detaillierte Anweisungen helfen einem Agenten, die erforderlichen Informationen abzurufen und relevante Ergebnisse zurückzugeben. Die richtige Detailstufe lässt sich am besten anhand Ihrer Anweisungen testen und wiederholen.
Beachten Sie beim Schreiben von Anweisungen für eine Eingabe oder Ausgabe Folgendes:
- Der Datentyp der Informationen: "eine 18-stellige ID", eine Rich-Text-Antwort auf die Frage des Benutzers.
- Bestimmte Felder oder Werte: "enthält die Kontakt-ID und das erwartete Lieferdatum".
- Wie die Informationen abgerufen oder generiert werden: "Bei einer neuen E-Mail rufen Sie die ID aus der Eingabe des Benutzers ab. Rufen Sie bei einer überarbeiteten E-Mail die ID aus dem Unterhaltungsverlauf ab."
- Spezielle Regeln zur erwarteten Verwendung der Aktion: "Generieren Sie keine SQL oder SOQL." "Nur erforderlich, wenn der Benutzer einen früheren Entwurf überarbeiten möchte." "Der API-Name wird verwendet, um Salesforce-Datensatz-Feldwertpaare aus der Benutzeranforderung zu identifizieren."
Im Folgenden finden Sie einige Beispiele für effektive Anweisungen für Ein- und Ausgaben.
| Eingabe- oder Ausgabeparameter | Anweisungen |
|---|---|
| recordId | Die einzelne ID des Salesforce CRM-Datensatzes, für den die Zusammenfassung erstellt werden soll. Beispiel: recordId, record_id, recordIds[0], accountId. |
| objectApiName | Der API-Name des Salesforce-Objekts (z. B. Account oder Opportunity), das dem Datensatz zugeordnet ist, den der Benutzer suchen möchte. Der Name kann aus dem Kontext abgerufen werden und erfordert keine IdentifyObjectByName-Aktion. |
| Übersicht | Die für den angegebenen Datensatz erstellte Rich-Text-Zusammenfassung. |
| searchResults | Eine Liste der übereinstimmenden Salesforce CRM-Datensatz-IDs in absteigender Reihenfolge der Relevanz. |
| generateEmail | Ein JSON-Objekt, das die Empfänger-ID, die Betreffzeile und den Text der E-Mail enthält. |
