Jitterbit Reaktive, Kontextuelle und Salesforce Q&A-Agenten

Übersicht

Jitterbit bietet allen Kunden über den Jitterbit Marketplace die folgenden Agenten an. Diese Agenten sind für Lernzwecke konzipiert, um Organisationen die einfache Einführung von KI zu erleichtern:

• Reaktiver Agent: Ein grundlegender KI-Agent, der über keine Erinnerung und keinen Kontext verfügt.

• Kontextueller Agent: Ein grundlegender KI-Agent mit Erinnerung und Kontext.

• Salesforce Q&A-Agent: Ein grundlegender KI-Agent mit Erinnerung und Kontext, der ein spezifisches Tool verwendet, um bestimmte Fragen zu den Salesforce-Kontodetails zu beantworten.

Jeder Agent ist für Q&A-Interaktionen konzipiert, variiert jedoch in seiner Komplexität, von dem einfachsten KI-Agenten ohne Erinnerung oder Kontext bis hin zu einem, der Retrieval-Augmented Generation (RAG) verwendet. Sie nutzen Slack als Mechanismus zur Interaktion, können jedoch mit Ihrer bevorzugten Schnittstelle verwendet werden, sei es eine Chat-Anwendung (wie Microsoft Teams), Mikrodienste, SaaS-Apps (wie Salesforce) oder eine Anwendung, die mit dem Jitterbit App Builder erstellt wurde.

Dieses Dokument erklärt, wie man diesen KI-Agenten einrichtet und betreibt. Es behandelt die Architektur und Voraussetzungen, Beispielaufforderungen, die zeigen, was der Agent tun kann, sowie die Schritte zur Installation, Konfiguration und Betrieb des KI-Agenten.

Architektur des KI-Agenten

Das folgende Diagramm zeigt die Architektur, die in den reaktiven, kontextuellen und Salesforce Q&A-Agenten implementiert ist:

Voraussetzungen

Um diese Agenten zu verwenden, sind die folgenden Komponenten erforderlich oder werden im Design des Agenten vorausgesetzt.

Harmony-Komponenten

Sie benötigen eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten:

• Jitterbit Studio
• Jitterbit API Manager
• Jitterbit Cloud Datastore (optional) (Gilt nur für die kontextuellen und Salesforce Q&A-Agenten)

Unterstützte Endpunkte

Die folgenden Endpunkte sind in das Design des Agenten integriert.

Großes Sprachmodell (LLM)

Der KI-Agent verwendet Azure OpenAI als LLM-Anbieter. Um Azure OpenAI zu nutzen, benötigen Sie ein Microsoft Azure-Abonnement mit Berechtigungen, um Azure OpenAI mit einem bereitgestellten gpt-4o-Modell zu erstellen und zu verwalten.

Chat-Schnittstelle

Das Design des Agenten integriert Slack als Chat-Schnittstelle zur Interaktion mit dem KI-Agenten.

Beispielaufforderungen

Hier sind Beispielaufforderungen, die der Agent bearbeiten kann:

• "Was ist die Hauptstadt der USA?"
• "Wer war der erste Präsident Indiens?"

Wenn Sie den Salesforce Q&A-Agenten verwenden, um Kontodetails für einen Kunden zu erhalten:

• "Können Sie mir die Details für den Kunden 'ABC Inc.' geben?"

Installation, Konfiguration und Betrieb

Befolgen Sie diese Schritte, um diesen KI-Agenten zu installieren, zu konfigurieren und zu betreiben:

1. Anpassungen herunterladen und das Studio-Projekt installieren.
2. Projekt-Workflows überprüfen.
3. Microsoft Azure-Ressourcen erstellen.
4. Jitterbit Cloud Datastore vorbereiten.
5. Projektvariablen konfigurieren.
6. Verbindungen testen.
7. Das Projekt bereitstellen.
8. Die Jitterbit benutzerdefinierte API erstellen.
9. Die Slack-App erstellen, die Slack-Verbindung testen und das Projekt erneut bereitstellen.
10. Die Projekt-Workflows auslösen.
11. Fehlerbehebung.

Anpassungen herunterladen und das Projekt installieren

Befolgen Sie diese Schritte, um Anpassungsdateien herunterzuladen und das Studio-Projekt zu installieren:

1. Melden Sie sich im Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.

2. Je nach Bedarf finden Sie einen dieser Agenten:

   • Reaktiver Agent
   • Kontextueller Agent
   • Salesforce Q&A Agent

   Um den Agenten zu finden, können Sie die Suchleiste verwenden oder im Filter-Bereich unter Typ AI-Agent auswählen, um die Anzeige auf die verfügbaren AI-Agenten zu beschränken.

3. Klicken Sie auf den Dokumentation-Link des AI-Agenten, um dessen Dokumentation in einem separaten Tab zu öffnen. Halten Sie den Tab geöffnet, um später darauf zurückzugreifen.

