Zum Inhalt springen

Jitterbit Meeting Notes Agent

Übersicht

Der Jitterbit Meeting Notes Agent (Meeting Notes Agent) ist ein KI-Agent, der über den Jitterbit Marketplace verfügbar ist und die Verarbeitung von Besprechungsnotizen automatisiert, die von Gemini erstellt werden. Der Agent überwacht ein dediziertes Gmail-Postfach, ruft verlinkte Google Docs ab und integriert sich mit Salesforce und Slack, um die Teilnehmer der Besprechung informiert und verantwortlich zu halten.

Im täglichen Rhythmus ruft der Agent neue Emails mit Besprechungsnotizen von Gmail ab und extrahiert den Inhalt der in jeder Email verlinkten Google Docs. Der extrahierte Inhalt wird von einem LLM analysiert, das eine strukturierte Zusammenfassung der Besprechung, nächste Schritte und Aktionspunkte pro Teilnehmer als JSON-Antwort zurückgibt. Für jeden Teilnehmer fragt der Agent Salesforce ab, um den Kontaktdatensatz abzurufen, erstellt eine Aufgabe und ein Ereignis, die mit diesem Datensatz verknüpft sind, und sendet eine personalisierte Slack-Direktnachricht mit der Zusammenfassung der Besprechung und den individuellen Aktionspunkten. Ein Jitterbit Cloud Datastore verwaltet die Speicherung von OAuth-Token und die Duplikatsvermeidung, um eine erneute Verarbeitung zu verhindern. Ein sekundärer Workflow ermöglicht die on-demand Abfrage von Aufgaben über einen API-Trigger.

Der Agent führt die folgenden Aufgaben aus:

  • Überwacht ein Gmail-Postfach im 24-Stunden-Rhythmus nach Emails mit Besprechungsnotizen von Gemini.
  • Ruft den Textinhalt aus verlinkten Google Docs ab und extrahiert ihn.
  • Vermeidet Duplikate verarbeiteter Besprechungsnotizen mithilfe des Cloud Datastore, um eine erneute Verarbeitung zu verhindern.
  • Generiert strukturierte Zusammenfassungen von Besprechungen, nächste Schritte und Aktionspunkte pro Teilnehmer mithilfe eines LLM.
  • Erstellt Salesforce-Aufgaben und -Ereignisse für jeden Teilnehmer der Besprechung.
  • Sendet personalisierte Slack-Direktnachrichten mit Zusammenfassungen der Besprechung und individuellen Aktionspunkten.
  • Reagiert auf on-demand Anfragen zu Besprechungsaufgaben über einen API-Trigger.

Der Agent ist vorkonfiguriert, um mit diesen Diensten zu arbeiten. Sie können ihn an andere Systeme anpassen, indem Sie die Endpunktkonfigurationen und Workflows ändern.

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

AI-Agent-Architektur

Der Meeting Notes Agent läuft als geplanter, unbeaufsichtigter Workflow, der Gmail, Google Docs, ein LLM, Salesforce und Slack über ein Studio-Projekt verbindet. Ein Cloud Datastore Schlüssel-Speicher speichert Gmail OAuth-Token und verfolgt, welche Meeting-Notizen bereits verarbeitet wurden.

