Richten Sie einen Conversational AI-Agenten im Jitterbit App Builder ein

Übersicht

Dieser Leitfaden zeigt, wie Sie die Chat-Oberfläche im App Builder über die Seite Agenten registrieren im IDE konfigurieren. Dies ist der zweite Schritt zur Einrichtung der Conversational AI-Funktion.

Nach Abschluss dieses Schrittes erscheint eine Chat-Blase in der unteren rechten Ecke Ihrer Anwendung, die es Benutzern ermöglicht, mit Ihrem AI-Agenten zu interagieren.

Voraussetzungen

Bevor Sie Agenten konfigurieren, müssen Sie Ihren AI-Agenten als REST-API-Datenquelle mit dem App Builder verbunden haben. Siehe Einen AI-Agenten verbinden für Anweisungen.

Fügen Sie einen Agenten hinzu

1. Greifen Sie auf das IDE zu.

2. Klicken Sie unter Build auf Agenten registrieren.

   

3. Klicken Sie auf Registrieren. Der Dialog zur Agenten-Konfiguration öffnet sich.

4. Konfigurieren Sie den Agenten:

   • Name: Geben Sie einen Namen für den Agenten ein.

   • Datenquelle: Wählen Sie die REST-API-Datenquelle aus, die Sie im vorherigen Schritt konfiguriert haben.

   • Ziel: Wählen Sie den Endpunkt aus, der für die Interaktion mit dem Agenten verwendet werden soll.

   • Beschreibung: (Optional) Geben Sie eine Beschreibung des Agenten ein.

   • Willkommensnachricht: (Optional) Geben Sie eine Nachricht ein, die Benutzern angezeigt wird, wenn sie die Chat-Oberfläche öffnen.

   • Alle Nachrichten einbeziehen: (Optional) Aktivieren Sie diese Option, um den gesamten Gesprächsverlauf in jede an den Agenten gesendete Anfrage einzubeziehen. Wenn deaktiviert (Standard), wird nur die letzte Nachricht gesendet.

   • Ist Standard: Aktivieren Sie diese Option, um diesen Agenten zum Standardagenten für die Anwendung zu machen. Der Standardagent ist derjenige, der geöffnet wird, wenn ein Benutzer auf die Chat-Blase klickt.

   • Ist Aktiv: Aktivieren Sie diese Option, um den Agenten für Benutzer verfügbar zu machen.

   • Symbol-Datei: (Optional) Wählen Sie ein Bild aus, das als Avatar des Agenten in der Chat-Oberfläche verwendet werden soll. Klicken Sie auf Durchsuchen, um die Datei zu finden und hochzuladen. Wenn kein Symbol bereitgestellt wird, zeigt die Chat-Oberfläche ein Standardsymbol an, das die ersten beiden Buchstaben des Agentennamens verwendet.

5. Icon-Vorschau: Wenn Sie ein Avatar für den Agenten im Feld Icon-Datei ausgewählt haben, wird eine Vorschau des ausgewählten Symbols angezeigt.

6. Klicken Sie auf Speichern. Die Sprechblase erscheint in der unteren rechten Ecke. Im Konfigurationsdialog wird eine Nachricht angezeigt, die Sie daran erinnert, die Schaltfläche Mappings zu verwenden, um die Zuordnungen einzurichten. Siehe den nächsten Abschnitt, Konfigurieren von Nutzungstyp-Zuordnungen.

   

   Wichtig

   Die Sprechblase ist nur für Benutzer sichtbar, die zu einer Gruppe gehören, die Zugriff auf die Datenquelle hat, mit der der KI-Agent verbunden ist. Benutzer ohne Zugriff sehen die Sprechblase nicht.

Konfigurieren von Nutzungstyp-Zuordnungen

