YouTube ChannelSchedule a CallSubscribe for Updates

AgentForce-Agent aufrufen

Übersicht

Der Agentforce-Agent aufrufen Die Interaktion "Agentforce-Agent aufrufen" ermöglicht es Ihnen, Nachrichten direkt aus einer Avonni Dynamic Component an einen Agentforce-Agenten zu senden. Dies bietet eine leistungsstarke Möglichkeit, KI-gestützte Unterstützung und intelligente Automatisierung in Ihre Benutzeroberfläche zu integrieren, sodass Benutzer Agentenfunktionen nutzen können, ohne die aktuelle Seite zu verlassen.

Wichtig

Bevor Sie diese Interaktion verwenden können, müssen Sie zunächst einen Agentforce-Agenten im Agent Builder von Salesforce erstellen und konfigurieren. Diese Interaktion ist ein Connector zwischen Ihrer Dynamic Component und einem bestehenden Agenten—sie erstellt oder konfiguriert den Agenten nicht selbst

Was Sie vor Beginn benötigen

  1. Ein aktiver Agentforce-Agent

    • Erstellt in Salesforce Setup → Agent Builder

    • Vollständig konfiguriert mit Themen, Aktionen und Anweisungen

    • Aktiviert und bereit, Anfragen zu empfangen

    • Berechtigungen sind so konfiguriert, dass der Agent auf die benötigten Daten zugreifen kann

  2. Der API-Name des Agenten

    • Zu finden im Agent Builder, wenn Sie die Details Ihres Agenten anzeigen

    • Dies ist die eindeutige Kennung, die Sie in der Interaktionskonfiguration verwenden

    • Beispiel: Account_Summarizer_Agent oder Customer_Service_Agent

Ohne einen im Agent Builder erstellten Agenten funktioniert diese Interaktion nicht. Die Interaktion löst einen bestehenden Agenten aus—jedes KI-Verhalten, der Datenzugriff und die Antwortlogik müssen im Agenten selbst konfiguriert werden.

Wie Agent Builder und Dynamic Components zusammenarbeiten

  • Agent Builder: Hier definieren Sie, was der Agent tut, auf welche Daten er zugreifen kann und wie er antwortet

  • Dynamic Components: Hier erstellen Sie die Benutzeroberfläche, die den Agenten auslöst und seine Antworten anzeigt

  • Diese Interaktion: Die Brücke, die Benutzeraktionen in Ihrer Komponente mit der Agentenausführung im Agent Builder verbindet

Neu bei Agentforce? Erfahren Sie, wie Sie Agenten erstellen in Salesforce Agent Builder Dokumentation. Sobald Ihr Agent bereit ist, kehren Sie hierher zurück, um ihn mit Ihren Dynamic Components zu integrieren.

Unterstützte Komponenten

Sie können die Interaktion "Agentforce-Agent aufrufen" zu den folgenden Avonni Dynamic Components hinzufügen:

  • Schaltfläche

  • Schaltflächengruppe

  • Schaltflächenmenü

  • Schaltfläche Symbol

  • Datentabelle (Kopfzeilenaktionen)

  • Listenelement

Wichtig

Die Interaktion "Agentforce-Agent aufrufen" ist für programmatische Agentenaufrufe konzipiert, die im Hintergrund ausgeführt werden. Der Agent verarbeitet Ihre Nachricht und gibt eine Antwort zurück, die Sie erfassen und innerhalb Ihrer Dynamic Component verwenden können.

Funktionsweise

  1. Benutzeraktion: Der Benutzer interagiert mit der Komponente (z. B. klickt auf eine Schaltfläche).

  2. Agentenaufruf: Die Interaktion "Agentforce-Agent aufrufen" sendet eine Nachricht an den angegebenen Agentforce-Agenten.

  3. Datenübermittlung (optional): Sie können dem Agenten Parameter übergeben, um Kontext oder spezifische Anweisungen bereitzustellen.

  4. Agentenverarbeitung: Der Agent verarbeitet die Nachricht mithilfe seiner konfigurierten Themen, Aktionen und KI-Fähigkeiten.

  5. Antwort erfassen (optional): Die Antwort des Agenten kann in einer Ressource erfasst werden, um sie innerhalb Ihrer Dynamic Component zu verwenden.

  6. Aktionen nach der Ausführung (optional): Sie können Aktionen konfigurieren, die nach der Antwort des Agenten ausgeführt werden (z. B. Anzeigen einer Toast-Nachricht bei Erfolg oder Fehler).

