Jitterbit Account Intelligence Agent

Übersicht

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

Der Agent erhält On-Demand-Anfragen über Slack und verwendet ein LLM, um die Benutzerabsicht zu identifizieren und die relevanten Informationen aus Salesforce abzurufen. Für Besprechungsnotizen fragt der Agent ein dediziertes Gmail-Postfach nach Emails mit Links zu Google Docs ab, extrahiert Aktionspunkte und Teilnehmer mithilfe eines LLM und erstellt entsprechende Aufgaben- und Ereignisdatensätze in Salesforce. Der Sitzungsstatus und OAuth-Token werden im Jitterbit Cloud Datastore gespeichert.

Der Agent führt die folgenden Aufgaben aus:

• Empfängt Anfragen in natürlicher Sprache 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, beschränkt auf die letzten 7 Tage und die nächsten 30 Tage.
• Ruft Ausnahmeberichte aus einem konfigurierten Salesforce-Ordner ab und gibt sie an den anfragenden Benutzer zurück.
• Fragt ein dediziertes Gmail-Postfach nach Emails mit Besprechungsnotizen vom konfigurierten Absender ab, ruft das verlinkte Google-Dokument ab und extrahiert Aktionspunkte und Teilnehmer mithilfe eines LLM.
• Erstellt Salesforce-Aufgaben- und Ereignisdatensätze für jeden Teilnehmer, der in einer Besprechungsnotiz identifiziert wurde.
• Sendet direkte Slack-Nachrichten an die Besprechungsteilnehmer mit einer Zusammenfassung der Besprechung und ihren zugewiesenen Aktionspunkten.
• Sendet geplante Email-Digests und Slack-Benachrichtigungen an registrierte Benutzer, die ihre offenen Aufgaben und Berichtszusammenfassungen enthalten.

Dieses Dokument erklärt, wie man diesen KI-Agenten einrichtet und betreibt. Es behandelt die Architektur und Voraussetzungen, Hinweise zur Aufforderung des Agenten und Schritte zur Installation, Konfiguration und Betrieb des KI-Agenten.

AI-Agent-Architektur

Dieser AI-Agent stellt Kontoinformationen über eine konversationelle Slack-Oberfläche und automatisierte geplante Workflows bereit. Der Agent arbeitet in zwei Hauptflüssen.

On-Demand Slack-Anfragen

Eine typische On-Demand-Interaktion folgt diesen Schritten:

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

Verarbeitung von Besprechungsnotizen

Die Verarbeitung von Besprechungsnotizen folgt diesen Schritten:

1. Der Agent überprüft ein dediziertes Gmail-Postfach auf Emails vom konfigurierten Absender der Besprechungsnotizen.
2. Für jede neue Email 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 Inhalt des Google Docs ab und sendet ihn an das LLM, das die Teilnehmer der Besprechung und die Aktionspunkte extrahiert.
4. Der Agent sucht die Salesforce-Kontakt-ID jedes Teilnehmers und erstellt dann einen Aufgaben-Datensatz für jeden Aktionspunkt und einen Ereignis-Datensatz für jeden Teilnehmer.
5. Der Agent sendet jedem Teilnehmer eine direkte Slack-Nachricht mit der Zusammenfassung der Besprechung und den zugewiesenen Aktionspunkten.

Workflow-Diagramm

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

Voraussetzungen

Sie benötigen die folgenden Komponenten, um diesen AI-Agenten zu verwenden.

Harmony-Komponenten

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

• Jitterbit Studio.
• Jitterbit API Manager, um die Slack- und Gmail-OAuth-Endpunkte bereitzustellen.
• Jitterbit Cloud Datastore, um Gmail-OAuth-Token, verarbeitete Besprechungsunterlagen und Benutzermitteilungsdetails zu speichern.
• Jitterbit Account Intelligence Agent, der als Lizenz-Add-On erworben wurde.

Unterstützte Endpunkte