Die Nutzungstyp-Zuordnungen teilen dem App Builder mit, welche Spalten der Datenquelle Ihres KI-Agenten die Nachricht des Benutzers, die Antwort des Agenten und andere Sitzungsdaten enthalten. Die Chat-Oberfläche benötigt diese Zuordnungen, um korrekt mit dem Agenten zu kommunizieren. Wenn Sie die Zuordnungen bereits manuell im Bereich Datenserver konfiguriert haben, überspringen Sie diesen Abschnitt und fahren Sie mit Konfigurieren der Sichtbarkeit des Agenten fort.

Nachdem Sie einen Agenten erstellt haben, klicken Sie auf Mappings im Konfigurationsdialog. Ein neuer Dialog öffnet sich, der oben den Agentennamen und den Datenserver anzeigt, sowie eine Tabelle mit den folgenden Spalten:

• Richtung: Gibt an, ob eine bestimmte Spalte für Eingabe oder Ausgabe verwendet wird.

• Name: Der Name der Spalte.

• Endpoint-Testwerte: Zeigt die Beispielwerte, die während der Endpunktentdeckung verwendet werden, nur zur Kontextinformation. Diese Werte werden nicht verwendet, wenn die Registrierung des Agenten getestet wird.

• Zuordnung: Verwenden Sie für jede Zeile in der Tabelle dieses Dropdown-Menü, um den entsprechenden Nutzungstyp zuzuweisen. Die verfügbaren Optionen hängen vom Wert in der Spalte Richtung ab:

  • Ausgabe-Spalten erhalten Daten vom Endpunkt. Die einzige verfügbare Zuordnung ist Agentenantwort, die Textantwort, die vom benutzerdefinierten Agenten zurückerhalten wird.

  • Eingabe-Spalten senden Daten an den Endpunkt. Die verfügbaren Zuordnungen sind:

    Zuordnung	Beschreibung
    Benutzereingabe	Die Chat-Nachricht oder Eingabe, die an den benutzerdefinierten Agenten gesendet wird.
    Benutzer-ID	Überträgt die eindeutige ID des angemeldeten Benutzers.
    Email	Überträgt die Email des angemeldeten Benutzers.
    Benutzername	Überträgt den Benutzernamen des angemeldeten Benutzers.
    Konversations-ID	Überträgt die eindeutige ID der aktuellen Chat-Konversation.

Nachdem Sie die Zuordnungen konfiguriert haben, klicken Sie oben im Dialogfeld auf Validieren. Die Validierung führt einen Test gegen den Endpunkt durch und meldet etwaige Konfigurationsprobleme. Wenn der Endpunkt-Test fehlschlägt, werden die Ergebnisse im oberen Bereich angezeigt, um das Problem zu diagnostizieren.

Agentensichtbarkeit konfigurieren

Standardmäßig ist die Sprechblase eines Agenten in allen benutzerdefinierten Anwendungen sichtbar und auf Systemseiten ausgeblendet. Seit App Builder 4.62 können Sie dieses Verhalten pro Agenten überschreiben; zum Beispiel, um einen Vertriebsagenten nur in einer Vertriebsanwendung anzuzeigen und in allen anderen Anwendungen auszublenden.

Um die Sichtbarkeit für einen Agenten zu konfigurieren:

1. Greifen Sie auf die IDE zu.

2. Klicken Sie unter Erstellen auf Agenten registrieren.

3. Suchen Sie den Agenten-Datensatz und klicken Sie auf Sichtbarkeit. Das Dialogfeld Agentensichtbarkeit anpassen öffnet sich.

   