Eine typische Interaktion verläuft wie folgt:

  1. Ein Betriebszeitplan löst den Polling-Workflow alle 24 Stunden aus.
  2. Der Agent fragt einen Cloud Datastore Schlüssel-Speicher nach dem gespeicherten Gmail OAuth-Refresh-Token und tauscht ihn gegen ein frisches Zugriffstoken aus.
  3. Der Agent durchsucht das Gmail-Postfach nach Emails von gemini-notes@google.com im vorherigen 24-Stunden-Fenster und ruft die Liste der übereinstimmenden Nachrichten-IDs ab.
  4. Für jede Email ruft der Agent den vollständigen Nachrichteninhalt ab und extrahiert die eingebettete Google Doc-URL, um dann die Dokumenten-ID aus der URL zu parsen.
  5. Der Agent fragt den Cloud Datastore Schlüssel-Speicher ab, um zu überprüfen, ob die Dokumenten-ID bereits verarbeitet wurde. Wenn ja, wird das Dokument übersprungen.
  6. Für neue Dokumente schreibt der Agent die Dokumenten-ID als processed in den Cloud Datastore Schlüssel-Speicher und ruft den Klartextinhalt über die Google Docs Export-API ab.
  7. Der Agent sendet den Dokumentinhalt an ein LLM, das ein strukturiertes JSON-Objekt mit der Zusammenfassung des Meetings, den nächsten Schritten und den Aktionspunkten pro Teilnehmer zurückgibt.
  8. Für jeden Aktionspunkt-Eigentümer, der in der LLM-Antwort identifiziert wurde, ermittelt der Agent die Email des Teilnehmers aus der extrahierten Teilnehmerliste und fragt Salesforce ab, um die Contact ID des Teilnehmers abzurufen.
  9. Der Agent erstellt einen Salesforce Task-Datensatz für jeden Aktionspunkt und einen Salesforce Event-Datensatz, der das Meeting darstellt, beide verknüpft mit dem Kontakt des Teilnehmers.
  10. Der Agent sendet eine personalisierte Slack-Direktnachricht an jeden Teilnehmer, die die Zusammenfassung des Meetings und ihre individuellen Aktionspunkte enthält.

Workflow-Diagramm

Das folgende Diagramm zeigt den Hauptworkflow zur Bearbeitung von Anfragen für den Meeting Notes Agent.

--- config: flowchart: padding: 20 nodeSpacing: 80 --- flowchart LR classDef default fill:white, stroke:black, stroke-width:3px, rx:15px, ry:15px SCHED@{ shape: delay, label: "Operation schedule
(daily)" } JSP@{ shape: hex, label: "
Meeting Notes
Agent" } CDS@{ shape: hex, label: "fas:fa-database
Cloud Datastore" } GMAIL[fas:fa-envelope
Gmail] GDOCS[Google Docs] LLM[fas:fa-brain
LLM] SF[fab:fa-salesforce
Salesforce] SLK[fab:fa-slack
Slack] SCHED -->|1. Trigger| JSP JSP <-->|2. OAuth tokens| CDS JSP <-->|3. Meeting note emails| GMAIL JSP <-->|4. Document content| GDOCS JSP <-->|5. Meeting summary and action items| LLM JSP <-->|6. Contact lookup, Task and Event creation| SF JSP -->|7. Personalized DMs| SLK

Voraussetzungen

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

Harmony-Komponenten

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

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 Agent verwendet OpenAI GPT-4o, um den Inhalt von Meeting-Notizen zu analysieren und eine strukturierte Zusammenfassung des Meetings, nächste Schritte und Aufgaben für die Teilnehmer zu erstellen. Sie müssen über ein OpenAI-Konto mit Zugriff auf das GPT-4o-Modell und einen gültigen API-Schlüssel verfügen.

Gmail

Der Agent überwacht ein dediziertes Gmail-Postfach auf Gemini-Meeting-Notizen-Emails von gemini-notes@google.com unter Verwendung der Gmail REST API. Sie müssen ein Google Cloud-Projekt mit aktivierter Gmail-API und konfigurierten OAuth 2.0-Anmeldeinformationen (Client-ID und Client-Geheimnis) für das Postfach haben.

Google Docs

Der Agent ruft den Dokumenteninhalt von Google Docs über die Google Drive API mit der Methode files.export ab. Der Zugriff erfolgt über dieselben Google OAuth 2.0-Anmeldeinformationen, die für Gmail konfiguriert sind, vorausgesetzt, das zugehörige Google-Konto hat Lesezugriff auf die Meeting-Notizdokumente.

Salesforce

Der Agent fragt Salesforce-Kontaktdatensätze ab und erstellt Task- und Event-Datensätze. Sie müssen über ein Salesforce-Konto mit einem Anmeldenamen, Passwort und Sicherheitstoken verfügen.

