Zum Inhalt springen

Jitterbit Knowledge Agent

Übersicht

Jitterbit stellt den Knowledge Agent Kunden über den Jitterbit Marketplace zur Verfügung. Dieser Agent soll es dem internen Team deiner Organisation ermöglichen, intelligente Antworten aus den internen Daten deiner Organisation zu erhalten. Dieser Agent nutzt die Retrieval-Augmented Generation (RAG)-Technik, die LLM-Reasoning mit Zugang zu externen Tools und Datenquellen kombiniert. Er führt die folgenden Aufgaben aus:

  • Verbindet sich mit den folgenden Quellen und ruft Informationen davon ab, indem Jitterbit Studio verwendet wird:

    • Atlassian Confluence-Seiten
    • Atlassian Jira-Issues
    • Google Drive-Dokumente
    • Salesforce-Support-Cases (aus dem Case-Objekt)
  • Integriert sich mit einem LLM, um einen intelligenten KI-Chatbot mit Daten aus den oben genannten Quellen zu betreiben, auf die über eine mit Jitterbit API Manager erstellte benutzerdefinierte API zugegriffen wird.

Dieses Dokument erläutert, wie man diesen KI-Agent einrichtet und betreibt. Es behandelt die Architektur und die Voraussetzungen, Beispielprompts, die zeigen, was der Agent leisten kann, und Schritte zur Installation, Konfiguration und zum Betrieb des KI-Agenten.

KI-Agent-Architektur

Das folgende Diagramm zeigt die im Knowledge Agent implementierte Architektur:

Agenten-Datenfluss

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: curve: 'monotoneX' nodeSpacing: 140 --- graph classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px %% Top diagram SLACKAPP(fab:fa-slack
Slack app/bot) JB_CUSTOM_API(
Jitterbit API Manager
custom API) REQ_AZURE_OPENAI(Request to
Azure OpenAI) SLACK_API_REQ_H(Slack
API request handler
workflow) RES_AZURE_OPENAI(Response from Azure OpenAI) TIMEOUT(Timeout handling) subgraph LIVE_AGENT_DATA_FLOW[ ] direction RL subgraph EXTAPP[**External app**] SLACKAPP end JB_CUSTOM_API subgraph STUDIO[ **Jitterbit Studio**] REQ_AZURE_OPENAI RES_AZURE_OPENAI SLACK_API_REQ_H TIMEOUT end end SLACKAPP -->|Request| JB_CUSTOM_API JB_CUSTOM_API -->|Request| SLACK_API_REQ_H JB_CUSTOM_API -->|Response| SLACKAPP SLACK_API_REQ_H -->|Response|JB_CUSTOM_API SLACK_API_REQ_H --> REQ_AZURE_OPENAI REQ_AZURE_OPENAI --> RES_AZURE_OPENAI RES_AZURE_OPENAI --> SLACK_API_REQ_H REQ_AZURE_OPENAI --> TIMEOUT --> SLACK_API_REQ_H classDef Clear fill:white, stroke:white, stroke-width:0px, rx:15px, ry:15px classDef Plain fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px class LIVE_AGENT_DATA_FLOW Clear class EXTAPP,APIM,STUDIO Plain

Anfängliche Datenladung und Workflows zur Datenwartung

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 5 curve: monotoneX --- graph LR classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px %% Bottom diagram SCHEDULE(Schedule) QUERY(Query proprietary data) UPDATE(Update storage) KICKOFF(Kick off indexer) AI_BLOB@{ shape: cloud, label: "Azure AI Blob Storage" } AI_INDEXER@{ shape: cloud, label: "Azure AI indexer" } AI_INDEX@{ shape: cloud, label: "Azure AI index" } subgraph INITIAL_DATA_LOAD[ ] direction LR SCHEDULE --> QUERY --> UPDATE --> KICKOFF --> AI_INDEXER --> AI_INDEX UPDATE --> AI_BLOB --> AI_INDEXER end classDef Clear fill:white, stroke:white, stroke-width:0px, rx:15px, ry:15px class INITIAL_DATA_LOAD Clear

Voraussetzungen

Um den Knowledge Agent zu verwenden, sind die folgenden Komponenten erforderlich oder in der Designentwicklung des Agenten vorgesehen.

Harmony-Komponenten

Du musst eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten besitzen:

Unterstützte Endpoints

Die folgenden Endpoints sind in das Design des Agenten integriert.

Large Language Model (LLM)

Der KI-Agent verwendet Azure OpenAI als LLM-Anbieter. Um Azure OpenAI zu verwenden, musst du ein Microsoft Azure-Abonnement mit Berechtigungen zur Erstellung und Verwaltung der folgenden Ressourcen haben:

  • Azure OpenAI-Ressource mit einem bereitgestellten gpt-4o oder gpt-4.1-Modell.
  • Azure Storage mit einem Blob-Container zum Speichern abgerufener Daten.
  • Azure AI Search mit einem Suchdienst, der mit einem Index und einem Indexer konfiguriert werden kann.

Tipp

Preisinformationen findest du unter Azure AI Search-Preisstufen.

Wissensdatenbank

