Zum Inhalt springen

Jitterbit Account Intelligence Agent

Überblick

Jitterbit stellt Kunden den Account Intelligence Agent über den Jitterbit Marketplace zur Verfügung. Dieser Agent hilft Kundenbetreuern, ihre Pipelines effektiver zu verwalten, indem er eine priorisierte tägliche Liste von Kontoaufgaben bereitstellt und Besprechungsnotizen automatisch in verwertbare Salesforce-Datensätze verarbeitet. Der Agent überwacht Salesforce auf offene Aufgaben und Opportunity-Berichte, verarbeitet Besprechungsnotizen aus Gmail und liefert Ergebnisse über Slack-Nachrichten und geplante E-Mail-Digests.

Der Agent empfängt On-Demand-Anfragen über Slack und nutzt ein LLM, um die Benutzerabsicht zu ermitteln und relevante Informationen aus Salesforce abzurufen. Bei Besprechungsnotizen fragt der Agent regelmäßig ein dediziertes Gmail-Postfach nach E-Mails mit Google Docs-Links ab, extrahiert Maßnahmen und Teilnehmer mithilfe eines LLM und erstellt entsprechende Task- und Event-Datensätze in Salesforce. Der Sitzungsstatus und OAuth-Tokens werden im Jitterbit Cloud Datastore verwaltet.

Der Agent führt die folgenden Aufgaben aus:

  • Empfängt natürlichsprachige Anfragen von Benutzern über Slack und gibt eine priorisierte Liste offener Aufgaben oder Opportunity-Berichte zurück.
  • Ruft offene Salesforce-Aufgaben ab, die dem anfragenden Benutzer zugewiesen sind, bezogen auf die letzten 7 Tage und die nächsten 30 Tage.
  • Ruft Ausnahmeerichte aus einem konfigurierten Salesforce-Ordner ab und gibt sie an den anfragenden Benutzer zurück.
  • Fragt ein dediziertes Gmail-Postfach nach E-Mails mit Besprechungsnotizen vom konfigurierten Absender ab, ruft das verlinkte Google Doc ab und extrahiert Maßnahmen und Teilnehmer mithilfe eines LLM.
  • Erstellt Salesforce Task- und Event-Datensätze für jeden in einer Besprechungsnotiz identifizierten Teilnehmer.
  • Sendet Slack-Direktnachrichten an Besprechungsteilnehmer mit einer Besprechungszusammenfassung und ihren zugewiesenen Maßnahmen.
  • Sendet geplante E-Mail-Digests und Slack-Benachrichtigungen an registrierte Benutzer mit ihren offenen Aufgaben und Berichtszusammenfassungen.

Dieses Dokument erklärt die Einrichtung und den Betrieb dieses KI-Agenten. Es behandelt Architektur und Voraussetzungen, Anleitung zum Prompting des Agenten und Schritte zur Installation, Konfiguration und zum Betrieb des KI-Agenten.

KI-Agent-Architektur

Dieser KI-Agent stellt Kontointelligenz über eine konversative Slack-Schnittstelle und automatisierte geplante Workflows zur Verfügung. Der Agent arbeitet über zwei Hauptabläufe.

On-Demand-Slack-Anfragen

Eine typische On-Demand-Interaktion folgt diesen Schritten:

  1. Ein Benutzer sendet eine natürlichsprachige Nachricht über Slack an den Account Intelligence Agent.
  2. Der Agent ruft das LLM auf, um die Benutzerabsicht zu ermitteln und das passende Tool auszuwählen.
  3. Das ausgewählte Tool fragt Salesforce nach offenen Aufgaben des anfragenden Benutzers ab oder ruft Berichte aus einem konfigurierten Salesforce-Ordner ab.
  4. Das LLM formatiert die Ergebnisse und der Agent sendet die Antwort über Slack zurück an den Benutzer.

Verarbeitung von Besprechungsnotizen

Die Verarbeitung von Besprechungsnotizen folgt diesen Schritten:

  1. Der Agent fragt ein dediziertes Gmail-Postfach nach E-Mails vom konfigurierten Absender von Besprechungsnotizen ab.
  2. Für jede neue E-Mail extrahiert der Agent den Google Doc-Link und überprüft Cloud Datastore, um zu bestätigen, dass das Dokument noch nicht verarbeitet wurde.
  3. Der Agent ruft den Google Doc-Inhalt ab und sendet ihn an das LLM, das Besprechungsteilnehmer und Maßnahmen extrahiert.
  4. Der Agent schlägt die Contact ID in Salesforce für jeden Teilnehmer nach, erstellt dann einen Task-Datensatz für jede Maßnahme und einen Event-Datensatz für jeden Teilnehmer.
  5. Der Agent sendet jedem Teilnehmer eine Slack-Direktnachricht mit der Besprechungszusammenfassung und ihren zugewiesenen Maßnahmen.