4. Klicken Sie auf Projekt starten, um einen zweistufigen Konfigurationsdialog zu öffnen, um Anpassungen herunterzuladen und den AI-Agenten als Studio-Projekt zu importieren.

5. Im Konfigurationsschritt 1, Anpassungen herunterladen, kann die folgende Datei verwendet werden, um die Slack-App zu erstellen. Wählen Sie die Datei aus und klicken Sie auf Dateien herunterladen:

   • Slack-App-Manifestdatei: slack_app_manifest.json

   Hinweis

   Der Konfigurationsdialog enthält eine Warnung, das Template nicht zu importieren, bevor die Endpunktanpassungen angewendet werden. Diese Warnung gilt nicht für diesen AI-Agenten und kann ignoriert werden. Befolgen Sie die empfohlene Reihenfolge der Schritte in dieser Dokumentation.

   Klicken Sie auf Weiter.

6. Im Konfigurationsschritt 2, Neues Projekt erstellen, wählen Sie eine Umgebung aus, in der Sie das Studio-Projekt erstellen möchten, und klicken Sie dann auf Projekt erstellen.

7. Ein Fortschrittsdialog wird angezeigt. Nachdem angezeigt wird, dass das Projekt erstellt wurde, verwenden Sie den Dialoglink Gehe zu Studio oder öffnen Sie das Projekt direkt von der Studio Projekte Seite.

Projekt-Workflows überprüfen

Überprüfen Sie im geöffneten Studio-Projekt die Workflows sowie die folgenden Beschreibungen, um zu verstehen, was sie tun.

Haupteintrag - Slack API-Anforderungs-Handler

Dieser Workflow verwaltet eingehende Slack-Bot-Anfragen. Er wird über eine benutzerdefinierte Jitterbit-API ausgelöst, jedes Mal, wenn Ihr Team mit der Slack-Bot-Chat-Benutzeroberfläche interagiert (d. h. eine Slack-Nachricht an ihn sendet). Die Konfiguration der benutzerdefinierten Jitterbit-API wird in Erstellen der Jitterbit benutzerdefinierten API weiter unten auf dieser Seite beschrieben.

Haupt - KI-Agenten-Tools-Logik

Dieser Workflow verarbeitet Benutzeranfragen, die vom Haupteintrag - Slack API-Anforderungs-Handler empfangen werden, verwaltet Anfragen an das große Sprachmodell (LLM) und erfasst dessen Antworten.

Dienstprogramm - Bot-Chat-Cloud-Datenspeicher

(Nur anwendbar auf die kontextuellen und Salesforce Q&A-Agenten.)

Dieser Workflow verwaltet die Speicherung des Bot-Chatverlaufs, der für die Bereitstellung von Gedächtniskontext für LLMs unerlässlich ist. Er nutzt Jitterbit Cloud Datastore zu diesem Zweck.

Werkzeug - Salesforce-Kontodetails abrufen

(Nur anwendbar auf den Salesforce Q&A-Agenten.)

Dieser Workflow ist darauf ausgelegt, spezifische Salesforce-Kontodetails abzurufen, wenn ein Werkzeugaufruf initiiert wird.

Microsoft Azure-Ressourcen erstellen

Erstellen Sie die folgenden Microsoft Azure-Ressourcen und behalten Sie die folgenden Informationen zur Konfiguration des KI-Agenten. Um diese Ressourcen zu erstellen und zu verwalten, müssen Sie über ein Microsoft Azure-Abonnement mit den entsprechenden Berechtigungen verfügen.

Azure OpenAI-Ressource

Sie müssen eine Azure OpenAI-Ressource erstellen und ein gpt-4o-Modell über das Azure AI Foundry-Portal bereitstellen.

Sie benötigen den Bereitstellungsnamen, die Azure OpenAI-Endpunkt-URL und den API-Schlüssel, um die Werte der Azure OpenAI-Projektvariablen zu bestimmen. Um diese Werte zu finden:

1. Öffnen Sie im Azure AI Foundry-Portal die spezifische OpenAI-Ressource.

2. Die Werte, die für die Endpunkt-URL (azure_openai_base_url) und den API-Schlüssel (azure_openai_api_key) verwendet werden sollen, werden auf der Startseite der Ressource angezeigt:

   

3. Wählen Sie im Navigationsmenü unter Gemeinsame Ressourcen Bereitstellungen aus. Der Bereitstellungsname (Azure_OpenAI_Deployment_Name) wird angezeigt.

Jitterbit Cloud-Datenspeicher vorbereiten

(Nur anwendbar für die kontextuellen und Salesforce Q&A-Agenten.)

Erstellen Sie zwei Schlüsselspeicher im Jitterbit Cloud-Datenspeicher, askjb_user_session und askjb_q_and_a, deren Felder die in den folgenden Tabellen aufgeführten Namen und Typen haben.