Du kannst einen oder mehrere dieser Endpoints als Wissensdatenbank für diesen KI-Agent verwenden:

  • Atlassian Confluence: Die Quelle für Confluence-Seiten.
  • Atlassian Jira: Die Quelle für Jira-Issues.
  • Google Drive: Die Quelle für Dateien, die auf einem gemeinsam genutzten Google Drive gespeichert sind.
  • Salesforce: Die Quelle deiner Kundenunterstützungs-Cases aus dem Case-Objekt.

Chat-Schnittstelle

Das Design des Agenten integriert Slack als Chat-Schnittstelle für die Interaktion mit dem KI-Agent. Wenn du eine andere Anwendung als Chat-Schnittstelle verwenden möchtest, sind ein separater Workflow und Anweisungen für ein generisches API-Setup im KI-Agent enthalten.

Beispielprompts

Hier sind Beispielprompts, die der Knowledge Agent mit Zugriff auf die entsprechenden Daten verarbeiten kann. Der Agent kann Informationen über einen oder alle verbundenen Endpoints hinweg finden.

  • „Ich habe ein Problem mit der Komponente ‚ABC'. Kannst du mir damit helfen?"
  • „Wie kann ich mich mit einer MySQL-Datenbank über JDBC verbinden?"
  • „Kannst du mir Details zu Jira-Ticket Nummer 123 geben?"
  • „Gibt es Jira-Tickets bezüglich des SQL-Connectors?"
  • „Was ist die Sicherheitsrichtlinie für die Installation von Software auf meinem Arbeitscomputer?" (Es könnte ein Dokument auf Google Drive oder eine Confluence-Seite zu diesem Thema geben.)

Installation, Konfiguration und Betrieb

Folge diese Schritte, um diesen KI-Agent 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. Slack-App erstellen.
  5. Google-Dienstkonto und gemeinsames Laufwerk einrichten.
  6. Projektvariablen konfigurieren.
  7. Verbindungen testen.
  8. Projekt bereitstellen.
  9. Benutzerdefinierte Jitterbit-API erstellen.
  10. Projekt-Workflows überprüfen.
  11. Projekt-Workflows auslösen.
  12. Fehlerbehebung.

Anpassungen herunterladen und das Projekt installieren

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

  1. Melde dich beim Harmony-Portal unter https://login.jitterbit.com an und öffne Marketplace.

  2. Suche den KI-Agent mit dem Namen Jitterbit Knowledge Agent. Du kannst die Suchleiste verwenden oder im -Bereich Filter unter Typ die Option KI-Agent auswählen, um die Anzeige auf die verfügbaren KI-Agenten zu beschränken.

  3. Klicke auf den Link Dokumentation des KI-Agenten, um die Dokumentation in einem separaten Tab zu öffnen. Halte den Tab offen, um später darauf zu verweisen.

  4. Klicke auf Projekt starten, um einen zweistufigen Konfigurationsdialog zu öffnen und so die Anpassungen herunterzuladen und den KI-Agent als Studio-Projekt zu importieren.

    Hinweis

    Wenn du den KI-Agent noch nicht erworben hast, wird stattdessen Agent abrufen angezeigt. Klicke darauf, um einen Informationsdialog zu öffnen, und klicke dann auf Senden, um einen Vertreter zu kontaktieren, der dich zum Kauf des KI-Agenten berät.

  5. In Konfigurationsschritt 1, Anpassungen herunterladen, werden die folgenden Dateien bereitgestellt, um die Einrichtung des Index und des Indexers in Azure AI Search zu erleichtern und die Slack-App zu erstellen. Wähle die Dateien aus und klicke auf Dateien herunterladen:

    • Azure AI Search Index- und Indexer-JSON-Definitionsdateien

      • Azure_AI_Search_Datasource_Definition.json
      • Azure_AI_Search_Index_Definition.json
      • Azure_AI_Search_Indexer_Definition.json
    • Slack-App-Manifestdatei

      • slack_app_manifest.json

    Tipp

    Der Konfigurationsdialog enthält eine Warnung, die Vorlage nicht zu importieren, bevor Endpunktanpassungen angewendet werden. Diese Warnung gilt nicht für diesen KI-Agent und kann ignoriert werden. Befolge die empfohlene Reihenfolge der Schritte in dieser Dokumentation.

    Klicke auf Weiter.

  6. In Konfigurationsschritt 2, Neues Projekt erstellen, wähle eine Umgebung, in der du das Studio-Projekt erstellen möchtest, und klicke auf Projekt erstellen.

  7. Ein Fortschrittsdialog wird angezeigt. Nachdem angezeigt wird, dass das Projekt erstellt wurde, verwende den Dialog-Link Zu Studio gehen oder öffne das Projekt direkt über die Seite Projekte in Studio.

Microsoft Azure-Ressourcen erstellen

Erstelle die folgenden Microsoft Azure-Ressourcen und speichere die folgenden Informationen zur Konfiguration des KI-Agenten. Um diese Ressourcen zu erstellen und zu verwalten, benötigst du ein Microsoft Azure-Abonnement mit den entsprechenden Berechtigungen.

Azure Blob-Container