Der KI-Agent verbindet sich mit den folgenden Endpunkten. Sie können andere Systeme integrieren, indem Sie die Endpunktkonfigurationen und Workflows des Projekts anpassen.

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 eine Azure OpenAI-Ressource mit einem bereitgestellten Modell zu erstellen.

CRM-System

Der Agent liest und schreibt Datensätze in Salesforce. Um Salesforce zu nutzen, benötigen Sie ein Salesforce-Konto mit API-Zugriff und Berechtigungen zum Lesen von Aufgaben, Ereignissen, Kontakten und Berichten sowie zum Erstellen von Aufgaben- und Ereignisdatensätzen.

Email- und Dokumentenplattform

Der Agent verbindet sich mit Gmail, um ein dediziertes Postfach nach Emails mit Besprechungsnotizen zu durchsuchen, und mit Google Docs, um den Inhalt der Besprechungsnotizen abzurufen. Der Zugriff auf Gmail erfolgt über OAuth 2.0-Anmeldeinformationen, und der Zugriff auf Google Docs erfolgt über ein Google Cloud-Dienstkonto. Um diese Dienste zu nutzen, müssen Sie ein Google Cloud-Projekt mit aktivierten Gmail API, Google Docs API und Google Drive API haben, sowie eine OAuth 2.0-Client-ID für Gmail und ein Dienstkonto für Google Docs. Ein dediziertes Gmail-Postfach wird für Besprechungsnotizen empfohlen.

Messaging-Plattform

Der Agent verwendet Slack als seine Konversationsschnittstelle und Benachrichtigungskanal. Um Slack zu nutzen, benötigen Sie einen Slack-Arbeitsbereich mit einer konfigurierten Slack-App, um Nachrichten zu empfangen und zu beantworten. Für detaillierte Anweisungen zur Erstellung einer Slack-App siehe Erstellen einer Slack-App.

Cloud-Datenspeicher

Der Agent verwendet Jitterbit Cloud Datastore, um Gmail-OAuth-Token zu speichern, verarbeitete Besprechungsdokumente zu verfolgen, um doppelte Verarbeitung zu verhindern, und Benutzerdetails für geplante Email-Benachrichtigungen zu verwalten. Cloud Datastore ist Teil der Jitterbit Harmony-Plattform und erfordert kein separates Dienstkonto.

Agent-Prompts

Der Account Intelligence Agent erhält Anfragen auf Abruf in Form von Nachrichten in natürlicher Sprache, die an die Slack-App gesendet werden. Dieser Abschnitt beschreibt die Regeln für effektive Prompts und bietet Beispiel-Prompts.

Prompt-Richtlinien

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

• Anfragen beziehen sich auf den Benutzer, der die Nachricht sendet. Der Agent ruft Aufgaben und Berichte ab, die mit Ihrem Salesforce-Benutzerkonto verknüpft sind, basierend auf Ihrer Slack-Email-Adresse.
• Abfragen zu offenen Aufgaben geben Aufgaben der letzten 7 Tage und der nächsten 30 Tage zurück. Ergebnisse können ungenau sein für Datumsfilter, die älter als 7 Tage sind.
• Bei datumsgefilterten Aufgabenabfragen geben Sie das Ziel-Datum in Ihrer Nachricht in einem erkennbaren Datumsformat an (zum Beispiel "vor dem 30. April" oder "vor dem 2026-04-30").
• Bei Berichtsabfragen geben Sie den genauen Namen des Salesforce-Kontakts an, wie er in dessen Salesforce-Benutzerprofil erscheint.

Beispiel-Prompts

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

Offene Aufgaben

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

Berichte

Verwenden Sie diesen Prompt, um die Details des Ausnahmeberichts für einen bestimmten Kontakt abzurufen. Ersetzen Sie [Contact Name] durch den genauen Namen des Kontakts, wie er in dessen Salesforce-Benutzerprofil erscheint:

Installation, Konfiguration und Betrieb

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

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

Für Troubleshooting-Anleitungen siehe Fehlerbehebung.

Projekt herunterladen und installieren