Slack

Der Agent sendet Direktnachrichten an die Teilnehmer von Besprechungen über die Slack Web API. Sie müssen eine Slack-App mit einem Bot-Token haben, das mit den folgenden OAuth-Berechtigungen konfiguriert ist: users:read, users:read.email, conversations:open und chat:write.

Cloud Datastore

Der Agent verwendet Jitterbit Cloud Datastore, um Gmail OAuth-Refresh-Token zu speichern und um verarbeitete Besprechungsdokument-IDs zu verfolgen.

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. Cloud Datastore vorbereiten
  3. Projektvariablen konfigurieren
  4. Verbindungen testen
  5. Projekt bereitstellen
  6. Die benutzerdefinierte Jitterbit-API erstellen
  7. Google OAuth-Anmeldeinformationen einrichten
  8. Zugriff auf Gmail autorisieren
  9. Projekt-Workflows überprüfen
  10. Projekt-Workflows auslösen

Für Anleitungen zur Fehlersuche siehe Fehlerbehebung.

Projekt herunterladen und installieren

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

  1. Melden Sie sich im Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie den Marktplatz.
  2. Suchen Sie den KI-Agenten mit dem Namen Meeting Notes Agent. Um den Agenten zu finden, verwenden Sie die Suchleiste oder wählen Sie im Bereich Filter unter Typ KI-Agent aus, um die Anzeige auf KI-Agenten zu beschränken.
  3. Klicken Sie auf den Dokumentations-Link des Agenten, um dessen Dokumentation in einem separaten Tab zu öffnen. Halten Sie den Tab geöffnet, um später darauf zurückzugreifen, nachdem Sie das Projekt gestartet haben.
  4. Klicken Sie auf Projekt starten, um einen Konfigurationsdialog zu öffnen.

    Hinweis

    Wenn Sie den KI-Agenten noch nicht gekauft haben, wird stattdessen Agent erhalten angezeigt. Klicken Sie darauf, um einen Informationsdialog zu öffnen, und klicken Sie dann auf Absenden, damit ein Vertreter Sie bezüglich des Kaufs des KI-Agenten kontaktieren kann.

  5. Im Dialogfeld Neues Projekt erstellen wählen Sie eine Umgebung aus, in der das Studio-Projekt erstellt wird, und klicken Sie dann auf Projekt erstellen.

  6. Nachdem der Fortschrittsdialog anzeigt, dass das Projekt erstellt wurde, verwenden Sie den Dialoglink Gehe zu Studio oder öffnen Sie das Projekt direkt von der Studio-Seite Projekte.

Cloud Datastore vorbereiten

Der Agent verwendet zwei Cloud Datastore-Schlüssel-Speicher, um Gmail OAuth-Refresh-Token zu speichern und verarbeitete Meeting-Dokument-IDs zu verfolgen:

Schlüssel-Speicher Zweck
AIA_Authorized_Users Speichert das Gmail OAuth-Refresh-Token und die zugehörige Gmail-Adresse, die für die Authentifizierung bei geplanten Ausführungen verwendet wird.
AIA_Processed_Meetings Speichert verarbeitete Dokument-IDs und verhindert, dass der Agent bereits bearbeitete Meeting-Notizen erneut verarbeitet.

Erstellen Sie jeden Schlüssel-Speicher mit den folgenden benutzerdefinierten Feldern:

AIA_Authorized_Users

Feld Gespeicherter Wert
Key Gmail OAuth-Refresh-Token
Value Gmail-Adresse, die mit dem Token verknüpft ist

AIA_Processed_Meetings

Feld Gespeicherter Wert
Key Google Doc-ID
Value processed