Aktionen nach der Ausführung (optional):

Die Interaktion "Agentforce-Agent aufrufen" verbindet eine Benutzeraktion (z. B. Klick auf eine Schaltfläche) mit einem Agentforce-Agenten. Wenn sie konfiguriert ist, sendet sie eine Nachricht an den Agenten, übergibt optional Parameter für Kontext, erfasst die Antwort des Agenten und behandelt Erfolgs- oder Fehlerszenarien.

Fügen Sie diese Interaktion einem beliebigen unterstützten Avonni-Komponent über das Eigenschaftsfenster der Komponente unter "Aktionen" oder "Interaktionen" hinzu. Wählen Sie "Agentforce-Agent aufrufen" als Interaktionstyp.

Agent-API-Name

Damit wird festgelegt, welcher Agentforce-Agent Ihre Anfrage verarbeiten soll. Geben Sie den API-Namen des Agenten ein, den Sie im Agent Builder erstellt haben. Dies ist die eindeutige Kennung, die Salesforce mitteilt, welchen Agenten es beim Auslösen der Interaktion aufrufen soll.

Benachrichtigung an den Agenten

Dies ist die Eingabeaufforderung oder Frage, die Sie an den Agenten senden. Betrachten Sie sie als Anweisung an die KI. Die Nachricht kann sein:

  • Statischer Text: Eine feste Nachricht wie "Fasse dieses Konto zusammen"

  • Dynamisch mit Merge-Syntax: Schließen Sie Variablen aus Ihrer Komponente ein mit {!variableName} Notation. Zum Beispiel, "Können Sie dieses Konto {!combobox1.selectedItemSObject.Id} zusammenfassen" fügt dynamisch die ausgewählte Konten-ID in Ihre Nachricht ein

  • Kontextreich: Kombinieren Sie statische Anweisungen mit dynamischen Daten, um dem Agenten alles zu geben, was er braucht

Der Agent erhält diese Nachricht und verarbeitet sie entsprechend seinen konfigurierten Themen und Aktionen.

Parameter (Optional)

Parameter ermöglichen es Ihnen, dem Agenten zusätzlich zur Benutzernachricht strukturierte Daten zu übergeben. Dies ist nützlich, wenn Ihr Agent bestimmte benannte Eingaben erwartet oder wenn Sie Kontext getrennt von der Hauptaufforderung bereitstellen müssen.

Für jeden Parameter, den Sie hinzufügen:

  • den Flow zu übergeben, fügen Sie hier Einträge hinzu. Die Parameterkennung, die Ihr Agent erwartet (im Agent Builder definiert)

  • in Was Sie übergeben - dies kann ein fester Wert, ein Komponentenattribut oder eine Ressourcenvariable sein

Verwenden Sie Parameter, wenn Ihr Agent strukturierte Eingaben benötigt, anstatt nur eine Textnachricht zu parsen.

Name der Antwortressource

Hier wird angegeben, wo die Interaktion die Antwort des Agenten speichern soll. Geben Sie den Namen einer Textvariable in Ihrer Dynamic Component ein. Sobald der Agent antwortet, wird seine Antwort automatisch in dieser Variable gespeichert und steht zur Verfügung für:

  • Anzeige in Textkomponenten

  • Verwendung in Formeln oder bedingter Logik

  • Auslösen zusätzlicher Aktionen basierend auf dem Inhalt

  • Übergabe an andere Interaktionen oder Flows

Wenn Sie keine Ressource angeben, verarbeitet der Agent Ihre Anfrage weiterhin, aber Sie können die Antwort nicht erfassen oder anzeigen.

Schritt-für-Schritt-Beispiel

Ausgewählte Konten mit Agentforce zusammenfassen

Lassen Sie uns ein praktisches Beispiel erstellen, bei dem Benutzer mehrere Konten aus einer Datentabelle auswählen und durch Klicken auf eine Schaltfläche eine KI-gestützte Zusammenfassung erhalten.

Szenarioübersicht

Sie haben eine Avonni Data Table, die in Ihrer Dynamic Component eine Liste von Konten anzeigt. Benutzer können:

  1. Ein oder mehrere Konten in der Datentabelle markieren

  2. Auf eine Schaltfläche "Ausgewählte zusammenfassen" in den Header-Aktionen der Tabelle klicken

  3. Eine KI-generierte Zusammenfassung der ausgewählten Konten von einem Agentforce-Agenten erhalten