Befolge diese Schritte, um das Studio-Projekt für den KI-Agenten zu installieren:

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

2. Suche den KI-Agenten mit dem Namen Jitterbit Account Intelligence Agent. Um den Agenten zu finden, benutze die Suchleiste oder wähle im Bereich Filter unter Typ KI-Agent aus, um die Anzeige auf KI-Agenten zu beschränken.

3. Klicke auf den Dokumentations-Link des Agenten, um die Dokumentation in einem separaten Tab zu öffnen. Halte den Tab geöffnet, um später darauf zurückzugreifen, nachdem du das Projekt gestartet hast.

4. Klicke auf Projekt starten, um einen zweistufigen Konfigurationsdialog zu öffnen.

   Hinweis

   Wenn du den KI-Agenten noch nicht gekauft hast, wird stattdessen Diesen Agenten erhalten angezeigt. Klicke darauf, um einen Informationsdialog zu öffnen, und klicke dann auf Absenden, damit ein Vertreter dich bezüglich des Kaufs des KI-Agenten kontaktiert.

5. Wähle in der Konfigurationsstufe 1, Anpassungen herunterladen, die bereitgestellte Manifestdatei der Slack-App herunter. Du wirst diese Datei verwenden, wenn du die Slack-App erstellst.

6. Klicke auf Weiter.

7. Wähle in der Konfigurationsstufe 2, Neues Projekt erstellen, eine Umgebung aus, in der das Studio-Projekt erstellt wird, und klicke dann auf Projekt erstellen.

8. Nachdem der Fortschrittsdialog anzeigt, dass das Projekt erstellt wurde, benutze den Dialoglink Gehe zu Studio oder öffne das Projekt direkt von der Studio-Seite Projekte aus.

Google Cloud einrichten

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

Gmail OAuth einrichten

Die Gmail-Authentifizierung verwendet OAuth 2.0. Jede Bereitstellungsumgebung benötigt ihre eigenen OAuth-Anmeldeinformationen, da die Umleitungs-URI umgebungsabhängig ist.

Befolge diese Schritte für jede Umgebung, in der du den Agenten bereitstellst:

1. Stelle zuerst das Studio-Projekt bereit und notiere die Basis-URL des API-Gateways aus API-Manager > Meine APIs. Diese URL wird benötigt, wenn du die OAuth-Umleitungs-URI in Google Cloud registrierst.

2. Öffnen Sie im Google Cloud Console Ihr Projekt oder erstellen Sie ein neues für diese Integration.

3. Aktivieren Sie die folgenden APIs unter APIs & Dienste > Bibliothek:

   • Gmail API
   • Google Drive API

4. Konfigurieren Sie den OAuth-Zustimmungsbildschirm unter APIs & Dienste > OAuth-Zustimmungsbildschirm. Wählen Sie Intern, wenn das dedizierte Gmail-Konto zu einer Google Workspace-Organisation gehört. Wählen Sie Extern für ein persönliches Gmail-Konto. Fügen Sie die folgenden OAuth-Berechtigungen hinzu:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly

5. Erstellen Sie eine OAuth 2.0-Client-ID unter APIs & Dienste > Anmeldedaten. Wählen Sie Webanwendung als Anwendungstyp.

6. Fügen Sie im Feld Autorisierte Umleitungs-URIs die /oauth/callback-Endpunkt-URL unter Verwendung der in Schritt 1 notierten API-Gateway-Basis-URL im Format: https://<your-org>.jitterbit.com/oauth/callback hinzu.

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

Richten Sie ein Google Docs-Dienstkonto ein

Der Zugriff auf Google Docs verwendet ein Dienstkonto anstelle von Benutzer-OAuth-Anmeldeinformationen.

Befolgen Sie diese Schritte:

1. Öffnen Sie im Google Cloud Console dasselbe Projekt, das für Gmail OAuth verwendet wurde, oder erstellen Sie ein neues.

2. Aktivieren Sie die Google Docs API unter APIs & Dienste > Bibliothek.