Du musst einen Azure Blob-Container erstellen, um Kundendetails zu speichern. Daten aus dem Blob-Container werden mittels eines Index und eines Indexers in Azure AI Search indiziert.

Du benötigst die SAS-URL des Containers für die Bestimmung der Werte der Azure Blob Storage-Projektvariablen. Um die SAS-URL zu generieren:

  1. Im Azure-Portal navigierst du zu Speicherkonten und öffnest das spezifische Speicherkonto.
  2. Wähle im Ressourcenmenü unter Datenspeicherung die Option Container aus und öffne den spezifischen Container.
  3. Wähle im Ressourcenmenü unter Einstellungen die Option Shared Access Tokens aus.
  4. Verwende das Menü Berechtigungen, um sicherzustellen, dass die SAS-URL (Shared Access Signature) für diesen Container mindestens die Berechtigungen Lesen und Schreiben hat:

SAS-URL-Berechtigungen

  1. Klicken Sie auf SAS-Token und URL generieren.
  2. Kopieren Sie die unten angezeigte Blob-SAS-URL.
  3. Bestimmen Sie die Werte der Azure Blob Storage-Projektvariablen aus der SAS-URL. Die SAS-URL hat das Format {{ azure_blob_base_url }}/{{ Azure_Blob_Container_Name }}?{{ azure_blob_sas_token }}.

Falls Sie die JSON-Definitionsdateien aus den Anpassungsdateien des KI-Agenten verwenden, um den Index und den Indexer zu generieren, benötigen Sie auch den Azure Blob Storage-Kontoschlüssel. Zum Anzeigen von Kontozugriffsschlüsseln:

  1. Navigieren Sie im Azure-Portal zu Speicherkonten und öffnen Sie das entsprechende Speicherkonto.
  2. Wählen Sie im Ressourcenmenü unter Sicherheit + Netzwerk die Option Zugriffsschlüssel aus.
  3. Klicken Sie auf Schlüssel anzeigen, um den während der Konfiguration von Azure AI Search zu verwendenden Zugriffsschlüssel anzuzeigen.

    Speicherkontoschlüssel

Azure AI Search-Dienst

Sie müssen einen Azure AI Search-Dienst erstellen und dessen Index sowie Indexer konfigurieren, um die Daten aus dem Blob-Container zu verarbeiten.

Sie benötigen die URL und den API-Schlüssel des Azure AI Search-Diensts, um die Werte der Azure AI Search-Projektvariablen zu bestimmen:

Sie können die JSON-Definitionsdateien aus den Anpassungsdateien des KI-Agenten verwenden, um den Index und den Indexer zu generieren, oder diese selbst erstellen.

Falls Sie die bereitgestellten Definitionsdateien verwenden, müssen Sie die folgenden Platzhalter durch Ihre eigenen Konfigurationswerte ersetzen:

Azure_AI_Search_Indexer_Definition.json

Platzhalter Beschreibung
{{Your Azure AI Search Service Name}} Der Name des Azure AI Search-Diensts.

Azure_AI_Search_Datasource_Definition.json

Platzhalter Beschreibung
{{Your Azure AI Search Service Name}} Der Name des Azure AI Search-Diensts.
{{Your Azure Blob Account Name}} Der Name des Azure Blob-Kontos.
{{Your Azure Blob Account Key}} Der Zugriffsschlüssel für das Azure Blob Storage-Konto, erhalten wie in Azure Blob-Container oben beschrieben.
{{your_azure_blob_container_name}} Der Name des Azure Blob-Containers.

Azure OpenAI-Ressource

Sie müssen eine Azure OpenAI-Ressource erstellen und ein gpt-4o- oder gpt-4.1-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 für die Endpunkt-URL (azure_openai_base_url) und den API-Schlüssel (azure_openai_api_key) werden auf der Landingpage der Ressource angezeigt:

    AI Foundry-Schlüssel und URL

  3. Wählen Sie im Navigationsmenü unter Freigegebene Ressourcen die Option Bereitstellungen. Der Bereitstellungsname (Azure_OpenAI_Deployment_Name) wird angezeigt.

Slack-App erstellen

Um die Knowledge Agent-Chatschnittstelle in Slack zu erstellen, führen Sie diese Schritte aus:

  1. Erstellen Sie eine Slack-App mithilfe der Slack-App-Manifestdatei (slack_app_manifest.json), die in den Anpassungsdateien dieses KI-Agenten enthalten ist. Alternativ können Sie die App von Grund auf neu erstellen.

  2. Wenn Sie die bereitgestellte Manifestdatei verwenden, ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Konfigurationswerte:

    Platzhalter Beschreibung
    {{Replace with Slack bot name}} Der Name, den Ihr Slack-Bot haben soll, wie er Benutzern angezeigt wird. Ersetzen Sie diesen Wert an zwei Stellen im Manifest.
    {{Replace with Jitterbit API URL}} Die Service-URL der benutzerdefinierten Jitterbit-API, die Sie unter Benutzerdefinierte Jitterbit-API erstellen erstellt haben.
  3. Installieren Sie die App in Ihrem Slack-Arbeitsbereich.

  4. Besorgen Sie sich das Bot-Token (für das Feld Bot User OAuth Token der Slack-Verbindung) und geben Sie seinen Wert für die Projektvariable slack_bot_oauth_user_token ein.

  5. Konfigurieren Sie die Projektvariable slack_channel_name mit dem Kanal, in dem Benachrichtigungen gesendet werden sollen.

  6. Geben Sie den Bot-Token-Wert für die Projektvariable slack_bot_oauth_user_token und den Kanalnamen für die Projektvariable slack_channel_name ein. Diese konfigurieren Sie im nächsten Schritt.