Nachdem Sie jeden Schlüssel-Speicher erstellt haben, konfigurieren Sie die zugehörigen Cloud Datastore-Aktivitäten im Studio:

  1. Gehen Sie im Studio-Projekt auf die Registerkarte Komponenten unter Endpoints und suchen Sie jede Cloud Datastore-Aktivität, die mit diesem Speicher verknüpft ist.
  2. Doppelklicken Sie, um die Aktivität zu öffnen, weisen Sie den Speicher-Namen zu und speichern Sie.

Projektvariablen konfigurieren

Im im Marketplace installierten Studio-Projekt legen Sie Werte für die folgenden Projektvariablen fest.

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

Hinweis

Geben Sie maskierte Variablen direkt in das Feld Maskenwert ein, um zu verhindern, dass Werte in den Betriebsprotokollen angezeigt werden.

Google OAuth

Variablenname Beschreibung
client_id Google OAuth 2.0-Client-ID für den Zugriff auf die Gmail- und Google Docs-API.
client_secret Google OAuth 2.0-Client-Geheimnis.
refresh_token Gmail OAuth-Aktualisierungstoken für das dedizierte Postfach. Vor dem ersten Lauf leer lassen. Dieser Wert wird automatisch nach Abschluss des Gmail-Autorisierungsschritts ausgefüllt.

OpenAI

Variablenname Beschreibung
open_ai_token OpenAI-API-Schlüssel für den Zugriff auf GPT-4o.

Salesforce

Variablenname Beschreibung
Salesforce_user Salesforce-Anmeldename.
salesforce_password Salesforce-Anmeldepasswort.
salesforce_token Salesforce-Sicherheitstoken, das dem Passwort für die API-Authentifizierung angehängt wird.

Slack

Variablenname Beschreibung
slack_access_token Slack-Bot-Token mit den Berechtigungen users:read, users:read.email, conversations:open und chat:write.
slack_id Slack-Benutzer-ID des Bots oder des Zielbenutzers. Wird zur Laufzeit über die Slack-API users.lookupByEmail gefüllt.

Cloud Datastore

Variablenname Beschreibung
datastore_token Bearer-Token zur Authentifizierung von Anfragen an die Cloud Datastore-Schlüssel-Speicher AIA_Authorized_Users und AIA_Processed_Meetings.

Testverbindungen

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

Um Verbindungen zu testen, gehe zum Tab Projektendpunkte und -verbinder in der Design-Komponentenpalette, fahre mit der Maus über jeden Endpunkt und klicke auf Test.

Projekt bereitstellen

Stelle das Studio-Projekt bereit.

Um das Projekt bereitzustellen, verwende das Aktionsmenü des Projekts und wähle Bereitstellen.

Erstelle die benutzerdefinierte Jitterbit-API

Erstelle eine benutzerdefinierte API mit den folgenden API-Diensten:

Nachdem du jeden API-Dienst konfiguriert hast, veröffentliche die benutzerdefinierte API.

Tipp

Du kannst auch ein Sicherheitsprofil zur Authentifizierung hinzufügen.

Gmail verbinden

Konfigurieren Sie diesen API-Dienst mit den folgenden Parametern:

Einstellung Wert
Dienstname Gmail verbinden
Operation Gmail verbinden
Pfad /connectgmail
Methode POST
Antworttyp Systemvariable

OAuth-Rückruf

Konfigurieren Sie diesen API-Dienst mit den folgenden Parametern:

Einstellung Wert
Dienstname OAuth-Rückruf
Operation OAuth-Rückruf
Pfad /oauth/callback
Methode GET
Antworttyp Systemvariable

Besprechungsnotizen ausführen

Konfigurieren Sie diesen API-Dienst mit den folgenden Parametern:

Einstellung Wert
Dienstname Besprechungsnotizen ausführen
Operation Copilot-Trigger
Pfad /runmeetingnotes
Methode POST
Antworttyp Systemvariable

Gmail Copilot verbinden

Konfigurieren Sie diesen API-Dienst mit den folgenden Parametern:

Einstellung Wert
Dienstname Gmail Copilot verbinden
Operation Gmail verbinden
Pfad /connectgmail
Methode GET
Antworttyp Systemvariable

