Skip to main content

Geschätzte Zeit

Etwa 15 Minuten

Themen

Benötigen Sie Hilfe?

Die Community fragen

Sie können innerhalb von 24 - 48 Stunden mit einer Antwort vom Hilfeteam oder der Community rechnen.

Erstellen einer Apex-Agentenaktion

Lernziele

Nachdem Sie diese Lektion abgeschlossen haben, sind Sie in der Lage, die folgenden Aufgaben auszuführen:

  • Erstellen einer Apex-Agentenaktion
  • Hinzufügen einer Agentenaktion zu einem Thema
  • Testen der Agentenaktion
Hinweis

Hinweis

Lernen Sie auf Deutsch? Beginnen Sie die Aufgabe in einem Trailhead Playground in der Sprache Deutsch und verwenden Sie für die Navigation die in Klammern angegebenen Übersetzungen. Kopieren und fügen Sie nur die Angaben in Englisch ein, da zur Überprüfung der Aufgabe Daten in Englisch benötigt werden. Wenn Sie die Aufgabe in Ihrer deutschen Organisation nicht bestehen, empfehlen wir Ihnen folgende Vorgehensweise: (1) Stellen Sie das Gebietsschema auf USA um, (2) legen Sie Englisch als Sprache fest (Anweisungen dazu finden Sie hier) und (3) klicken Sie erneut auf die Schaltfläche "Check Challenge" (Aufgabe überprüfen).

Weitere Details dazu, wie Sie die übersetzte Trailhead-Umgebung optimal nutzen können, finden Sie unter dem Badge "Trailhead in Ihrer Sprache".

Erstellen einer Apex-Agentenaktion

Da der Apex-Code bereit ist, fügen wir ihn nun zu einer Aktion hinzu. Sie werden sehen, an welchen Stellen die Parameter im Apex automatisch in die Aktion übertragen werden.

  1. Klicken Sie auf Setup und wählen Sie Setup aus.
  2. Suchen Sie in Setup im Feld "Quick Find" (Schnellsuche) nach Agentforce Assets (Agentforce-Datenbestände) und wählen Sie diesen Eintrag aus.
  3. Klicken Sie auf die Registerkarte Actions (Aktionen).
  4. Klicken Sie auf New Agent Action (Neue Agentenaktion).
  5. Wählen Sie für "Reference Action Type" (Referenzaktionstyp) Apex aus.
  6. Wählen Sie für "Reference Action Category" (Referenzaktionskategorie) Invocable Method (Aufrufbare Methode) aus.
  7. Wählen Sie für "Reference Action" (Referenzaktion) Check Weather aus. Dies ist die aufrufbare Methode.

    Erstellen einer Agentenaktion mit den Feldern, die der vorherigen Beschreibung entsprechen
  1. Behalten Sie bei "Agent Action Label" (Agentenaktionsbezeichnung) den vorausgefüllten Wert "Check Weather" bei, der aus dem Parameter "label" der aufrufbaren Methode abgerufen wurde.
  2. Behalten Sie bei "Agent Action API Name" (API-Name der Agentenaktion) den automatisch generierten, vorausgefüllten Wert "Check_Weather" bei.
  3. Klicken Sie auf Weiter.

Der nächste Schritt ist das Konfigurieren der Agentenaktion. Hier zeigen sich die Vorteile der Parameterfestlegung im Apex-Code.

  1. Behalten Sie bei "Instructions" (Anwendungen) den vorausgefüllten Wert bei, der aus dem Parameter "description" der aufrufbaren Methode abgerufen wurde.
  2. Deaktivieren Sie das Kontrollkästchen Show loading text for this action ("Text wird geladen" für diese Aktion anzeigen).
  3. Beachten Sie, dass bei "Input" (Eingabe) die Angabe "dateToCheck" eingetragen ist.
  4. Bei "Instructions" (Anweisungen) ist der Wert aus dem Parameter "description" der aufrufbaren Apex-Variablen voreingetragen. Sie können die Anweisungen nach Bedarf ändern oder ergänzen.
  5. Für "Data Type" (Datentyp) ist der Apex-Datentyp voreingetragen.
  6. "Required input" (Eingabe erforderlich) ist standardmäßig aktiviert, da der Parameter "required" auf "true" festgelegt ist.
  7. Aktivieren Sie die Option Collect data from user (Daten vom Benutzer sammeln).

    Abschnitt 'Input' (Eingabe) mit Angaben, die der vorherigen Beschreibung entsprechen
  1. Als "Outputs" (Ausgaben) werden drei Werte aus den aufrufbaren Apex-Variablen übernommen: maxTemperature, minTemperature und temperatureDescription. Die "Instructions" (Anweisungen) für jeden dieser Werte werden aus den zugehörigen description-Parametern und "Data Type" (Datentyp) übernommen und vorab eingetragen.
  2. Aktivieren Sie für die dritte Ausgabe, temperatureDescription, das Kontrollkästchen Show in conversation (In Unterhaltung anzeigen).

    Ausgabe 3 mit eingetragenen Angaben, die der obigen Beschreibung entsprechen, und dem aktivierten Kontrollkästchen "Show in conversation" (In Unterhaltung anzeigen)
  1. Klicken Sie auf Fertigstellen.