Google-Dienstkonto und freigegebenes Laufwerk einrichten

Diese Einrichtung ist nur erforderlich, wenn Sie den Workflow Data upload Utility - Google Drive to Azure Blob verwenden. Sie müssen ein aktives Google Cloud-Projekt haben, um fortfahren zu können. Falls Sie noch kein Projekt haben, können Sie eines erstellen, indem Sie Googles Anleitung befolgen.

Google-Dienstkonto erstellen

Führen Sie die folgenden Schritte aus, um einen Schlüssel für das Google-Dienstkonto zu erstellen, damit das Hilfsprogramm sicher auf Ihre Google Drive-Dateien zugreifen kann:

  1. Verwenden Sie in der Google Cloud-Konsole die Suchleiste, um die Seite Dienstkonten zu finden und zu navigieren.

  2. Falls Sie bereits über ein Dienstkonto verfügen, das Sie verwenden möchten, fahren Sie mit Schritt 3 fort. Klicken Sie andernfalls auf Dienstkonto erstellen, geben Sie einen Namen ein und klicken Sie auf Fertig. Es sind keine zusätzlichen Berechtigungen oder Zugriffsrechte erforderlich.

    Google Cloud – Dienstkonto erstellen

  3. Wählen Sie das Dienstkonto aus, um seine Dienstkonto-Details zu öffnen:

    Google Cloud – Dienstkonto-Details

  4. Navigieren Sie zur Registerkarte Schlüssel und verwenden Sie das Menü Schlüssel hinzufügen, um Neuen Schlüssel erstellen auszuwählen.

    Google Cloud – Dienstkonto-Schlüssel

  5. Wählen Sie JSON als Schlüsseltyp und klicken Sie auf Erstellen. Eine JSON-Datei mit den Anmeldedaten wird auf Ihren Computer heruntergeladen.

  6. Öffnen Sie die heruntergeladene JSON-Datei, um die folgenden Werte zu finden, die zum Konfigurieren der Google Drive-Projektvariablen erforderlich sind:

    • client_email: Dies ist der Wert für die Projektvariable Google_Client_Email und wird benötigt, um das freigegebene Google-Laufwerk im nächsten Abschnitt zu konfigurieren.
    • private_key: Dies ist der Wert für die Projektvariable Google_Private_Key.
  7. Aktivieren Sie die Google Drive API in Ihrem Google Cloud-Konto:

    1. Verwenden Sie in der Google Cloud-Konsole die Suchleiste, um die Seite APIs & Services zu finden und aufzurufen.

    2. Öffnen Sie die API Library und wählen Sie die Google Drive API aus:

      Google Cloud Drive API

    3. Klicken Sie auf die Schaltfläche Enable:

      Google Cloud enable API

Konfigurieren Sie das gemeinsame Google Drive

Das gemeinsame Google Drive sollte wie folgt konfiguriert werden, um dem Dienstprogramm Zugriff auf alle Dateien zu gewähren, die Sie darin hochladen:

  1. Erstellen Sie ein gemeinsames Google Drive, falls Sie noch keins haben.

  2. Öffnen Sie das gemeinsame Drive und kopieren Sie seine ID aus der Browser-URL. Die ID ist die lange Zeichenkette am Ende. Wenn die URL beispielsweise https://drive.google.com/drive/folders/dftg-LbGrP7hdfd lautet, ist die ID dftg-LbGrP7hdfd. Diese ID ist der Wert für die Projektvariable Google_Drive_ID beim Konfigurieren von Google Drive-Projektvariablen.

  3. Klicken Sie oben auf der Seite auf den Namen des gemeinsamen Drives und wählen Sie Manage members aus. Ein Dialogfeld wird angezeigt.

  4. Fügen Sie im Feld Add people and groups den Wert von client_email aus der JSON-Datei ein, die Sie zuvor heruntergeladen haben.

  5. Weisen Sie dem Dienstkonto die Rolle Content manager zu und bestätigen Sie die Aktion.

Konfigurieren Sie Projektvariablen

Im Studio-Projekt, das Sie zuvor über den Marketplace installiert haben, müssen Sie Werte für die folgenden Projektvariablen festlegen.

Dies kann über das Aktionsmenü des Projekts erfolgen, um Project Variables auszuwählen und eine Schublade am unteren Rand der Seite zu öffnen, in der Sie die Werte überprüfen und festlegen können.

Salesforce

