Verbinden Sie einen KI-Agenten mit Jitterbit App Builder

Übersicht

Dieser Leitfaden zeigt, wie Sie den App Builder über eine REST-API-Datenquelle mit einem Jitterbit KI-Agenten verbinden. Dies ist der erste Schritt zur Einrichtung der Conversational UI-Funktion.

Die Verbindung umfasst die Erstellung eines REST-Datenquellenservers, die Konfiguration eines Endpunkts für den KI-Agenten und die Zuordnung der Spaltennutzungstypen, die die Conversational UI benötigt, um die Eingabe- und Antwortfelder zu identifizieren.

Erstellen Sie einen REST-Datenquellenserver

Melden Sie sich bei Ihrer App Builder-Instanz an.
Greifen Sie auf die IDE zu.
Klicken Sie unter Verbinden auf Datenserver.
Klicken Sie auf + Server. Der Dialog Servereinstellungen öffnet sich.
Konfigurieren Sie den Server:
- Servername: Geben Sie einen beschreibenden Namen für den Server ein.
- Typ: Wählen Sie REST API.
- URL: Geben Sie die Basis-URL des REST-API-Endpunkts Ihres KI-Agenten ein.
- Anforderungsinhaltstyp und Antwortinhaltstyp: Wählen Sie JSON.
Klicken Sie auf Speichern und schließen Sie dann den Dialog.

Wichtig

Nur Benutzer, die zu einer Gruppe mit Zugriff auf diese Datenquelle gehören, können die Conversational UI sehen und verwenden.

Konfigurieren Sie den Endpunkt

Wählen Sie in der Liste Datenserver den neuen Server aus, den Sie gerade erstellt haben. Klicken Sie auf das -Symbol, um weitere Details anzuzeigen, und klicken Sie auf die Schaltfläche Endpunkte.
(Optional) Fügen Sie im Panel Webdienstparameter alle für alle Endpunkte erforderlichen Parameter hinzu, z. B. Header-Parameter für die API-Authentifizierung. Klicken Sie auf + Parameter, füllen Sie die Felder aus und klicken Sie dann auf das -Symbol, um zu speichern.
Klicken Sie im Panel Endpunkte auf + Endpunkt. Eine neue Zeile erscheint.
Konfigurieren Sie den Endpunkt:
- Name: Geben Sie einen beschreibenden Namen ein.
- Endpunkt: Geben Sie den Pfad des Endpunkts des KI-Agenten ein.
- Methode: Wählen Sie die HTTP-Methode (typischerweise POST).
Klicken Sie auf das -Symbol, um den Endpunkt zu speichern.
Fügen Sie im Panel Endpunktparameter Parameter für die Agenteninteraktion hinzu. Es gibt zwei Möglichkeiten, dies zu tun:
- Manuelle Erstellung: Klicken Sie auf + Parameter, um Endpunktparameter manuell hinzuzufügen. Der folgende Dialog öffnet sich:
  
  Nachdem Sie alle Parameter hinzugefügt haben, kehren Sie zum Panel Endpunkte zurück und klicken Sie auf Verbindung testen, um zu überprüfen, ob die Verbindung funktioniert. Klicken Sie anschließend auf Entdecken und klicken Sie im Dialog auf Entdecken, um das Schema der API zu importieren. Das importierte Schema erscheint im Panel SQL-Ergebnisse.
- Automatische Befüllung: Für POST-Endpunkte können Sie zuerst die Schaltfläche Entdecken im Panel Endpunkte klicken. Geben Sie im sich öffnenden Dialog einen Beispiel-JSON-Anforderungstext im Feld Anforderungstext ein und klicken Sie dann auf Entdecken.
  
  Klicken Sie auf Entdecken. Das Panel SQL-Ergebnisse zeigt die Tabellen für Ihre REST-API, während das Panel Text-Ergebnisse JSON basierend auf dem von Ihnen eingegebenen Anforderungstext anzeigt.

Klicken Sie im Panel SQL-Ergebnisse auf das -Symbol für jede importierte Tabelle. Die Seite zur Tabellendefinition öffnet sich, wo Sie die Spaltennutzungstypen konfigurieren können. Die Conversational UI benötigt spezifische Spaltennutzungstypen, um zu identifizieren, welche Parameter die Nachricht des Benutzers und die Antwort des Agenten tragen. Die folgenden Nutzungstypen sind verfügbar:

Nutzungstyp	Beschreibung
Agentenaufforderung	Der Parameter, der die Nachricht des Benutzers an den Agenten überträgt.
Agentenantwort	Der Parameter, der die Antwort des Agenten an den Benutzer überträgt.
Agentenbenutzer - Benutzer-ID	(Optional) Ein Parameter, der den aktuellen Benutzer nach ID identifiziert.
Agentenbenutzer - Email	(Optional) Ein Parameter, der den aktuellen Benutzer nach Email-Adresse identifiziert.
Agentenbenutzer - Benutzername	(Optional) Ein Parameter, der den aktuellen Benutzer nach Benutzernamen identifiziert.
Agentensitzung	(Optional) Ein Parameter, der die ID der aktuellen Chatsitzung überträgt.

Tipp

Für Jitterbit Marketplace KI-Agenten wird die Spalte, die die Nachricht des Benutzers enthält, typischerweise "prompt" genannt (entsprechend dem Agent Prompt Nutzungstyp), und die Spalte, die die Antwort des Agenten enthält, wird typischerweise "message" genannt (entsprechend dem Agent Response Nutzungstyp). Konsultieren Sie die Dokumentation Ihres spezifischen Agenten für die genauen Feldnamen.

Für jede Spalte, die einem Nutzungstyp entspricht, doppelklicken Sie auf eine Zeile der Spalte oder klicken Sie auf das -Symbol, um die Einstellungen zu öffnen, und setzen Sie dann das Feld Column Usage Type auf den entsprechenden Wert.

Next steps

Nachdem Sie Ihren KI-Agenten verbunden haben, können Sie mit den nächsten Schritten zur Einrichtung der Conversational UI-Funktion fortfahren, indem Sie einen Agenten in der IDE einrichten. Siehe Agenten einrichten, um fortzufahren.