Workflow-Diagramm

Das folgende Diagramm zeigt die Hauptkomponenten und Datenflüsse für den Account Intelligence Agent.

--- config: themeVariables: lineColor: '#6b7280' edgeLabelBackground: '#f5f5f5' flowchart: padding: 20 nodeSpacing: 80 --- flowchart LR classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px JSP@{ shape: hex, label: "
Jitterbit
Account Intelligence Agent" } SCHED@{ shape: delay, label: "Operation schedule
(daily)" } SLK[fab:fa-slack
Slack] LLM[fas:fa-brain
LLM] SF[fab:fa-salesforce
Salesforce] GMAIL[fas:fa-envelope
Gmail] GDOC[fab:fa-google
Google Docs] CD@{ shape: hex, label: "fas:fa-database
Cloud Datastore" } SLK <-->|1. User request / response| JSP SCHED -->|2. Scheduled trigger| JSP JSP <-->|3. LLM calls| LLM JSP <-->|4. OAuth tokens and user details| CD JSP <-->|5. Tasks, reports, contacts, and events| SF JSP <-->|6. Meeting note emails| GMAIL JSP <-->|7. Meeting note content| GDOC

Voraussetzungen

Sie benötigen die folgenden Komponenten, um diesen KI-Agenten zu nutzen.

Harmony-Komponenten

Sie müssen eine Jitterbit Harmony-Lizenz mit Zugriff auf die folgenden Komponenten haben:

  • Jitterbit Studio.
  • Jitterbit API Manager zum Bereitstellen der Slack- und Gmail-OAuth-Endpunkte.
  • Jitterbit Cloud Datastore zum Speichern von Gmail-OAuth-Token, verarbeiteten Besprechungsaufzeichnungen und Benutzerbenachrichtigungsdetails.
  • Jitterbit Account Intelligence Agent, der als Lizenz-Add-on erworben wurde.

Unterstützte Endpunkte

Der KI-Agent stellt eine Verbindung zu den folgenden Endpunkten her. Sie können andere Systeme anpassen, indem Sie die Endpunktkonfigurationen und Workflows des Projekts ändern.

Large Language Model (LLM)

Der KI-Agent verwendet Azure OpenAI als LLM-Anbieter. Um Azure OpenAI zu verwenden, benötigen Sie ein Microsoft Azure-Abonnement mit Berechtigungen zum Erstellen einer Azure OpenAI-Ressource mit einem bereitgestellten Modell.

Tipp

Informationen zu Preisen finden Sie auf der Seite Azure OpenAI-Preise.

CRM-System

Der Agent liest und schreibt Datensätze in Salesforce. Um Salesforce zu verwenden, benötigen Sie ein Salesforce-Konto mit API-Zugriff und Berechtigungen zum Lesen von Tasks, Events, Kontakten und Reports sowie zum Erstellen von Task- und Event-Datensätzen.

E-Mail- und Dokumentplattform

Der Agent stellt eine Verbindung zu Gmail her, um ein dediziertes Postfach auf Besprechungsnotiz-E-Mails abzurufen, und zu Google Docs, um Inhalte von Besprechungsnotizen abzurufen. Der Gmail-Zugriff verwendet OAuth 2.0-Anmeldedaten, und der Google Docs-Zugriff verwendet ein Google Cloud Service Account. Um diese Services zu verwenden, benötigen Sie ein Google Cloud-Projekt mit aktivierter Gmail API, Google Docs API und Google Drive API sowie eine OAuth 2.0 Client ID für Gmail und ein Service Account für Google Docs. Ein dediziertes Gmail-Postfach für Besprechungsnotizen wird empfohlen.

Messaging-Plattform

Der Agent verwendet Slack als Gesprächsschnittstelle und Benachrichtigungskanal. Um Slack zu verwenden, benötigen Sie einen Slack-Workspace mit einer konfigurierten Slack-App zum Empfangen und Beantworten von Nachrichten. Detaillierte Anweisungen zum Erstellen einer Slack-App finden Sie unter Slack-App erstellen.

Cloud Datastore

Der Agent verwendet Jitterbit Cloud Datastore zum Speichern von Gmail-OAuth-Token, zum Nachverfolgen verarbeiteter Besprechungsdokumente, um doppelte Verarbeitung zu vermeiden, und zum Verwalten von Benutzerdetails für geplante E-Mail-Benachrichtigungen. Cloud Datastore ist Teil der Jitterbit Harmony-Plattform und erfordert keinen separaten Service Account. Die Anzahl der verfügbaren Schlüsselspeicher hängt jedoch von der von Ihrer Organisation gekauften Cloud Datastore-Stufe ab.

Agent-Prompts

Der Account Intelligence Agent empfängt On-Demand-Anfragen als Nachrichten in natürlicher Sprache, die an die Slack-App gesendet werden. Dieser Abschnitt beschreibt die Regeln für effektive Prompts und enthält Beispiel-Prompts.

Richtlinien für Prompts

Befolgen Sie diese Richtlinien, wenn Sie Nachrichten an den Agent senden:

  • Anfragen sind auf den Benutzer begrenzt, der die Nachricht sendet. Der Agent ruft Tasks und Reports ab, die mit Ihrem Salesforce-Benutzerkonto verknüpft sind, basierend auf Ihrer Slack-E-Mail-Adresse.
  • Abfragen für offene Tasks geben Tasks aus den letzten 7 Tagen und den nächsten 30 Tagen zurück. Die Ergebnisse können für Datumsfilter älter als 7 Tage ungenau sein.
  • Fügen Sie für Task-Abfragen mit Datumfilter das Zieldatum in Ihre Nachricht ein und verwenden Sie ein erkennbares Datumsformat (z. B. „vor 30. April" oder „vor 2026-04-30").
  • Geben Sie für Report-Abfragen den genauen Namen des Salesforce-Kontakts ein, wie er im Salesforce-Benutzerprofil angezeigt wird.

Beispiel-Prompts

Die folgenden Beispiel-Prompts zeigen die Arten von Anfragen, die der Agent verarbeiten kann. Ersetzen Sie [Date] durch Ihr Zieldatum.

Offene Tasks

Verwenden Sie diese Prompts, um Ihre offenen Salesforce-Tasks abzurufen:

Prompts

  • Provide me a list of open tasks.
  • What are my open tasks for today?
  • Provide me all my open tasks I need to complete before [Date].
  • What tasks do I need to complete before [Date]?

Berichte

Verwende diese Eingabeaufforderung, um Ausnahmebericht-Details für einen bestimmten Kontakt abzurufen. Ersetze [Contact Name] durch den exakten Namen des Kontakts, wie er im Salesforce-Benutzerprofil des Kontakts angezeigt wird:

Eingabeaufforderungen

  • Give me the report details of [Contact Name].

Installation, Konfiguration und Betrieb

Führe diese Schritte aus, um diesen KI-Agent zu installieren, zu konfigurieren und zu betreiben:

  1. Projekt herunterladen und installieren
  2. Google Cloud einrichten
  3. Microsoft Azure-Ressourcen erstellen
  4. Slack-App erstellen
  5. Cloud Datastore konfigurieren
  6. Projektvariablen konfigurieren
  7. Verbindungen testen
  8. Projekt bereitstellen
  9. Benutzerdefinierte Jitterbit-APIs erstellen
  10. Gmail OAuth-Autorisierung abschließen
  11. Projekt-Workflows überprüfen
  12. Projekt-Workflows auslösen

Anleitungen zur Fehlerbehebung findest du unter Fehlerbehebung.

Projekt herunterladen und installieren

Führe diese Schritte aus, um das Studio-Projekt für den KI-Agent zu installieren:

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

  2. Suche nach dem KI-Agent mit dem Namen Jitterbit Account Intelligence Agent. Verwende die Suchleiste oder wähle im Bereich Filter unter Typ die Option AI Agent aus, um die Anzeige auf KI-Agents zu beschränken.

  3. Klicke auf den Link Dokumentation des Agents, um seine Dokumentation in einem separaten Tab zu öffnen. Halten den Tab offen, um später darauf zu verweisen.

  4. Klicke auf Start Project, um ein zweischrittiges Konfigurationsdialogfeld zu öffnen.

    Hinweis

    Wenn du den KI-Agent noch nicht erworben hast, wird stattdessen Get this agent angezeigt. Klicke darauf, um ein Informationsdialogfeld zu öffnen, und klicke dann auf Submit, damit sich ein Vertreter bei dir zum Kauf des KI-Agents meldet.

  5. In Konfigurationsschritt 1, Download Customizations, lade die bereitgestellte Slack-App-Manifestdatei herunter. Diese Datei verwendest du, wenn du die Slack-App erstellst.

  6. Klicke auf Next.

  7. In Konfigurationsschritt 2, Create a New Project, wähle eine Umgebung aus, in der das Studio-Projekt erstellt wird, und klicke auf Create Project.

  8. Nachdem das Fortschrittsdialogfeld anzeigt, dass das Projekt erstellt wurde, verwende den Dialog-Link Go to Studio oder öffne das Projekt direkt von der Studio-Seite Projects aus.

Google Cloud einrichten

Der Agent benötigt zwei Arten von Google-Anmeldedaten: OAuth 2.0-Anmeldedaten für den Gmail-Zugriff und ein Service Account für den Google Docs-Zugriff.

Gmail OAuth einrichten

Die Gmail-Authentifizierung verwendet OAuth 2.0. Jede Bereitstellungsumgebung benötigt ihre eigenen OAuth-Anmeldedaten, da der Redirect-URI umgebungsspezifisch ist.

Führe diese Schritte für jede Umgebung aus, in der du den Agent bereitstellst:

  1. Stelle zunächst das Studio-Projekt bereit und notiere die API Gateway-Basis-URL von API Manager > My APIs. Diese URL ist erforderlich, wenn du den OAuth-Redirect-URI in Google Cloud registrierst.

  2. Öffne in der Google Cloud Console dein Projekt oder erstelle ein neues für diese Integration.

  3. Aktiviere die folgenden APIs unter APIs & Services > Library:

    • Gmail API
    • Google Drive API
  4. Konfiguriere den OAuth-Einwilligungsbildschirm unter APIs & Services > OAuth consent screen. Wähle Internal aus, wenn das dedizierte Gmail-Konto zu einer Google Workspace-Organisation gehört. Wähle External für ein persönliches Gmail-Konto aus. Füge die folgenden OAuth-Bereiche hinzu:

    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/drive.readonly
  5. Erstelle eine OAuth 2.0-Client-ID unter APIs & Services > Credentials. Wähle Web application als Anwendungstyp aus.

  6. Gib im Feld Authorized redirect URIs die Endpunkt-URL /oauth/callback unter Verwendung der in Schritt 1 notierten API Gateway-Basis-URL im Format ein: https://<your-org>.jitterbit.com/oauth/callback.

  7. Kopieren Sie die generierte Client ID und das Client Secret. Speichern Sie diese sicher und geben Sie sie als Projektvariablen ein, wenn Sie Projektvariablen konfigurieren.

Google Docs Service Account einrichten

Der Google Docs-Zugriff verwendet ein Service Account anstelle von OAuth-Anmeldedaten für Benutzer.

Führen Sie diese Schritte aus:

  1. Öffnen Sie in der Google Cloud Console das gleiche Projekt, das für Gmail OAuth verwendet wird, oder erstellen Sie ein neues.

  2. Aktivieren Sie die Google Docs API unter APIs & Services > Library.

  3. Klicken Sie unter IAM & Admin > Service Accounts auf Create Service Account. Geben Sie einen Namen und eine Beschreibung ein und klicken Sie auf Create and Continue.

  4. Weisen Sie dem Service Account eine geeignete Rolle zu (z. B. Viewer) und klicken Sie auf Done.

  5. Klicken Sie auf das Service Account, um seine Details zu öffnen, und wählen Sie die Registerkarte Keys.

  6. Klicken Sie auf Add Key > Create new key, wählen Sie JSON und klicken Sie auf Create. Speichern Sie die heruntergeladene JSON-Schlüsseldatei sicher.

  7. Kopieren Sie aus der JSON-Schlüsseldatei die Werte client_email und private_key. Geben Sie diese als Projektvariablen ein, wenn Sie Projektvariablen konfigurieren.

Microsoft Azure-Ressourcen erstellen

Erstellen Sie die folgenden Microsoft Azure-Ressourcen und notieren Sie die Informationen zur Konfiguration des AI-Agenten. Um diese Ressourcen zu erstellen und zu verwalten, müssen Sie ein Microsoft Azure-Abonnement mit den entsprechenden Berechtigungen besitzen.

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

Notieren Sie den Bereitstellungsnamen, die Endpoint-URL und den API-Schlüssel. Geben Sie diese Werte ein, wenn Sie Projektvariablen konfigurieren.

Führen Sie diese Schritte aus, um diese Werte zu finden:

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

  2. Kopieren Sie auf der Ressourcen-Landingpage die Endpoint-URL und den API-Schlüssel.

  3. Wählen Sie in der Navigationsleiste unter Shared resources die Option Deployments. Kopieren Sie den Bereitstellungsnamen.

Slack-App erstellen

Um die Slack-Schnittstelle des Agenten zu aktivieren, führen Sie diese Schritte aus:

  1. Erstellen Sie eine Slack-App mit der in Projekt herunterladen und installieren heruntergeladenen Manifestdatei. Das Manifest konfiguriert vorab den Bot-Benutzer (angezeigt als Account Wingman Assistant), OAuth-Bereiche und Event-Abos für den Account Intelligence Agent. Installieren Sie die App in Ihrem Slack-Arbeitsbereich.

  2. Rufen Sie das Bot-Token ab und behalten Sie es für die Projektvariable Bot_oauth_user_token.

  3. Fügen Sie der App einen Slack-Schrägstrich-Befehl hinzu und leiten Sie die Request URL an den benutzerdefinierten API-Endpunkt /connect-gmail weiter. Mit diesem Befehl kann ein Administrator den Gmail OAuth-Autorisierungsablauf direkt von Slack aus auslösen.

Cloud Datastore konfigurieren

Der Agent nutzt drei Cloud Datastore Key Storages zur Verwaltung von OAuth-Anmeldedaten, zur Deduplizierung verarbeiteter Meetings und zur Speicherung von Benachrichtigungsdetails für Benutzer:

Key Storage Zweck
AIA_Authorized_Users Speichert das Gmail OAuth-Refresh-Token und die E-Mail-Adresse für den dedizierten Posteingang für Meeting-Notizen.
AIA_Processed_Meetings Verfolgt Google Doc IDs verarbeiteter Meeting-Notizen, um doppelte Verarbeitung zu verhindern.
AIA_Notification_User_details Speichert Slack-Benutzerdetails für Benutzer, die geplante E-Mail- und Slack-Benachrichtigungen erhalten.

Erstellen Sie die folgenden Key Storages im Jitterbit Cloud Datastore. Die Felder Key, AlternativeKey und Value sind standardmäßig vorhanden.

AIA_Authorized_Users

Erstelle einen Schlüsselspeicher namens AIA_Authorized_Users. Keine benutzerdefinierten Felder erforderlich.

Feldname Typ Beschreibung
Key Text Automatisch ausgefüllt. Die E-Mail-Adresse des dedizierten Postfachs für Besprechungsnotizen.
AlternativeKey Text Nicht verwendet.
Value Text Automatisch ausgefüllt. Das Gmail-OAuth-Aktualisierungstoken, das automatisch gespeichert wird, wenn der Gmail-OAuth-Autorisierungsfluss abgeschlossen ist.

AIA_Processed_Meetings

Erstelle einen Schlüsselspeicher namens AIA_Processed_Meetings. Keine benutzerdefinierten Felder erforderlich.

Feldname Typ Beschreibung
Key Text Automatisch ausgefüllt. Die Google Doc-ID einer verarbeiteten Besprechungsnotiz, die verwendet wird, um doppelte Verarbeitung zu verhindern.
AlternativeKey Text Nicht verwendet.
Value Text Nicht verwendet.

AIA_Notification_User_details

Erstelle einen Schlüsselspeicher namens AIA_Notification_User_details. Füge die folgenden benutzerdefinierten Felder hinzu:

Feldname Typ Beschreibung
Key Text Nicht verwendet.
AlternativeKey Text Nicht verwendet.
Value Text Nicht verwendet.
SlackChannel Text Die Slack-Kanal-ID, die zum Senden geplanter Benachrichtigungen an den Benutzer verwendet wird.
SlackuserID Text Die Slack-Benutzer-ID des Benutzers, der geplante E-Mail- und Slack-Benachrichtigungen erhält.

Projektvariablen konfigurieren

Lege im Studio-Projekt, das vom Marketplace installiert wurde, Werte für die folgenden Projektvariablen fest.

Verwende zum Konfigurieren von Projektvariablen das -Menü des Projekts und wähle Project Variables aus, um das Konfigurationsfenster zu öffnen.

Aktiviere Mask Value für alle Anmeldedaten- und Token-Felder.

Salesforce

Variablenname Beschreibung
SF_User_Name Benutzername für die Salesforce-Instanz.
SF_Security_Token Sicherheitstoken für das Salesforce-Benutzerkonto.
SF_Password Passwort für das Salesforce-Benutzerkonto.
SF_Login_URL Anmelde-URL für die Salesforce-Instanz (z. B. https://login.salesforce.com).
SF_Folder_Id Salesforce-Ordner-ID mit den Ausnahmereports, die vom Workflow „Exception Report Monitor" abgerufen werden.
SF_Client_ID OAuth-2.0-Client-ID für die direkte Salesforce-API-Authentifizierung, die vom Workflow „Exception Report Monitor" verwendet wird.
SF_Client_Secret OAuth-2.0-Client-Secret, das mit SF_Client_ID gekoppelt ist.
SF_Base_URL Basis-URL der Salesforce-Instanz, die für HTTP-Connector-Aufrufe und zum Erstellen von Umleitungslinks in den LLM-Prompts verwendet wird.

Azure OpenAI

Variablenname Beschreibung
Open_ai_token Authentifizierungstoken für den Azure-OpenAI-Service.
Azure_OpenAI_Deployment_Name Deployment-Name des zu verwendenden Azure-OpenAI-Modells.
Azure_openai_base_url Basis-Endpunkt-URL für den Azure-OpenAI-Service.
azure_openai_api_key API-Schlüssel zur Authentifizierung von Anfragen an den Azure-OpenAI-Service.
Generic_System_Prompt System-Prompt für allgemeine LLM-Aufrufe. Vorkonfiguriert: nicht ändern.
Generic_Mail_Prompt System-Prompt für die Formatierung von E-Mail-Digests. Vorkonfiguriert: nicht ändern.

Cloud Datastore

Variablenname Beschreibung
Cloud_Datastore_Access_Token Cloud Datastore-Authentifizierungstoken, bezogen von der Seite Zugriffstoken der Verwaltungskonsole.

Slack

Variablenname Beschreibung
Bot_oauth_user_token Das Slack-Bot-Token, das nach dem Erstellen der Slack-App erhalten wurde und für das Feld Bot User OAuth Token der Slack-Verbindung verwendet wird.

Gmail und Google

Variablenname Beschreibung
Email_Account_User E-Mail-Adresse des dedizierten Gmail-Postfachs, das für Besprechungsnotizen verwendet wird.
client_id_3 Google Cloud OAuth 2.0-Client-ID, die unter Gmail OAuth einrichten generiert wurde.
client_secret_3 Google Cloud OAuth 2.0-Client-Secret, das mit client_id gekoppelt ist.
refresh_token Gmail OAuth Refresh-Token. Dieses Feld leer lassen: Es wird automatisch gefüllt, wenn Sie die Gmail OAuth-Autorisierung abschließen.
client_email E-Mail-Adresse des Dienstkontos aus der JSON-Schlüsseldatei, die unter Google Docs-Dienstkonto einrichten generiert wurde.
private_key Privater Schlüssel des Dienstkontos aus der JSON-Schlüsseldatei, die unter Google Docs-Dienstkonto einrichten generiert wurde.

Verbindungen testen

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

Zum Testen von Verbindungen wechseln Sie zur Registerkarte Projektendpunkte und Konnektoren der Design-Komponentenpalette, fahren Sie mit der Maus über jeden Endpunkt und klicken Sie auf Testen.

Projekt bereitstellen

Stellen Sie das Studio-Projekt bereit.

Zum Bereitstellen des Projekts verwenden Sie das Menü Aktionen des Projekts und wählen Sie Bereitstellen.

Benutzerdefinierte Jitterbit-APIs erstellen

Der Agent benötigt drei benutzerdefinierte APIs. Erstellen Sie jede mithilfe der Option „Als API veröffentlichen".

Slack-Ereignishandler

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

Konfigurieren Sie diese Einstellungen für den Service:

Einstellung Wert
Servicename slackRequestBot
Pfad /slackRequestBot
Methode POST
Antworttyp System Variable

Nach der Veröffentlichung kopierst du die API-Service-URL und fügst sie in das Feld Event Subscriptions > Request URL deiner Slack-App ein.

Gmail OAuth-Endpoints

Erstelle zwei zusätzliche benutzerdefinierte APIs für den Gmail OAuth-Ablauf:

connect-gmail endpoint — löst den Google OAuth-Zustimmungsbildschirm für einen Administrator aus:

Einstellung Wert
Service name connectGmail
Operation Handle Connect Gmail
Path /connect-gmail
Method POST
Response Type System Variable

oauth/callback endpoint — empfängt den Autorisierungscode nach der Umleitung von Google:

Einstellung Wert
Service name oauthCallback
Operation OAuth Callback
Path /oauth/callback
Method GET
Response Type System Variable

Nach der Veröffentlichung beider Endpoints gehst du zurück zur Google Cloud Console und bestätigst, dass der Authorized redirect URI für deine OAuth 2.0 Client ID exakt der /oauth/callback URL entspricht.

Tipp

Du kannst auch ein security profile zur Authentifizierung hinzufügen.

Gmail OAuth-Autorisierung abschließen

Nach der Bereitstellung der APIs führst du den OAuth-Autorisierungsablauf aus, um das Gmail Refresh Token zu generieren und zu speichern:

  1. Löse den /connect-gmail API-Endpoint aus. Das kannst du über einen Browser, mit dem in Create the Slack app konfigurierten Slack Slash-Befehl oder durch direkten Aufruf des Endpoints tun.

  2. Melde dich mit dem dedizierten Gmail-Konto für Meetingnotizen an und gewähre die angeforderten Berechtigungen für Gmail und Google Drive auf dem Google-Zustimmungsbildschirm.

  3. Google leitet zum /oauth/callback Endpoint weiter. Der Agent tauscht den Autorisierungscode gegen Access- und Refresh-Tokens aus und speichert das Refresh Token automatisch im AIA_Authorized_Users Cloud Datastore Schlüsselspeicher.

  4. Öffne im Studio-Projekt die Project Variables und bestätige, dass refresh_token jetzt einen Wert hat, der nicht leer ist. Falls es noch leer ist, überprüfe die Operationsprotokolle von OAuth Callback und Exchange Token auf Fehler.

Projekt-Workflows überprüfen

Das Studio-Projekt enthält 6 Workflows, die die Funktionalität des Account Intelligence Agent implementieren und in drei funktionale Gruppen organisiert sind.

Anfrageverarbeitung

Workflow Beschreibung
Main Entry - Slack API Request Handler Empfängt eingehende Slack-Nachrichten und verwaltet Benutzerdetails im Cloud Datastore.
Main - AI Agent Tools Logic Analysiert jede Anfrage, wählt das passende Tool aus und verwaltet LLM-Aufrufe.
Main Entry - Slack API Request Handler

Dieser Workflow wird von der benutzerdefinierten Jitterbit-API jedes Mal ausgelöst, wenn ein Benutzer eine Nachricht an den Slack-Bot sendet. Er verwaltet eingehende Slack-Bot-Anfragen und verwaltet den AIA_Notification_User_details Cloud Datastore Schlüsselspeicher, um Slack-Benutzerdetails für geplante E-Mail-Benachrichtigungs-Workflows verfügbar zu halten. Nach dem Routing der Anfrage übergibt dieser Workflow die erforderlichen Informationen an den Main - AI Agent Tools Logic Workflow.

Main - AI Agent Tools Logic

Dieser Workflow empfängt die eingehende Anfrage vom Main Entry - Slack API Request Handler Workflow, analysiert sie mit dem LLM, um die beabsichtigte Funktion zu identifizieren, und bereitet eine Payload vor, um den passenden Agent-Tool-Workflow aufzurufen. Dieser Workflow verwaltet auch alle LLM-Anfragen und erfasst LLM-Antworten für die Nutzung nachgelagerter Prozesse.

Kontoüberwachung

Workflow Beschreibung
Agent - Open Task Monitoring Ruft offene Salesforce-Aufgaben für den anfragenden Benutzer ab und gibt sie zur Formatierung an das LLM zurück.
Agent - Exception Report Monitor Ruft Berichte aus einem konfigurierten Salesforce-Ordner ab und gibt sie zur Formatierung zurück.
Agent - Open Task Monitoring

Dieser Workflow ruft offene Aufgaben aus Salesforce für den Benutzer ab, der die Slack-Anfrage gesendet hat. Die Master-Operation (SF_Open_Task_Monitoring) prüft eine Slack-Benutzer-ID, ruft die Operation Get Slack User Profile auf, um die E-Mail-Adresse des Benutzers zu erhalten, fragt Salesforce nach dem entsprechenden Benutzerdatensatz ab und ruft dann alle Aufgaben mit dem Status „Not Started" ab, die in den letzten 7 Tagen und in den nächsten 30 Tagen liegen.

Agent - Exception Report Monitor

Dieser Workflow ruft Ausnahmemeldungen aus einem konfigurierten Salesforce-Ordner ab. Um sich direkt bei der Salesforce-API zu authentifizieren, wird zunächst ein Salesforce-Zugriffstoken über OAuth abgerufen. Anschließend wird die E-Mail-Adresse des anfragenden Benutzers von Slack dem Salesforce-Benutzerdatensatz zugeordnet, die Liste der Berichte aus dem durch die Projektvariable SF_Folder_Id angegebenen Ordner abgerufen und die Details der einzelnen relevanten Berichte abgerufen, um die endgültige Antwort zu erstellen.

Besprechungsnotizen und Benachrichtigungen

Workflow Beschreibung
Agent - Meeting Notes Fragt Gmail nach E-Mails mit Besprechungsnotizen ab, ruft Google Doc-Inhalte ab und erstellt Salesforce-Aufgaben und -Events über von LLM extrahierte Daten.
Tool - Schedules Notification Email Wird nach Zeitplan ausgeführt, um Zusammenfassungen offener Aufgaben und Berichte an alle registrierten Benutzer per E-Mail und Slack zu versenden.
Agent - Meeting Notes

Dieser Workflow verwaltet die gesamte Pipeline für Besprechungsnotizen. Ein Administrator löst den Gmail-OAuth-Flow über den API-Endpoint /connect-gmail aus. Der Workflow tauscht den Autorisierungscode gegen OAuth-Token aus und speichert das Aktualisierungstoken in der Cloud Datastore-Schlüsselspeicherung AIA_Authorized_Users. Bei jeder geplanten Ausführung authentifiziert sich der Workflow bei Gmail, fragt den Posteingang nach E-Mails mit Besprechungsnotizen vom konfigurierten Absender ab und extrahiert den Google Doc-Link aus jeder E-Mail. Er prüft die Schlüsselspeicherung AIA_Processed_Meetings, um bereits verarbeitete Dokumente zu überspringen. Für neue Dokumente ruft er den Inhalt aus Google Docs ab, sendet ihn an das LLM, um Teilnehmer und Aktionselemente zu extrahieren, schlägt die Salesforce-Kontakt-ID für jeden Teilnehmer nach und erstellt Task- und Event-Datensätze in Salesforce. Jeder Teilnehmer erhält auch eine Slack-Direktnachricht mit der Besprechungszusammenfassung und seinen zugewiesenen Aktionselementen.

Tool - Schedules Notification Email

Dieser Workflow wird nach Zeitplan ausgeführt und übermittelt täglich Zusammenfassungen von Aufgaben und Berichten an alle in der Cloud Datastore-Schlüsselspeicherung AIA_Notification_User_details registrierten Benutzer. Für jeden Benutzer wird die Operation Get Slack User Profile aufgerufen, um zu bestätigen, dass dem Benutzer eine E-Mail-Adresse zugeordnet ist, die Operation Main-AI Logic wird aufgerufen, um offene Aufgaben und Berichte in einem E-Mail-formatiertes Layout zu kompilieren, und die Zusammenfassung wird sowohl an den Slack-Kanal des Benutzers als auch an seine E-Mail-Adresse versendet.

Hinweis

Dieser Workflow wird nicht automatisch ausgeführt. Sie müssen einen Operationszeitplan erstellen und diesen Workflow basierend auf Ihren Benachrichtigungsanforderungen zuweisen.

Projekt-Workflows auslösen

Der Workflow Main Entry - Slack API Request Handler wird automatisch ausgelöst, wenn Benutzer Nachrichten an den Slack Bot senden. Es ist keine manuelle Aktion erforderlich, um bedarfsgesteuerte Interaktionen zu starten.

Diese Workflows müssen so konfiguriert werden, dass sie einmal pro Tag mit Operationszeitplänen ausgeführt werden:

  • Agent - Exception Report Monitor

  • Agent - Meeting Notes

    Hinweis

    Nur die Operation Query Token in diesem Workflow erfordert einen Zeitplan. Konfigurieren Sie diese so, dass sie einmal pro Tag ausgeführt wird.

  • Agent - Open Task Monitoring

  • Tool - Schedules Notification Email

    Hinweis

    Die Standard-Abfrage ruft Daten ab, die auf den aktuellen Tag beschränkt sind. Eine mehrfache Ausführung pro Tag führt zu doppelten Ergebnissen.

Um einen Zeitplan zu konfigurieren, öffnen Sie das Aktionsmenü der Operation und wählen Sie Settings > Schedules (Einstellungen > Zeitpläne).

Fehlerbehebung

Wenn Probleme auftreten, überprüfen Sie die folgenden Protokolle für detaillierte Informationen zur Fehlerbehebung:

Bei Gmail OAuth-Fehlern überprüfen Sie die Operationsprotokolle OAuth Callback und Exchange Token. Bestätigen Sie, dass der Redirect URI in der Google Cloud Console exakt der eingesetzten /oauth/callback API Gateway URL entspricht, ohne nachgestellten Schrägstrich.

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