Variablenname Beschreibung
SF_Login_URL Server Host in der Salesforce-Verbindung
SF_Password Password in der Salesforce-Verbindung
SF_Security_Token Security token in der Salesforce-Verbindung
SF_User_Name Username in der Salesforce-Verbindung
SF_Cases_Incremental_Run Flag zur Steuerung, ob nur neue oder aktualisierte Salesforce-Cases seit der letzten Ausführung abgerufen werden sollen. Wenn der Wert true ist, werden nur inkrementelle (neue oder aktualisierte) Cases seit der letzten Ausführung aus Salesforce abgerufen. Wenn der Wert false ist, wird ein vollständiger Abruf ab dem Standarddatum und der Standardzeit (SF_Cases_Default_Modified_Date) durchgeführt.
SF_Cases_Default_Modified_Date Das Standarddatum und die Standardzeit, ab denen Salesforce-Cases abgerufen werden. Wird bei der ersten Ausführung oder wenn SF_Cases_Incremental_Run den Wert false hat, verwendet. Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'. Beispiel: 2024-09-11T13:00:02.000Z. Wenn dieses Datum nicht festgelegt ist, wird ein Fehler ausgelöst.

Jira

Variablenname Beschreibung
JIRA_Username Die E-Mail-Adresse, die dem Jira-Konto für die Authentifizierung zugeordnet ist.
JIRA_Token API-Token zur Authentifizierung bei der JIRA-Instanz. Für Atlassian Cloud kann man diesen Token in den Kontoeinstellungen generieren.
JIRA_Projects Jira-Projektschlüssel zum Abrufen von Problemen im Format keys=PROJECT1&keys=PROJECT2. Beispiel: keys=SUPPORT&keys=ITHELP.
JIRA_Issue_Types Liste der Jira-Problemtypen zum Abrufen, durch Kommas getrennt. Jeder Wert muss in einfache Anführungszeichen gesetzt werden. Beispiel: 'Story','Bug','Task'.
Jira_Default_Modified_Date Das Standarddatum und die Uhrzeit, ab der Jira-Probleme abgerufen werden. Wird beim ersten Ausführen oder wenn JIRA_IncrementalRun auf false gesetzt ist, verwendet. Format: yyyy-MM-dd HH:mm. Beispiel: 2025-08-07 10:00. Wenn dieses Datum nicht festgelegt ist, wird ein Fehler ausgelöst.
JIRA_Incremental_Run Flag zur Steuerung, ob nur neue oder aktualisierte Jira-Probleme seit dem letzten Ausführen abgerufen werden. Bei true werden nur inkrementelle (neue oder aktualisierte) Probleme seit dem letzten Ausführen von Jira abgerufen. Bei false wird ein vollständiger Abruf ab dem Standarddatum und der Standarduhrzeit (Jira_Default_Modified_Date) durchgeführt.
JIRA_Base_URL Die Basis-URL der Jira-Instanz, mit der eine Verbindung hergestellt werden soll. Keinen Schrägstrich am Ende hinzufügen. Beispiel: https://yourdomain.atlassian.net.

Confluence

Variablenname Beschreibung
Confluence_Wiki_UserName Der Confluence-Wiki-Benutzername.
Confluence_Wiki_Password Das Confluence-Wiki-Passwort.
Confluence_Wiki_Base_Url Die Root-URL des Confluence-Wiki für API-Aufrufe und Inhaltabruf. Beispiel: https://yourcompany.atlassian.net/wiki.

Google Drive

Variablenname Beschreibung
Google_Client_Email Die Client-E-Mail des Google-Dienstkontos, das zur Authentifizierung beim Zugriff auf Google Drive verwendet wird.
Google_Drive_Default_Modified_Date Das Standarddatum und die Uhrzeit, ab der Google Drive-Dateien gelesen werden. Wird beim ersten Ausführen oder wenn das inkrementelle Lesen deaktiviert ist, verwendet. Format: yyyy-MM-dd'T'HH:mm:ss. Beispiel: 2024-05-28T11:32:47. Wenn dieses Datum nicht festgelegt ist, wird ein Fehler ausgelöst.
Google_Drive_ID Die ID des gemeinsam genutzten Google Drive, aus dem Dateien gelesen werden. Wenn beispielsweise die URL des gemeinsam genutzten Laufwerks https://drive.google.com/drive/folders/1KTXaKx_FG7Ud8sWHf8QgG67XHy lautet, ist die Laufwerk-ID 1KTXaKx_FG7Ud8sWHf8QgG67XHy.
Google_Drive_Incremental_Run Flag zur Steuerung, ob nur neue oder aktualisierte Google Drive-Dateien seit dem letzten Ausführen abgerufen werden. Bei true werden nur inkrementelle (neue oder aktualisierte) Dateien seit dem letzten Ausführen von Google Drive abgerufen. Bei false wird ein vollständiger Abruf ab dem Standarddatum und der Standarduhrzeit (Google_Drive_Default_Modified_Date) durchgeführt.
Google_Oauth_Scopes Der OAuth-Bereich, der erforderlich ist, um dem Google-Dienstkonto Zugriff auf Google Drive zu gewähren. Geben Sie für diesen KI-Agent Folgendes ein: https://www.googleapis.com/auth/.
Google_Private_Key Der private Schlüssel des Google Cloud-Dienstkontos, das zur Authentifizierung für das Abrufen von Dateien aus Google Drive verwendet wird.

Azure Blob Storage