Wenn Sie benutzerdefinierte Felder hinzufügen, verwenden Sie die Tabellen unten, um zu bestimmen, ob jedes Feld in der Benutzeroberfläche des Cloud-Datenspeichers auf Erforderlich umgeschaltet werden sollte. Die Felder AlternativeKey und Value sind Standardfelder, die nicht entfernt oder umgeschaltet werden können.

Sie können die Werte der Felder, deren Werte automatisch ausgefüllt oder nicht verwendet werden, leer lassen.

askjb_user_session

Dieser Schlüsselspeicher wird verwendet, um Sitzungen für Benutzer zu verwalten.

askjb_q_and_a

Dieser Schlüsselspeicher speichert den Chatverlauf eines Bots, um den Gedächtniskontext für das LLM bereitzustellen. Er wird von der Integration verwendet, um die Frage- und Antworthistorie zu speichern. Alle Daten werden während der Interaktion automatisch eingegeben.

Projektvariablen konfigurieren

Im im Marketplace installierten Studio-Projekt müssen Werte für die folgenden Projektvariablen festgelegt werden.

Um Projektvariablen zu konfigurieren, verwenden Sie das Aktionsmenü des Projekts, um Projektvariablen auszuwählen. Dadurch wird ein Schublade am unteren Rand der Seite geöffnet, in der Sie die Werte überprüfen und festlegen können.

Cloud Datastore

(Nur anwendbar für die kontextbezogenen und Salesforce Q&A-Agenten.)

Salesforce

(Nur anwendbar für den Salesforce Q&A-Agenten.)

Azure OpenAI

Slack

Testverbindungen

Testen Sie die Endpunktkonfigurationen, um die Konnektivität mit den definierten Projektvariablenwerten zu überprüfen.

Um Verbindungen zu testen, gehen Sie zum Tab Projektendpunkte und -verbindungen in der Design-Komponentenpalette, fahren Sie mit der Maus über jeden Endpunkt und klicken Sie auf Testen.

Projekt bereitstellen

Stellen Sie das Projekt bereit im Studio.

Um das Projekt bereitzustellen, verwenden Sie das Aktionsmenü des Projekts, um Bereitstellen auszuwählen.

Erstellen Sie die benutzerdefinierte Jitterbit-API

Erstellen Sie eine benutzerdefinierte API für die Slack Bot Request-Operation im Workflow Main Entry - Slack API Request Handler.

Um die API zu erstellen, verwenden Sie das Aktionsmenü der Operation, um Als API veröffentlichen oder Als API mit KI veröffentlichen auszuwählen.

Konfigurieren Sie die folgenden Einstellungen:

Behalten Sie die Dienst-URL der veröffentlichten API zur Verwendung beim Erstellen der Slack-App. Die Dienst-URL finden Sie im API-Details-Bereich auf dem Tab Dienste, indem Sie über die Aktionen-Spalte des Dienstes fahren und auf API-Dienst-URL kopieren klicken.

Erstellen Sie die Slack-App, testen Sie die Verbindung und setzen Sie das Projekt erneut ein

Um die Chat-Oberfläche des KI-Agenten in Slack zu erstellen, erstellen Sie eine Slack-App mit der im Lieferumfang der Anpassungsdateien dieses KI-Agenten enthaltenen Slack-App-Manifestdatei. Oder erstellen Sie sie von Grund auf neu.

Wenn Sie die bereitgestellte Slack-App-Manifestdatei (slack_app_manifest.json) verwenden, müssen Sie die folgenden Platzhalter durch Ihre eigenen Konfigurationswerte ersetzen:

Nachdem Sie die Slack-App installiert haben, erhalten Sie das Bot-Token.

Öffnen Sie die Konfiguration der Projektvariablen erneut und geben Sie das Bot-Token für den Wert der Projektvariablen bot_oauth_user_token ein.

Sobald das Bot-Token festgelegt ist, testen Sie die Slack-Verbindung und setzen Sie das Projekt erneut ein.

Triggern Sie die Projekt-Workflows

Der Haupt-Workflow, Main Entry - Slack API Request Handler, wird von der Jitterbit benutzerdefinierten API ausgelöst. Dieser Workflow wird von Slack über die benutzerdefinierte API Slack Bot API Request Handler ausgelöst. Das Senden einer Direktnachricht an die Slack-App initiiert den Trigger der benutzerdefinierten API.

Alle anderen Workflows werden durch andere Operationen ausgelöst und sind nachgelagert zu dem oben genannten. Sie sind nicht dafür gedacht, eigenständig ausgeführt zu werden.

Fehlersuche

Wenn Sie auf Probleme stoßen, überprüfen Sie die folgenden Protokolle für detaillierte Informationen zur Fehlersuche:

• API-Protokolle
• Betriebsprotokolle

Für zusätzliche Unterstützung kontaktieren Sie Jitterbit-Support.