Bevor Sie beginnen

Voraussetzungen:

  • Ein im Agent Builder erstellter und konfigurierter Agentforce-Agent

  • Eine Avonni Data Table-Komponente, die Kontodatensätze anzeigt

  • Die Datentabelle ist so konfiguriert, dass Zeilenauswahl aktiviert ist (Kontrollkästchen sichtbar)

Einrichtungs-Schritte

1

Bereiten Sie Ihre Datentabelle vor

Zuerst richten Sie die Datentabelle ein, die Ihre Konten anzeigt, und konfigurieren sie so, dass Benutzer Datensätze auswählen und den Agenten auslösen können. Dies schafft die Grundlage für die interaktive Zusammenfassungsfunktion.

  1. Fügen Sie die Datentabelle hinzu

    • Fügen Sie Ihrer Dynamic Component eine Avonni Data Table hinzu

    • Konfigurieren Sie sie so, dass Account-Datensätze angezeigt werden

    • API-Name: Notieren Sie sich diesen (z. B., Datatable1) - Sie benötigen ihn später, um auf die ausgewählten Zeilen zu verweisen

  2. Zeilenauswahl aktivieren

    • Aktivieren Sie in den Eigenschaften der Datentabelle die Zeilenauswahl (Kontrollkästchen)

    • So können Benutzer mehrere Konten auswählen, die sie zusammenfassen möchten

  3. Fügen Sie eine Header-Aktionsschaltfläche hinzu

    • In den Header Actions Abschnitt der Datentabelle

    • Fügen Sie eine Schaltfläche mit einer Beschriftung wie "Ausgewählte Konten zusammenfassen" hinzu

    • Diese Schaltfläche löst beim Klicken den Agentenaufruf aus

2

Erstellen Sie eine Variable zur Speicherung der Agentenantwort

Bevor Sie den Agenten aufrufen, benötigen Sie einen Ort, an dem die zurückgegebene Antwort gespeichert wird. Diese Variable erfasst die KI-generierte Zusammenfassung, damit Sie sie Benutzern anzeigen oder anderswo in Ihrer Komponente verwenden können.

Erstellen Sie eine Textvariable

  • In den Ressourcen Ihrer Dynamic Component

  • API-Name: agentResponse (oder Ihr bevorzugter Name)

  • Datentyp: Text

  • Hier wird die vom Agenten zurückgegebene Zusammenfassung gespeichert

3

Konfigurieren der Interaktion "Agentforce-Agent aufrufen"

Konfigurieren Sie nun, was passiert, wenn Benutzer auf die Schaltfläche "Ausgewählte Konten zusammenfassen" klicken.

  1. Wählen Sie Ihre Header-Aktionsschaltfläche aus

    • Klicken Sie auf die in Schritt 1 erstellte Schaltfläche

  2. Fügen Sie eine Interaktion hinzu

    • Fügen Sie in den Eigenschaften der Schaltfläche eine neue Aktion/Interaktion hinzu

    • Zahnrad-Symbol (normalerweise in der oberen rechten Ecke von Salesforce). "Agentforce-Agent aufrufen"

  3. Konfigurieren Sie die Agenteneinstellungen Füllen Sie die folgenden Felder in der Interaktionskonfiguration aus: Agent-API-Name Geben Sie den API-Namen Ihres Agenten aus dem Agent Builder ein. Beispiel: Account_Summarizer_Agent So finden Sie den API-Namen Ihres Agenten: Gehen Sie zu Agent Builder → Wählen Sie Ihren Agenten → Kopieren Sie den API-Namen aus den Agentendetails

Benutzernachricht: Dies ist die Aufforderung, die Sie an den Agenten senden. Kopieren Sie die untenstehende Vorlage und passen Sie sie bei Bedarf an:

   System:
   Sie sind ein Salesforce-versierter Vertriebsanalyst. Seien Sie prägnant und strukturiert.

   Benutzer:
   Fassen Sie die folgenden von Benutzern ausgewählten Salesforce-Konten zusammen.
   Einschließlich: Anzahl der Konten, gesamter ARR/Jahresumsatz (falls vorhanden), wichtigste Branchen, häufige Produkte, auffällige Weißräume und eine 5-punktige Executive-Zusammenfassung.

   Datensatz-IDs:
   {!Datatable1.selectedRowsKeyValue}

Wichtig: Ersetzen Sie Datatable1 durch den tatsächlichen API-Namen Ihrer Datentabelle.