Variablenname Beschreibung
Azure_Blob_Container_Name Der Name des Azure Blob Storage-Containers, in dem abgerufene Daten gespeichert oder abgerufen werden. Dies ist der Teil der SAS-URL, der unmittelbar nach der Speicherkontodomain folgt. Beispiel: In https://myaccount.blob.core.windows.net/mycontainer/myblob.txt?sv=... ist der Container-Name mycontainer.
azure_blob_sas_token Das SAS-Token, das zur Authentifizierung des Zugriffs auf den Azure Blob-Container Azure_Blob_Container_Name verwendet wird. Es sollte nur der Teil nach ? in der vollständigen Blob-URL gespeichert werden. Beispiel-Token: sv=2025-08-01&ss=b&srt=sco&sp=rl&se=2025-08-30T12:00:00Z&st=2025-08-25T12:00:00Z&spr=https&sig=AbCdEfGhIjKlMnOpQrStUvWxYz1234567890.
azure_blob_base_url Die Basis-URL des Azure Blob Storage-Kontos, das für den Zugriff auf Container und Blobs verwendet wird. In einer SAS-URL wie https://myaccount.blob.core.windows.net/mycontainer/myblob.txt?sv=... lautet die Basis-URL https://myaccount.blob.core.windows.net/.

Tipp

Diese Werte können aus der SAS-URL abgeleitet werden, die das Format {{azure_blob_base_url}}/{{Azure_Blob_Container_Name}}?{{azure_blob_sas_token}} hat.

Variablenname Beschreibung
Azure_AI_Search_Index_Name Der Name des Azure-Index, der Kundeninformationen aus Bestellformularen speichert.
azure_ai_search_indexer Der Name des Azure AI Search-Indexers, der zum Auffüllen und Aktualisieren des Suchindex Azure_AI_Search_Index_Name verwendet wird.
azure_ai_search_url Die Endpunkt-URL des Azure AI Search-Diensts. Verwenden Sie keinen nachgestellten Schrägstrich. Beispiel: https://<your-search-service>.search.windows.net.
azure_ai_search_api_key Der API-Schlüssel zur Authentifizierung von Anforderungen an Azure AI Search.

Azure OpenAI

Variablenname Beschreibung
Azure_OpenAI_Deployment_Name Der Name der Azure OpenAI-Bereitstellung, die zum Zugriff auf das Modell verwendet wird.
azure_openai_base_url Die Basis-URL für den Zugriff auf den Azure OpenAI-Dienst. Beispiel: https://<your-resource-name>.openai.azure.com.
azure_openai_api_key Der API-Schlüssel zur Authentifizierung von Anforderungen an den Azure OpenAI-Dienst.

Slack

Variablenname Beschreibung
Slack_Bot_Token Das Slack-Bot-Token, das nach dem Erstellen der Slack-App erhalten wird und für das Bot-Benutzer-OAuth-Zugriffstoken in der Slack-Verbindung verwendet wird.

Hinweis

Die Slack-App wird in einem späteren Schritt erstellt. Vorerst kannst du diese Variable leer lassen.

Common

Variablenname Beschreibung
html_regex Regex zum Entfernen von HTML-Tags. Verwende den Standardwert: <(?:"[^"]*"['"]*|'[^']*'['"]*|[^'">])+>
AI_Prompt

Der Eingabetext oder die Anweisung für das KI-Modell, die vorgibt, wie die Antwort generiert werden soll. Für diesen Agent kannst du die folgende Eingabeaufforderung verwenden:

Du bist ein KI-Assistent, der Benutzer dabei hilft, Informationen aus organisatorischen Wissensquellen (JIRA-Tickets, Confluence-Seiten, Google Drive-Dateien und Salesforce-Supportfälle) zu finden und zusammenzufassen. Nutze den abgerufenen Kontext, um die präziseste und prägnanteste Antwort zu liefern. Richtlinien: Priorisiere immer Informationen aus den abgerufenen Dokumenten. Falls mehrere Dokumente unterschiedliche Details bereitstellen, fasse diese zusammen und hebe die Unterschiede hervor. Sollte kein relevanter Kontext gefunden werden, sage: „Ich konnte keine relevanten Informationen in der verfügbaren Wissensdatenbank finden." Erfinde keine Details außerhalb des bereitgestellten Kontexts.

Verbindungen testen

Teste die Endpunktkonfigurationen, um die Konnektivität anhand der definierten Projektvariablenwerte zu überprüfen.

Um Verbindungen zu testen, öffne die Registerkarte Projektendpunkte und Connectors in der Designkomponentenpalette, fahre mit der Maus über die einzelnen Endpunkte und klicke auf Testen.

Projekt bereitstellen

Stelle das Studio-Projekt bereit.

Um das Projekt bereitzustellen, nutze das Menü des Projekts und wähle Bereitstellen.

Projekt bereitstellen

Stelle das Studio-Projekt bereit. Das kannst du über das Menü des Projekts durchführen und Bereitstellen auswählen.

Erstellen Sie die benutzerdefinierte Jitterbit-API

Erstellen Sie eine benutzerdefinierte API mit dem API Manager für eines der folgenden:

Erstellen Sie den Slack-Bot-API-Request-Handler

