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 Unteragenten.
  • 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. Suchen Sie im App Launcher nach dem Eintrag Agentforce Studio und wählen Sie ihn aus.
  2. Klicken Sie auf Agent Customization (Agentenanpassung).
  3. Klicken Sie auf New Version (Neue Version).
  4. Wählen Sie unter 'Subagents' (Unteragenten) Answer Weather Questions aus.
  5. Klicken Sie unter 'Actions Available For Reasoning' (Für die Argumentation verfügbare Aktionen) auf Select action (Aktion auswählen) und wählen Sie Create a custom action (Benutzerdefinierte Aktion erstellen) aus.
  6. Geben Sie als 'Action Name' (Aktionsname) Check Weather ein.
  7. Geben Sie für Description (Beschreibung) This action will return the local weather information. (Diese Aktion gibt die Informationen zum Wetter vor Ort zurück.).
  8. Wählen Sie für "Reference Action Type" (Referenzaktionstyp) Apex aus.
  9. Wählen Sie für "Reference Action Category" (Referenzaktionskategorie) Invocable Method (Aufrufbare Methode) aus.
  10. Wählen Sie als 'Reference Action' (Referenzaktion) Check Weather (Wetter überprüfen) aus.
  11. Klicken Sie auf Create and Open (Erstellen und öffnen).

Sie werden feststellen, dass im Abschnitt 'Inputs' das Feld 'dateToCheck' bereits mit einer Beschreibung aus dem Parameter 'description' der aufrufbaren Apex-Variable vorbelegt ist. Sie können die Anweisungen bei Bedarf aktualisieren oder erweitern.

  1. Vergewissern Sie sich, dass 'Require input to execute action' (Eingabe für Aktion erforderlich) standardmäßig aktiviert ist. Dies erfolgt aus dem Code, in dem der erforderliche Parameter auf 'true' festgelegt wird.
    'Inputs' (Eingaben) wie vorstehend beschrieben.

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.

  1. Aktivieren Sie für die dritte Ausgabe, temperatureDescription, das Kontrollkästchen Show in conversation (In Unterhaltung anzeigen).
    'temperatureDescription' mit aktivierter Option 'Show in conversation' (In Unterhaltung anzeigen).
  1. Klicken Sie auf Speichern.
  2. Klicken Sie auf Commit Version (Version festschreiben).
  3. Klicken Sie erneut auf Commit Version (Version festschreiben).
  4. Klicken Sie auf Activate (Aktivieren).
  5. Klicken Sie erneut auf Activate (Aktivieren).

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. Jetzt können Sie sie testen.

Abfrage der Wetterdaten

Mit Agentforce Builder können Sie direkt im Tool mit dem Agenten arbeiten und eine Vorschau anzeigen.

  1. Klicken Sie in Agentforce Builder (Agentforce-Generator) auf Preview (Vorschau).
  2. Sie sollten sich im Live Test Mode (Live-Testmodus) befinden.
  3. Geben Sie im Feld 'Describe your task or ask a question' (Beschreiben Sie Ihre Aufgabe oder stellen Sie eine Frage) die Frage What’s the weather like this Monday? (Wie wird das Wetter an diesem Montag?) ein und drücken Sie die Eingabetaste. Möglicherweise fragt Sie der Agent nach einem genauen Datum und gibt Ihnen die Möglichkeit, eins auszuwählen. Wählen Sie das Datum für nächsten Montag aus und schicken Sie die Eingabe ab.

  4. Unterhaltungsvorschau mit der Anfrage 'What’s the weather like this Monday' und der Antwort vom Agenten mit den Temperaturen für Coral Cloud.

Sehen Sie sich die Schritte an, die der Agent absolviert hat, und beachten Sie, dass er die Aktion Check Weather gewählt hat, um die Anfrage zu bedienen. Schritte in Agentforce Builder (Agentforce-Generator) mit den Werten für 'Input', 'Reasoning', 'Transition to Subagent' für den Unteragenten 'Answer_Weather_Questions', dann 'Reasoning Answer Weather Questions' (Antwort des Argumentationsmoduls auf Wetterfragen).

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"