Was dies bewirkt:

  • {!Datatable1.selectedRowsKeyValue} fügt dynamisch die IDs aller vom Benutzer ausgewählten Konten ein

  • Der Agent erhält diese IDs und kann Salesforce nach den vollständigen Kontodetails abfragen.

Name der Antwortressource

Eingeben: agentResponse

Dies ist der Variablenname, den Sie in Schritt 2 erstellt haben. Die Zusammenfassung des Agenten wird hier gespeichert.

4

Die Antwort des Agenten anzeigen

Da die Agenteninteraktion jetzt konfiguriert ist und ihre Antwort in der agentResponse Variable gespeichert wird, müssen Sie diese Zusammenfassung den Benutzern anzeigen. Wir fügen eine Komponente hinzu, die die Antwort des Agenten anzeigt und erst erscheint, nachdem der Agent Ergebnisse zurückgegeben hat.

  1. Fügen Sie eine Anzeige-Komponente hinzu

    • Fügen Sie eine Komponente hinzu, um die Zusammenfassung anzuzeigen (z. B., Profilkarte, Anzeigetext, oder Rich Text Komponente)

    • Platzieren Sie sie an einer sichtbaren Stelle auf Ihrer Dynamic Component-Leinwand

  2. Konfigurieren Sie den Inhalt der Komponente

    • Finden Sie in den Eigenschaften der Komponente das Feld zur Anzeige von Textinhalt

    • Setzen Sie den Wert auf {!agentResponse}

    • Dies zeigt an, was auch immer der Agent zurückgibt

  3. Sichtbarkeit der Komponente einstellen (Optional, aber empfohlen)

    • Wählen Sie Ihre Anzeige-Komponente aus

    • Suchen Sie Sichtbarkeit der Komponente einstellen im Eigenschaftenfenster

    • Erstellen Sie eine Bedingung, sodass die Komponente nur erscheint, wenn es eine Antwort zum Anzeigen gibt:

   {!agentResponse} IS NOT NULL

Was dies bewirkt: Die Komponente bleibt verborgen, bis der Agent eine Antwort zurückgibt. Sobald agentResponse Daten enthält, erscheint die Komponente automatisch mit der Zusammenfassung.

Was Sie erreicht haben: Benutzer sehen jetzt die KI-generierte Zusammenfassung auf dem Bildschirm, wenn sie auf die Schaltfläche "Ausgewählte Konten zusammenfassen" klicken. Die Zusammenfassungskomponente bleibt verborgen, bis tatsächlich Inhalt zum Anzeigen vorhanden ist, wodurch Ihre Oberfläche sauber bleibt

Aktion bei Abschluss:

  • Agentenkonfiguration: Stellen Sie sicher, dass Ihr Agentforce-Agent korrekt mit den notwendigen Themen, Aktionen und Berechtigungen konfiguriert ist, um Ihre Anfragen zu verarbeiten.

  • Nachrichtenformat: Strukturieren Sie Ihre Benutzernachricht klar, damit der Agent die Absicht versteht. Geben Sie relevanten Kontext mit Merge-Syntax an.

  • Parameter-Namen: Wenn Sie Parameter verwenden, stellen Sie sicher, dass die Parameternamen mit dem übereinstimmen, was Ihr Agent erwartet.

  • Antwortbehandlung: Planen Sie, wie Sie die Antwort des Agenten verwenden—ob Sie sie den Benutzern anzeigen, Datensätze aktualisieren oder zusätzliche Aktionen auslösen.

  • Fehlerbehandlung: Verwenden Sie die Aktion "Bei Fehler", um Fehler, die während des Agentenaufrufs auftreten können, elegant zu behandeln.

  • Leistung: Agentenaufrufe können einige Sekunden zur Verarbeitung benötigen. Erwägen Sie das Hinzufügen von Ladeindikatoren oder informativen Nachrichten, um die Erwartungen der Benutzer zu steuern.

Fehlerbehandlung:

Die Interaktion "Agentforce-Agent aufrufen" ist eine wertvolle Funktion, um KI-gestützte Intelligenz zu Ihren Dynamic Components hinzuzufügen. Zu den Konfigurationseinstellungen gehört die Angabe des aufzurufenden Agenten, das Erstellen der Benutzernachricht mit dynamischem Kontext, das Übergeben von Parametern, das Erfassen der Antwort sowie das Definieren von Erfolgs- und Fehleraktionen

Zuletzt aktualisiert

War das hilfreich?