3. Klicken Sie unter IAM & Admin > Dienstkonten auf Dienstkonto erstellen. Geben Sie einen Namen und eine Beschreibung ein und klicken Sie dann auf Erstellen und Fortfahren.

4. Weisen Sie dem Dienstkonto eine geeignete Rolle zu (zum Beispiel Betrachter), und klicken Sie dann auf Fertig.

5. Klicken Sie auf das Dienstkonto, um die Details zu öffnen, und wählen Sie dann die Registerkarte Schlüssel.

6. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen, wählen Sie JSON und klicken Sie auf Erstellen. 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 KI-Agenten. Um diese Ressourcen zu erstellen und zu verwalten, benötigen Sie ein Microsoft Azure-Abonnement mit den entsprechenden Berechtigungen.

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

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

Um diese Werte zu finden, befolgen Sie diese Schritte:

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

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

3. Wählen Sie im Navigationsmenü unter Geteilte Ressourcen Bereitstellungen aus. Kopieren Sie den Bereitstellungsnamen.

Die Slack-App erstellen

Um die Slack-Schnittstelle des Agenten zu aktivieren, befolgen Sie diese Schritte:

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

2. Erhalten Sie das Bot-Token und bewahren Sie es für die Projektvariable Bot_oauth_user_token auf.

3. Fügen Sie der App einen Slack-Slash-Befehl hinzu, der die Request-URL auf den benutzerdefinierten API-Endpunkt /connect-gmail verweist. Dieser Befehl ermöglicht es einem Administrator, den Gmail-OAuth-Autorisierungsfluss direkt aus Slack auszulösen.

Cloud Datastore konfigurieren

Der Agent verwendet drei Cloud Datastore-Schlüssel-Speicher, um OAuth-Anmeldeinformationen zu verwalten, verarbeitete Meetings zu deduplizieren und Benutzernachrichtendetails zu speichern:

Erstellen Sie die folgenden Schlüssel-Speicher in Jitterbit Cloud Datastore:

AIA_Authorized_Users

Erstellen Sie einen Schlüssel-Speicher mit dem Namen AIA_Authorized_Users und fügen Sie die folgenden benutzerdefinierten Felder hinzu:

• email (Text)
• refresh_token (Text)
• created_at (Text)

AIA_Processed_Meetings

Erstellen Sie einen Schlüssel-Speicher mit dem Namen AIA_Processed_Meetings und fügen Sie die folgenden benutzerdefinierten Felder hinzu:

• doc_id (Text)
• processed_at (Text)

AIA_Notification_User_details

Erstellen Sie einen Schlüssel-Speicher mit dem Namen AIA_Notification_User_details und fügen Sie die folgenden benutzerdefinierten Felder hinzu:

• SlackChannel (Text)
• SlackuserID (Text)

Projektvariablen konfigurieren

Im Studio-Projekt, das aus dem Marketplace installiert wurde, setzen Sie Werte für die folgenden Projektvariablen.

Um Projektvariablen zu konfigurieren, verwenden Sie das Aktionsmenü des Projekts und wählen Sie Projektvariablen, um die Konfigurationsschublade zu öffnen.

Aktivieren Sie Wert maskieren für alle Anmeldeinformationen und Token-Felder.

Salesforce

Azure OpenAI

Cloud Datastore

Slack

Gmail und Google

Verbindungen testen

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

Um Verbindungen zu testen, gehen Sie zur Projektendpunkte und -verbindungen-Registerkarte der Designkomponentenpalette, fahren Sie mit der Maus über jeden Endpunkt und klicken Sie auf Testen.

Projekt bereitstellen

Projekt bereitstellen Sie das Studio-Projekt.

Um das Projekt bereitzustellen, verwenden Sie das Aktionsmenü des Projekts und wählen Sie Bereitstellen.

Erstellen von Jitterbit benutzerdefinierten APIs

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

Slack-Ereignis-Handler