4. Wählen Sie im Dropdown-Menü Systemoptionen aus, wie sich der Agent auf den Systemseiten des App Builders verhält:

   Option	Beschreibung
   Auf Systemanwendungen ausblenden (Standard)	Der Agent ist auf allen Systemseiten ausgeblendet und auf allen benutzerdefinierten Anwendungen sichtbar.
   Auf Systemanwendungen anzeigen	Der Agent ist auf allen Systemseiten (Site-Menü, IDE, Designer, Benutzerverwaltung und anderen) und auf allen benutzerdefinierten Anwendungen sichtbar.
   Nur im Site-Menü anzeigen	Der Agent ist nur im Site-Menü sichtbar, auf allen anderen Systemseiten ausgeblendet und auf allen benutzerdefinierten Anwendungen sichtbar.
   Überall ausblenden	Der Agent ist auf allen Systemseiten und allen benutzerdefinierten Anwendungen ausgeblendet. Der Agent ist nur über benutzerdefinierte Chat-Panels zugänglich.

5. Unter Sichtbarkeit nach App konfigurieren Sie, welche benutzerdefinierten Anwendungen den Agenten anzeigen:

   • Standardmäßig sind keine Anwendungen ausgewählt, was bedeutet, dass der Agent in allen benutzerdefinierten Anwendungen angezeigt wird. Ein -Symbol neben einer Anwendung zeigt an, dass der Agent in dieser Anwendung sichtbar ist; ein -Symbol zeigt an, dass er nicht sichtbar ist.
   • Um den Agenten auf bestimmte Anwendungen zu beschränken, klicken Sie auf Auswählen neben jeder Anwendung, die Sie einbeziehen möchten.

   Tipp

   Lassen Sie alle Anwendungen abgewählt, um sicherzustellen, dass der Agent in allen aktuellen und zukünftigen benutzerdefinierten Anwendungen angezeigt wird. Das Auswählen einzelner Anwendungen bedeutet, dass der Agent nicht in neuen Anwendungen angezeigt wird, die später zum System hinzugefügt werden. Diese Einstellung gilt nur, wenn der Agent nicht auf Überall Ausblenden in Systemoptionen eingestellt ist.

   Hinweis

   Wenn Überall Ausblenden in Systemoptionen ausgewählt ist, sind die Auswahlsteuerungen für die Anwendungen deaktiviert.

6. Klicken Sie auf Speichern, um die Änderungen anzuwenden.

Chat-Blase

Nach dem Speichern des Agenten erscheint eine -Chat-Blase in der unteren rechten Ecke. Sie können sie per Drag & Drop verschieben, um ihre Position auf dem Bildschirm zu ändern. Ein Klick auf die Chat-Blase öffnet ein Chat-Fenster als Seitenpanel, das den Seiteninhalt nach links verschiebt:

Das Chat-Fenster zeigt Folgendes an:

• Den Namen und das Logo des Standardagenten oben.

• Die Willkommensnachricht, die für den Agenten konfiguriert wurde.

• Ein Texteingabefeld unten mit einem Senden-Button (oder drücken Sie Enter, um eine Nachricht zu senden).

In der oberen rechten Ecke des Chat-Fensters befinden sich die folgenden Steuerungen:

• Bleistift-Symbol: Öffnet einen neuen Chat und löscht den aktuellen Nachrichtenverlauf. Die Willkommensnachricht wird erneut angezeigt.

• Maximieren-Symbol: Erweitert den Chat auf den Vollbildmodus. Im Vollbildmodus erscheint eine Navigationsleiste auf der linken Seite.

• X: Schließt das Chat-Fenster.

Im Seitenpanel-Ansicht öffnet ein Klick auf das Hamburger-Menü in der oberen linken Ecke die Navigationsleiste, die Folgendes anzeigt:

• Agenten: Listet alle verfügbaren Agenten auf. Klicken Sie auf einen Agenten, um zu ihm zu wechseln.

• Chats: Zeigt den Chatverlauf nach Datum organisiert an, wobei jeder Eintrag das Symbol des in diesem Gespräch verwendeten Agenten zeigt.

Nächste Schritte

Nachdem Sie einen Agenten konfiguriert haben, können Sie optional die Chat-Oberfläche direkt in ein Seitenlayout einbetten, anstatt die schwebende Chat-Blase zu verwenden. Siehe Fügen Sie ein Chat-Panel hinzu, um fortzufahren.