Ausgezeichnet! Die Aktion ist fertig. Sie wissen jetzt, wie Sie Ihren Apex-Code in Aktionen einbinden. Außerdem verstehen Sie nun, wie die Apex-Parameter beim Erstellen der Aktion helfen. Als Nächstes fügen wir die Agentenaktion "Check Weather" zu einem Thema hinzu und testen sie.

Aktualisieren des Themas

  1. Klicken Sie auf Setup und wählen Sie Setup aus.
  2. Suchen Sie in Setup im Feld "Quick Find" (Schnellsuche) nach Agentforce Agents (Agentforce-Agenten) und wählen Sie diesen Eintrag aus.
  3. Wählen Sie Einstein Copilot oder Agentforce (Default) (Agentforce (Standard)) aus.
  4. Klicken Sie auf Open in Builder (In Generator öffnen).
  5. Stellen Sie sicher, dass der Agent deaktiviert ist.
  6. Wählen Sie MigrationDefaultTopic aus.
  7. Klicken Sie auf This Topic’s Actions (Aktionen dieses Themas).
  8. Klicken Sie auf New (Neu) und wählen Sie Add from Asset Library (Aus Datenbestandsbibliothek hinzufügen) aus.
  9. Aktivieren Sie das Kontrollkästchen für die Aktion Check Weather und klicken Sie auf Finish (Fertigstellen).
  10. Aktualisieren Sie Ihr Browserfenster und wählen Sie MigrationDefaultTopic aus.
  11. Klicken Sie auf This Topic’s Actions (Aktionen dieses Themas) und prüfen Sie, ob die Aktion Check Weather noch in der Liste enthalten ist. Ist dies nicht der Fall, wiederholen Sie die Schritte 8 bis 11. In unseren Übungsumgebungen bleibt eine hinzugefügte Aktion beim ersten Speichern manchmal nicht mit dem Thema verknüpft.
  12. Klicken Sie auf Activate (Aktivieren). Hinweis: Wenn das Popup-Fenster auf-Fenster "Configuration Issues Detected" (Konfigurationsprobleme erkannt) angezeigt wird, klicken Sie auf Ignore & Activate (Ignorieren & aktivieren).

Abfrage der Wetterdaten

  1. Geben Sie noch in Agentforce Builder (Agentforce-Generator) Check the weather for tomorrow (Schau mal nach dem Wetter für morgen) in das Fenster "Conversation Preview" (Unterhaltungsvorschau) ein.

    Fenster 'Conversation Preview' (Unterhaltungsvorschau) mit der Anforderung 'Check the weather for tomorrow' (Schau mal nach dem Wetter für morgen) und der Antwort des Agenten mit den Temperaturen für Coral Cloud.
  1. Wenn Sie sich die Schritte ansehen, die der Agent durchgeführt, werden Sie feststellen, dass er die Aktion Check Weather ausgewählt hat, um die Anforderung zu erfüllen.

    Schritte in Agentforce Builder (Agentforce-Generator), die die Aufforderung, die Auswahl des Themas 'MigrationDefaultTopic' und die Auswahl der Aktion 'Check Weather' zeigen.
  1. Möchten Sie wissen, wie die Wetterprognose für nächste Woche lautet? Geben Sie Check the weather for next week (Schau mal nach dem Wetter für nächste Woche) ein.
  2. Sehen Sie sich die Schritte erneut an. Der Agent sendete das Datum für jeden Wochentag, um die Antwort zu erstellen.

    Schritte in Agentforce Builder (Agentforce-Generator), die mehrere Aufrufe der Aktion 'Check Weather' mit unterschiedlichen Datumsangaben als 'Input' (Eingabe) zeigen

Gut gemacht! Sie sind Ihrem Ziel, die gesamte, in Ihrem Unternehmen bereits verfügbare Apex-Funktionalität zu verwenden und für die Nutzung durch KI-Agenten bereitzustellen, einen großen Schritt näher gekommen. Sie haben einige bewährte Methoden kennengelernt und erfahren, wie Sie Parameter festlegen, um Ihre Agenten optimal einzusetzen.

Ressourcen

Teilen Sie Ihr Trailhead-Feedback über die Salesforce-Hilfe.

Wir würden uns sehr freuen, von Ihren Erfahrungen mit Trailhead zu hören: Sie können jetzt jederzeit über die Salesforce-Hilfe auf das neue Feedback-Formular zugreifen.

Weitere Infos Weiter zu "Feedback teilen"