Google OAuth-Anmeldeinformationen einrichten

Jede Jitterbit Umgebung benötigt ihre eigenen OAuth 2.0-Anmeldeinformationen, da die Umleitungs-URI genau mit der API-Dienst-URL der bereitgestellten benutzerdefinierten API übereinstimmen muss. Führen Sie die folgenden Schritte aus, um Anmeldeinformationen für jede Umgebung zu erstellen.

Ein Google Cloud-Projekt erstellen

  1. Öffnen Sie einen Browser und gehen Sie zu https://console.cloud.google.com. Melden Sie sich mit einem Google-Konto an, das die Berechtigung hat, Google Cloud-Projekte für Ihre Organisation zu erstellen oder zu verwalten.

  2. Klicken Sie auf das Dropdown-Menü zur Projektauswahl oben auf der Seite, neben dem Google Cloud-Logo.

  3. Klicken Sie im sich öffnenden Dialogfeld oben rechts auf Neues Projekt.

  4. Geben Sie im Feld Projektname einen beschreibenden Namen wie Meeting Notes Agent QA ein.

  5. Wählen Sie Ihre Organisation aus dem Dropdown-Menü Organisation aus, falls zutreffend. Lassen Sie Standort auf Keine Organisation stehen, wenn Ihr Konto persönlich ist.

  6. Klicken Sie auf Erstellen. Eine Benachrichtigung erscheint, wenn die Bereitstellung abgeschlossen ist.

  7. Klicken Sie auf die Benachrichtigung oder öffnen Sie das Dropdown-Menü zur Projektauswahl erneut und wählen Sie das neue Projekt aus. Bestätigen Sie, dass der Name in der oberen Navigationsleiste angezeigt wird, bevor Sie fortfahren.

Aktivieren Sie die erforderlichen APIs

  1. Gehen Sie in der linken Seitenleiste zu APIs & Dienste > Bibliothek.

  2. Geben Sie in die Suchleiste Gmail API ein. Klicken Sie in den Ergebnissen auf Gmail API und dann auf Aktivieren. Warten Sie auf die Bestätigung, bevor Sie fortfahren.

  3. Kehren Sie zur Bibliothek zurück. Suchen Sie nach Google Docs API. Klicken Sie auf Google Docs API und dann auf Aktivieren.

  4. Kehren Sie zur Bibliothek zurück. Suchen Sie nach Google Drive API. Klicken Sie auf Google Drive API und dann auf Aktivieren.

  5. Bestätigen Sie, dass alle drei APIs aktiv sind, indem Sie zu APIs & Dienste > Aktivierte APIs und Dienste gehen. Alle drei müssen in der Liste erscheinen, bevor Sie fortfahren. Wenn eine API fehlt, schlägt der OAuth-Zustimmungsfluss fehl.

Konfigurieren Sie den OAuth-Zustimmungsbildschirm

  1. Gehen Sie zu APIs & Dienste > OAuth-Zustimmungsbildschirm.

  2. Wählen Sie Intern, wenn das dedizierte Gmail-Konto zu einer Google Workspace-Organisation gehört. Dies beschränkt den Zugriff nur auf Benutzer innerhalb Ihrer Organisation und wird für interne Tools empfohlen. Wählen Sie Extern, wenn Sie ein persönliches Gmail-Konto verwenden. Externe Apps bleiben im Testmodus, bis sie veröffentlicht werden, was die autorisierten Benutzer nur auf die Liste der Testbenutzer beschränkt.

  3. Klicken Sie auf Erstellen.

  4. Füllen Sie auf der Seite App-Informationen das Feld App-Name mit Meeting Notes Agent aus. Geben Sie eine Email-Adresse für den Benutzersupport und mindestens eine Email-Adresse für den Entwicklerkontakt ein. Klicken Sie auf Speichern und Fortfahren.

  5. Klicken Sie auf der Seite Berechtigungen auf Berechtigungen hinzufügen oder entfernen. Suchen Sie nach den folgenden Berechtigungen und fügen Sie diese hinzu: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/documents.readonly und https://www.googleapis.com/auth/drive.readonly. Klicken Sie auf Aktualisieren und dann auf Speichern und Fortfahren.

  6. Wenn Sie Extern ausgewählt haben, erscheint eine Seite mit Testbenutzern. Klicken Sie auf Benutzer hinzufügen und fügen Sie die Email-Adresse des dedizierten Gmail-Postfachs hinzu (zum Beispiel meetingnotes@company.com). Klicken Sie auf Hinzufügen und dann auf Speichern und Fortfahren.

  7. Überprüfen Sie die Zusammenfassung auf dem letzten Bildschirm und klicken Sie auf Zurück zum Dashboard.