Erstellen Sie eine benutzerdefinierte API für die Slack Bot-Anfrage-Operation im Workflow Haupteingang - Slack API-Anfrage-Handler.

Konfigurieren Sie diese Einstellungen für den Dienst:

Nach der Veröffentlichung kopieren Sie die API-Dienst-URL und fügen Sie sie in das Feld Event-Subscriptions > Anfrage-URL Ihrer Slack-App ein.

Gmail OAuth-Endpunkte

Erstellen Sie zwei zusätzliche benutzerdefinierte APIs für den Gmail OAuth-Fluss:

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

oauth/callback-Endpunkt — empfängt den Autorisierungscode, nachdem Google zurückgeleitet hat:

Nach der Veröffentlichung beider Endpunkte kehren Sie zur Google Cloud Console zurück und bestätigen Sie, dass die Autorisierte Umleitungs-URI für Ihre OAuth 2.0-Client-ID genau mit der /oauth/callback-URL übereinstimmt.

Abschluss der Gmail OAuth-Autorisierung

Nach der Bereitstellung der APIs führen Sie den OAuth-Autorisierungsfluss aus, um das Gmail-Refresh-Token zu generieren und zu speichern:

1. Triggern Sie den /connect-gmail API-Endpunkt. Dies können Sie über einen Browser, mit dem Slack-Slash-Befehl, der in Erstellen Sie die Slack-App konfiguriert ist, oder indem Sie den Endpunkt direkt aufrufen.

2. Melden Sie sich mit dem speziellen Gmail-Konto für Besprechungsnotizen an und gewähren Sie die angeforderten Berechtigungen für Gmail und Google Drive auf dem Google-Zustimmungsbildschirm.

3. Google leitet zu dem /oauth/callback Endpunkt weiter. Der Agent tauscht den Autorisierungscode gegen Zugriffs- und Refresh-Token aus und speichert das Refresh-Token automatisch im AIA_Authorized_Users Cloud Datastore Schlüssel-Speicher.

4. Öffnen Sie im Studio-Projekt die Projektvariablen und bestätigen Sie, dass refresh_token jetzt einen nicht leeren Wert hat. Wenn es weiterhin leer ist, überprüfen Sie die Protokolle der OAuth Callback und Token austauschen Operationen auf Fehler.

Überprüfen der Projekt-Workflows

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

Anforderungsbearbeitung

Haupteingang - Slack API Anforderungsbearbeiter

Dieser Workflow wird von der Jitterbit benutzerdefinierten API jedes Mal ausgelöst, wenn ein Benutzer eine Nachricht an den Slack-Bot sendet. Er verwaltet eingehende Slack-Bot-Anfragen und pflegt den AIA_Notification_User_details Cloud Datastore Schlüssel-Speicher, um die Slack-Benutzerdetails für geplante Email-Benachrichtigungs-Workflows verfügbar zu halten. Nach der Weiterleitung der Anfrage übergibt dieser Workflow die erforderlichen Informationen an den Workflow Haupt - KI-Agenten-Tools-Logik.

Haupt - KI-Agenten-Tools-Logik

Dieser Workflow empfängt die eingehende Anfrage vom Haupt-Eingang - Slack API-Anforderungs-Handler Workflow, analysiert sie mithilfe des LLM, um die beabsichtigte Funktion zu identifizieren, und bereitet eine Nutzlast vor, um den entsprechenden Agenten-Tool-Workflow zu aktivieren. Dieser Workflow verwaltet auch alle LLM-Anfragen und erfasst die LLM-Antworten für die nachgelagerte Verwendung.

Kontenüberwachung

Agent - Offene Aufgabenüberwachung

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

Agent - Ausnahmeberichtsmonitor

Dieser Workflow ruft Ausnahmeberichte aus einem konfigurierten Salesforce-Ordner ab. Um sich direkt mit der Salesforce-API zu authentifizieren, erhält er zunächst ein Salesforce-Zugriffstoken über OAuth. Anschließend ordnet er die Slack-Email des anfordernden Benutzers dem Salesforce-Benutzerdatensatz zu, ruft die Liste der Berichte aus dem durch die Projektvariable SF_Folder_Id angegebenen Ordner ab und holt die Details jedes relevanten Berichts, um die endgültige Antwort zu erstellen.