Diese benutzerdefinierte Jitterbit-API triggert den Betrieb Slack Bot API Request Handler. Konfigurieren Sie die benutzerdefinierte API mit folgenden Einstellungen und veröffentlichen Sie sie:

  • API Service: Slack Bot API Request Handler
  • Path: /
  • Projekt: Wählen Sie das Studio-Projekt aus, das vom Jitterbit Knowledge Agent im Marketplace erstellt wurde
  • Operation zum Triggern: Slack Bot API Request Handler
  • Method: POST
  • Response Type: System Variable

Speichern Sie die Service-URL der veröffentlichten API für die Erstellung der Slack-App. Die Service-URL finden Sie in der API-Detailleiste auf der Registerkarte Services, indem Sie den Mauszeiger über die Spalte Actions des Service bewegen und API-Service-URL kopieren klicken.

Allgemeiner API-Request-Handler

Diese benutzerdefinierte Jitterbit-API triggert den Betrieb Generic API request Handler. Dies ist nicht erforderlich. Erstellen Sie diese API, wenn Sie andere Anwendungen zur Verarbeitung von HTTP-API-Anfragen verwenden. Konfigurieren Sie die benutzerdefinierte API mit folgenden Einstellungen und veröffentlichen Sie sie:

  • Service Name: Generic API request Handler
  • Projekt: Wählen Sie das Studio-Projekt aus, das vom Jitterbit Knowledge Agent im Marketplace erstellt wurde
  • Operation: Generic API request Handler
  • Method: POST
  • Response type: System Variable

Tipp

Sie können auch ein Sicherheitsprofil für die Authentifizierung hinzufügen.

Request body
{
    "username": "johnr",
    "prompt": "How to connect to mysql using a connector?"
}
Response
{
    "message": "To connect to a MySQL database using the Database connector, follow these steps:   - Use the MySQL JDBC driver that ships with the agent for additional features like manual queries.",
    "references": [],
    "status_code": 200
}

Überprüfen Sie die Projekt-Workflows

Überprüfen Sie im offenen Studio-Projekt die Workflows zusammen mit den folgenden Beschreibungen, um zu verstehen, was sie tun.

Hinweis

Die ersten vier Workflows sind Data upload Utility-Workflows, deren Zweck darin besteht, Daten abzurufen, die als Wissensdatenbank für den KI-Agenten verwendet werden. Sie können einen oder mehrere dieser Workflows verwenden, um Daten abzurufen. Mindestens eine Quelle ist als Wissensdatenbank für den KI-Agenten erforderlich.

Diese Workflows sollten zunächst ausgeführt werden, um Wissen in den Agenten zu laden, bevor Sie mit ihm interagieren. Sie können einen Schedule einrichten, um auf regelmäßiger Basis aktualisierte Daten gemäß Ihren Anforderungen zu erhalten. Dies kann über das Menü Aktionen der ersten Operation unter Einstellungen > Schedules erfolgen.

  1. Data upload Utility - JIRA Ticket to Azure Index

    Dieser Workflow ruft Probleme aus Jira ab und führt dann den Workflow Utility - Azure Data Upload and Index aus, um Probleme in Azure Blob Storage hochzuladen und in den Azure AI Search Index zu indizieren.

    Der erste Betrieb ist Main - JIRA tickets upload. Die folgenden Felder werden abgerufen:

    "fields": [
        "summary",
        "status",
        "assignee",
        "description",
        "reporter",
        "created",
        "updated",
        "priority",
        "issuetype",
        "components",
        "comment"
     ]
    

    Dieser Workflow kann so konfiguriert werden, dass alle Probleme oder nur neue und aktualisierte Probleme mithilfe der Jira-Projektvariablen abgerufen werden.

  2. Data upload Utility - SF Cases to Azure Index

    Dieser Workflow ruft Supportfälle von Salesforce ab und führt dann den Workflow Utility - Azure Data Upload and Index aus, um Fälle in Azure Blob Storage hochzuladen und in den Azure AI Search Index zu indizieren.

    Der erste Betrieb ist Main - SF Cases Upload.

    In der Konfiguration der Salesforce Query Aktivität ruft die folgende Abfrage Supportfall-Informationen nach Agent ab. Wenn Ihre Salesforce-Organisation diese Objekte und Felder nicht verwendet oder wenn Supportfall-Informationen in verschiedenen Objekten und Feldern gespeichert sind, funktioniert dieser Workflow nicht ordnungsgemäß. Passen Sie die Abfrage in diesem Workflow an Ihre Salesforce-Organisationsdatenstruktur an:

SELECT Account.Name,
           Owner.Email,
           Owner.Name,
           (SELECT CreatedBy.Email,
                   CreatedBy.Name,
                   Id,
                   CommentBody,
                   CreatedDate,
                   LastModifiedDate,
                   LastModifiedBy.Email,
                   LastModifiedBy.Name
            FROM   CaseComments),
           Id,
           CaseNumber,
           CreatedDate,
           Description,
           LastModifiedDate,
           Origin,
           Priority,
           Reason,
           Status,
           Subject,
           Type,
           CreatedBy.Email,
           CreatedBy.Name,
           LastModifiedBy.Email,
           LastModifiedBy.Name
    FROM Case