Erstellen Sie die OAuth 2.0-Client-ID

  1. Gehen Sie zu APIs & Dienste > Anmeldedaten. Klicken Sie oben auf der Seite auf Anmeldedaten erstellen und wählen Sie OAuth 2.0-Client-ID.

  2. Wählen Sie unter Anwendungstyp Webanwendung aus. Geben Sie im Feld Name eine Bezeichnung wie Meeting Notes Agent - QA ein, um die Identifizierung über verschiedene Umgebungen hinweg zu erleichtern.

  3. Scrollen Sie zum Abschnitt Autorisierte Umleitungs-URIs und klicken Sie auf URI hinzufügen. Geben Sie die Umleitungs-URI ein, indem Sie /oauth/callback an die API-Dienst-URL der benutzerdefinierten API anhängen. Dieser Wert wird im Profil Tab im API Manager als Basis-API-URL bezeichnet. Der Pfad muss genau /oauth/callback ohne nachfolgendem Schrägstrich sein. Jede Abweichung führt zu einem redirect_uri_mismatch-Fehler, wenn der OAuth-Fluss ausgeführt wird.

  4. Klicken Sie auf Erstellen.

Kopieren und speichern Sie die Anmeldedaten

Nachdem Sie auf Erstellen geklickt haben, zeigt Google einen Dialog mit der neuen Client-ID und dem Client-Geheimnis an. Kopieren Sie beide Werte sofort und speichern Sie sie sicher in einem Passwortmanager oder Geheimnisspeicher. Das Client-Geheimnis wird in diesem Dialog nur vollständig angezeigt. Wenn Sie ihn schließen, ohne zu kopieren, können Sie das Geheimnis später auf der Seite Anmeldedaten regenerieren, indem Sie auf Bearbeiten des Anmeldedatensatzes klicken, aber Sie müssen auch die Projektvariable client_secret mit dem neuen Wert aktualisieren. Klicken Sie auf OK, um den Dialog zu schließen, sobald beide Werte gespeichert sind.

Autorisieren Sie den Gmail-Zugriff

Bevor der geplante Polling-Workflow ausgeführt werden kann, muss ein Administrator eine einmalige OAuth 2.0-Autorisierung für das dedizierte Gmail-Postfach abschließen. Dieser Schritt speichert ein Aktualisierungstoken im AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher zur Verwendung in nachfolgenden geplanten Ausführungen.

Um den Gmail-Zugriff zu autorisieren:

  1. Nachdem Sie das Projekt bereitgestellt haben, lösen Sie die Handle Connect Gmail-Operation im Gmail OAuth-Authentifizierung Workflow aus, indem Sie zum /connect-gmail API-Endpunkt navigieren, der vom Jitterbit API Manager veröffentlicht wurde.
  2. Schließen Sie den Google-Zustimmungsbildschirm für das dedizierte Gmail-Konto ab. Google leitet mit einem Autorisierungscode zurück zum Jitterbit API-Callback-Endpunkt um.
  3. Der Agent tauscht den Autorisierungscode gegen Zugriffs- und Aktualisierungstoken aus, ruft die zugehörige Gmail-Adresse ab und speichert das Aktualisierungstoken im AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher.
  4. Bestätigen Sie, dass die Projektvariable refresh_token ausgefüllt ist oder dass ein Datensatz in der AIA_Authorized_Users-Sammlung erscheint, bevor der geplante Polling-Workflow zum ersten Mal ausgeführt wird.