Besprechungsnotizen und Benachrichtigungen

Agent - Besprechungsnotizen

Dieser Workflow verwaltet die gesamte Pipeline für Besprechungsnotizen. Ein Administrator löst den Gmail OAuth-Fluss über den API-Endpunkt /connect-gmail aus. Der Workflow tauscht den Autorisierungscode gegen OAuth-Token aus und speichert das Refresh-Token im AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher. Bei jedem geplanten Durchlauf authentifiziert sich der Workflow bei Gmail, durchsucht den Posteingang nach Emails mit Besprechungsnotizen vom konfigurierten Absender und extrahiert den Google Docs-Link aus jeder Email. Er überprüft den AIA_Processed_Meetings Schlüsselspeicher, um bereits verarbeitete Dokumente zu überspringen. Für neue Dokumente ruft er den Inhalt von Google Docs ab, sendet ihn an das LLM, um Teilnehmer und Aktionspunkte zu extrahieren, sucht die Salesforce-Kontakt-ID jedes Teilnehmers und erstellt Aufgaben- und Ereignisdatensätze in Salesforce. Jeder Teilnehmer erhält außerdem eine direkte Slack-Nachricht mit der Zusammenfassung der Besprechung und den ihm zugewiesenen Aktionspunkten.

Tool - Benachrichtigungs-Email für Zeitpläne

Dieser Workflow läuft nach einem Zeitplan, um täglich Aufgaben- und Berichtszusammenfassungen an alle Benutzer zu liefern, die im AIA_Notification_User_details Cloud Datastore-Schlüsselspeicher registriert sind. Für jeden Benutzer ruft er die Operation Get Slack User Profile auf, um zu bestätigen, dass der Benutzer eine zugeordnete Email-Adresse hat, ruft die Operation Main-AI Logic auf, um offene Aufgaben und Berichte in einem Email-formatierten Layout zusammenzustellen, und sendet die Zusammenfassung sowohl an den Slack-Kanal des Benutzers als auch an seine Email-Adresse.

Triggern Sie die Projekt-Workflows

Der Haupt-Eingang - Slack API-Anforderungs-Handler Workflow wird automatisch ausgelöst, wenn Benutzer Nachrichten an den Slack-Bot senden. Es sind keine manuellen Operationen erforderlich, um On-Demand-Interaktionen zu starten.

Die Workflows Agent - Besprechungsnotizen und Tool - Benachrichtigungs-Email für Zeitpläne müssen so konfiguriert werden, dass sie auf Betriebszeitplänen ausgeführt werden. Zwei Zeitpläne haben spezifische Anforderungen:

• Agent - Besprechungsnotizen: Zeitplan, der in einer Frequenz ausgeführt wird, die mit Ihrem Besprechungstakt übereinstimmt. Es ist sicher, ihn mehrmals täglich auszuführen, da die verarbeiteten Dokumenten-IDs in Cloud Datastore verfolgt werden, um doppelte Datensätze zu verhindern.
• Tool - Benachrichtigungs-Email für Zeitpläne: Zeitplan, der einmal täglich ausgeführt wird. Die Standardabfrage ruft Daten ab, die auf den aktuellen Tag beschränkt sind, sodass eine Ausführung mehr als einmal täglich doppelte Ergebnisse zurückgibt.

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

Fehlersuche

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

• API-Protokolle
• Betriebsprotokolle

Bei Gmail OAuth-Fehlern überprüfen Sie die Protokolle der OAuth-Rückruf- und Token-Austausch-Operationen. Bestätigen Sie, dass die Umleitungs-URI in der Google Cloud Console genau mit der bereitgestellten /oauth/callback API-Gateway-URL übereinstimmt, ohne abschließenden Schrägstrich.

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