Dieser Workflow kann konfiguriert werden, um alle Fälle oder nur neue und aktualisierte Fälle abzurufen, indem man die Salesforce-Projektvariablen verwendet.

  1. Data upload Utility - Confluence Pages to Azure Index

    Dieser Workflow ruft Seiten aus Confluence ab und führt dann den Workflow Utility - Azure Data Upload and Index aus, um Dokumente in Azure Blob Storage hochzuladen und in den Azure AI Search-Index einzuordnen.

    Der anfängliche Vorgang ist Main - Load Confluence Pages.

    Dieser Workflow ruft bei jeder Ausführung alle Confluence-Seiten ab.

  2. Data upload Utility - Google Drive to Azure Blob

    Dieser Workflow ruft Dateien aus Google Drive ab und führt dann den Workflow Utility - Azure Data Upload and Index aus, um sie im Azure AI Search-Index einzuordnen.

    Der anfängliche Vorgang ist Main - Google Drive Upload.

    Zu den unterstützten Dateitypen gehören Google Docs, Google Spreadsheets und von Azure Storage Blob Indexing unterstützte Dateitypen.

    Die maximal unterstützten Dateigrößen sind als maximale Blob-Größe in den Azure AI Search Indexer-Limits für die Dienstebene des AI-Suchdiensts aufgeführt. Beispielsweise beträgt das Limit für die Basic-Ebene 16 MB; für S1 beträgt das Limit 128 MB.

    Dieser Workflow kann konfiguriert werden, um alle Dateien oder nur neue und aktualisierte Dateien abzurufen, indem man die Google Drive-Projektvariablen verwendet.

  3. Utility - Azure Data Upload and Index

    Dies ist ein gemeinsamer Utility-Workflow, der von den Data upload Utility-Workflows verwendet wird, um Daten in Azure Blob Storage hochzuladen und in Azure AI Search einzuordnen.

  4. Main Entry - Slack API Request Handler

    Dieser Workflow verwaltet eingehende Slack-Bot-Anfragen. Er wird über eine benutzerdefinierte Jitterbit-API ausgelöst, jedes Mal wenn dein Team mit der Slack-Bot-Chat-Benutzeroberfläche interagiert (d. h. eine Slack-Nachricht daran sendet). Die Konfiguration der benutzerdefinierten Jitterbit-API wird später auf dieser Seite unter Create the Jitterbit custom API beschrieben.

    Wenn du Slack nicht verwendest, kann dieser Workflow ignoriert werden und wird nicht ausgelöst. Um eine andere Chat-Benutzeroberfläche für die Interaktion deines Teams zu verwenden, nutze den Workflow Generic API Request Handler, der ebenfalls über eine benutzerdefinierte Jitterbit-API ausgelöst wird.

  5. Generic API Request Handler

    Dieser Workflow verarbeitet HTTP-API-Anfragen von jeder Anwendung. Um mit deinen Anwendungen zu integrieren, erstelle eine benutzerdefinierte Jitterbit-API, die den Vorgang Generic API request Handler auslöst. Die URL dieser API kann dann von jeder Anwendung verwendet werden, um Anfragen zu senden und zu empfangen.

    Die Konfiguration der benutzerdefinierten Jitterbit-API wird später auf dieser Seite unter Create the Jitterbit custom API beschrieben.

Die Projekt-Workflows auslösen

Für das initiale Laden der Daten führe einen oder mehrere der Data upload Utility-Workflows je nach deinen Datenquellen aus. Dies kann mithilfe der Option Run des anfänglichen Vorgangs erfolgen, die durch Hovern über den Vorgang angezeigt wird. Wenn deine Daten aktualisiert werden, musst du den Vorgang in Zukunft erneut ausführen.

Tipp

Du möchtest möglicherweise die anfänglichen Vorgänge in Data upload Utility-Workflows nach Zeitplan durchführen, um regelmäßig aktualisierte Daten zu erhalten. Dies kann über das Menü Aktionen des Vorgangs unter Settings > Schedules erfolgen.

Die zwei anderen Haupt-Workflows werden durch die benutzerdefinierten Jitterbit-APIs ausgelöst:

  • Main Entry - Slack API Request Handler: Dieser Workflow wird von Slack über die benutzerdefinierte API Slack Bot API Request Handler ausgelöst. Das Senden einer direkten Nachricht an die Slack-App löst den benutzerdefinierten API-Trigger aus.

  • Generic API Request Handler: Dieser Workflow wird von einer anderen Anwendung über die benutzerdefinierte API Generic API request Handler ausgelöst. Das Senden einer Anfrage an die konfigurierte API löst den benutzerdefinierten API-Trigger aus.

Alle anderen Workflows werden durch andere Operationen ausgelöst und sind nachgelagert gegenüber den oben aufgeführten. Sie sind nicht dafür vorgesehen, eigenständig ausgeführt zu werden.

Fehlerbehebung

Bei Problemen überprüfen Sie die folgenden Logs auf detaillierte Informationen zur Fehlerbehebung:

Für weitere Unterstützung kontaktieren Sie den Jitterbit-Support.