Überprüfung der Projekt-Workflows

Das Studio-Projekt enthält sechs Workflows, die die Funktionalität des Meeting Notes Agent implementieren, organisiert in zwei funktionale Gruppen.

Authentifizierung und Abfrage

Workflow Beschreibung
Gmail OAuth-Authentifizierung Behandelt die einmalige OAuth 2.0-Autorisierung für das dedizierte Gmail-Postfach und speichert das Refresh-Token in Cloud Datastore.
Gmail-Abfrage und Nachrichtenabruf Läuft nach einem 24-Stunden-Zeitplan, um sich bei Gmail zu authentifizieren und neue Meeting-Notiz-Emails abzurufen.
Gmail OAuth-Authentifizierung

Dieser Workflow behandelt den einmaligen OAuth 2.0-Autorisierungsfluss für das dedizierte Gmail-Postfach. Ein Administrator navigiert zu dem /connect-gmail API-Endpunkt, der die Google-Autorisierungs-URL erstellt und zur Google-Zustimmungsseite umleitet. Nach der Zustimmung gibt Google einen Autorisierungscode an den Jitterbit API-Callback-Endpunkt zurück. Der Workflow tauscht den Code gegen Zugriffs- und Refresh-Token aus, ruft die mit dem Token verbundene Gmail-Adresse ab und speichert das Refresh-Token im AIA_Authorized_Users Cloud Datastore-Schlüssel-Speicher zur Wiederverwendung in allen nachfolgenden geplanten Ausführungen.

Gmail-Abfrage und Nachrichtenabruf

Dieser Workflow läuft nach einem 24-Stunden Betriebszeitplan. Er fragt den AIA_Authorized_Users Cloud Datastore-Schlüssel-Speicher nach dem gespeicherten Refresh-Token ab, tauscht es gegen ein frisches Gmail-Zugriffs-Token aus und durchsucht das Gmail-Postfach nach Emails von gemini-notes@google.com innerhalb des vorherigen 24-Stunden-Fensters. Für jede gefundene Nachricht ruft der Workflow die vollständige Nachrichtenpayload ab, dekodiert den Body in Base64, extrahiert die eingebettete Google-Dokument-URL und analysiert die Dokument-ID aus der URL. Jede Dokument-ID wird dann an den Workflow zur Inhaltsextraktion und Duplikatentfernung weitergeleitet.

Verarbeitung von Besprechungsnotizen

Workflow Beschreibung
Google Docs-Inhaltsextraktion und Duplikatentfernung Überprüft, ob eine Besprechungsnotiz bereits verarbeitet wurde, und ruft den Dokumentinhalt ab, wenn es neu ist.
OpenAI GPT-4o-Verarbeitung Sendet den Inhalt der Besprechungsnotiz an das LLM und analysiert die strukturierte Zusammenfassung sowie die Antwort zu den Aktionspunkten.
Salesforce-Aufgaben- und Ereigniserstellung Erstellt Salesforce-Aufgaben- und Ereignisdatensätze für jeden Besprechungsteilnehmer und löst Slack-Benachrichtigungen aus.
Copilot-Abfrage auf Abruf Stellt die Abfrage von Besprechungsaufgaben über einen Jitterbit API Manager API-Trigger auf Abruf zur Verfügung.
Google Docs-Inhaltsextraktion und Duplikatentfernung

Dieser Workflow fragt den AIA_Processed_Meetings Cloud Datastore-Schlüssel-Speicher ab, um festzustellen, ob die aktuelle Dokument-ID bereits verarbeitet wurde. Wenn ein entsprechender Datensatz vorhanden ist, überspringt der Workflow das Dokument. Für neue Dokumente schreibt der Workflow die Dokument-ID in AIA_Processed_Meetings mit dem Wert processed und ruft dann die Google Docs-Export-API auf, um den Dokumentinhalt als einfachen Text abzurufen. Der extrahierte Text wird analysiert, um die Teilnehmerliste zu identifizieren und den Inhalt zwischen den Überschriften Zusammenfassung und Vorgeschlagene nächste Schritte für die nachgelagerte LLM-Verarbeitung zu isolieren.

OpenAI GPT-4o-Verarbeitung

Dieser Workflow erstellt einen Prompt aus dem extrahierten Inhalt der Besprechungsnotiz und sendet ihn an die OpenAI-API. Der Prompt weist das LLM an, ein JSON-Objekt mit den folgenden Schlüsseln zurückzugeben: summary, next_steps und action_items (jeweils mit den Feldern description, owner, due_date und priority). Der Workflow analysiert die Antwort der Chat-Vervollständigung, entfernt alle Markdown-Code-Zäune aus dem Inhaltsblock und iteriert über die Aktionspunkte, um die Payloads pro Teilnehmer für die Salesforce- und Slack-Workflows vorzubereiten.

Salesforce-Aufgaben- und Ereigniserstellung

Dieser Workflow verarbeitet jeden Aktionspunktinhaber, der in der LLM-Antwort identifiziert wurde. Für jeden Inhaber ermittelt der Workflow die Email-Adresse des Teilnehmers aus der extrahierten Teilnehmerliste und führt dann eine SOQL-Abfrage aus, um den Salesforce-Kontaktdatensatz anhand der Email-Adresse abzurufen. Wenn die Abfrage genau einen übereinstimmenden Kontakt zurückgibt, erstellt der Workflow einen Aufgaben-Datensatz mit der Beschreibung des Aktionspunkts, einer Priorität, die aus der LLM-Antwort abgebildet wird (Hoch, Mittel oder Niedrig), einem Fälligkeitsdatum, das aus der LLM-Antwort stammt (standardmäßig sieben Tage ab dem aktuellen Datum, wenn kein Datum angegeben ist), und einem Status von Nicht gestartet. Außerdem wird ein Ereignis-Datensatz erstellt, der das Meeting darstellt, mit einer Dauer von 30 Minuten und einem Aktivitätsdatum und -zeit, die auf den Zeitpunkt gesetzt sind, an dem die Operation ausgeführt wird, und der mit demselben Kontakt verknüpft ist. Wenn die Abfrage null oder mehr als einen übereinstimmenden Kontakt zurückgibt, wird der Aktionspunkt übersprungen. Nachdem die Salesforce-Datensätze erstellt wurden, sendet der Workflow eine personalisierte Slack-Direktnachricht an den Teilnehmer, die die Zusammenfassung des Meetings und seine individuellen Aktionspunkte enthält.

Copilot On-Demand-Abfrage

Dieser Workflow stellt einen benutzerdefinierten API-Endpunkt des Jitterbit API Managers zur Verfügung, der einen user_email-Parameter im Anfragekörper akzeptiert und die Hauptpipeline zur Verarbeitung der Meetingnotizen für den angegebenen Benutzer erneut auslöst.

Triggern der Projekt-Workflows

Nach der Bereitstellung des Projekts wird der primäre Workflow zur Verarbeitung der Meetingnotizen automatisch nach einem 24-Stunden-Betriebszeitplan ausgeführt.

Hinweis

Der Betriebszeitplan ist nicht im Projektexport enthalten und muss nach der Bereitstellung manuell im Studio konfiguriert werden.

Der Workflow zur Gmail OAuth-Authentifizierung muss einmal manuell von einem Administrator ausgelöst werden, der zum benutzerdefinierten API-Endpunkt /connect-gmail navigiert, bevor der geplante Abfrage-Workflow erfolgreich ausgeführt werden kann.

Der Workflow zur Copilot On-Demand-Abfrage wird durch API-Aufrufe an den benutzerdefinierten API-Endpunkt /runmeetingnotes ausgelöst.

Fehlerbehebung

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

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