Zum Inhalt springen

Jitterbit Meeting Notes Agent

Übersicht

Jitterbit stellt Kunden den Meeting Notes Agent über Jitterbit Marketplace zur Verfügung. Dieser Agent automatisiert die Verarbeitung von Besprechungsnotizen, die von Gemini generiert werden. Der Agent fragt ein dediziertes Gmail-Postfach ab, ruft verknüpfte Google Docs ab und integriert sich mit Salesforce und Slack, um Besprechungsteilnehmer informiert und verantwortlich zu halten.

Nach einem täglichen Zeitplan ruft der Agent neue E-Mails mit Besprechungsnotizen aus Gmail ab und extrahiert den Google Doc-Inhalt, der in jeder E-Mail verknüpft ist. Der extrahierte Inhalt wird von einem LLM analysiert, das eine strukturierte Besprechungszusammenfassung, nächste Schritte und Aktionselemente 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, das mit diesem Datensatz verknüpft ist, und sendet eine personalisierte Slack-Direktnachricht mit der Besprechungszusammenfassung und individuellen Aktionselementen. Ein Jitterbit Cloud Datastore verwaltet die OAuth-Token-Speicherung und Deduplizierung, um eine erneute Verarbeitung zu verhindern. Ein sekundärer Workflow stellt den Abruf von Aufgaben auf Anfrage über einen API-Trigger bereit.

Der Agent führt die folgenden Aufgaben aus:

  • Fragt ein Gmail-Postfach nach einem 24-Stunden-Zeitplan nach Gemini-Besprechungsnotiz-E-Mails ab.
  • Ruft Textinhalte aus verknüpften Google Docs ab und extrahiert sie.
  • Dedupliziert verarbeitete Besprechungsnotizen mithilfe von Cloud Datastore, um eine erneute Verarbeitung zu vermeiden.
  • Generiert strukturierte Besprechungszusammenfassungen, nächste Schritte und Aktionselemente pro Teilnehmer mithilfe eines LLM.
  • Erstellt Salesforce-Aufgaben und -Ereignisse für jeden Besprechungsteilnehmer.
  • Sendet personalisierte Slack-Direktnachrichten mit Besprechungszusammenfassungen und individuellen Aktionselementen.
  • Antwortet auf Anfragen zu Besprechungsaufgaben auf Anfrage über einen API-Trigger.

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

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

KI-Agent-Architektur

Der Meeting Notes Agent wird als geplanter, unbeaufsichtigter Workflow ausgeführt, der Gmail, Google Docs, ein LLM, Salesforce und Slack über ein Studio-Projekt verbindet. Ein Cloud Datastore Schlüsselspeicher speichert Gmail OAuth-Token und verfolgt, welche Besprechungsnotizen bereits verarbeitet wurden.

Eine typische Interaktion verläuft wie folgt:

  1. Ein Operationszeitplan löst den Abruf-Workflow alle 24 Stunden aus.
  2. Der Agent fragt einen Cloud Datastore-Schlüsselspeicher nach dem gespeicherten Gmail OAuth-Aktualisierungstoken ab und tauscht ihn gegen ein neues Zugriffstoken aus.
  3. Der Agent durchsucht das Gmail-Postfach nach E-Mails von gemini-notes@google.com innerhalb des vorherigen 24-Stunden-Fensters und ruft die Liste der übereinstimmenden Nachrichten-IDs ab.
  4. Für jede E-Mail ruft der Agent den vollständigen Nachrichteninhalt ab und extrahiert die eingebettete Google Doc-URL, dann analysiert die Dokument-ID aus der URL.
  5. Der Agent fragt den Cloud Datastore-Schlüsselspeicher ab, um zu überprüfen, ob die Dokument-ID bereits verarbeitet wurde. Falls ja, wird das Dokument übersprungen.
  6. Für neue Dokumente schreibt der Agent die Dokument-ID als processed in den Cloud Datastore-Schlüsselspeicher und ruft den Nur-Text-Inhalt aus der Google Docs-Export-API ab.
  7. Der Agent sendet den Dokumentinhalt an ein LLM, das ein strukturiertes JSON-Objekt mit der Besprechungszusammenfassung, nächsten Schritten und Aktionselementen pro Teilnehmer zurückgibt.
  8. Für jeden Aktionselementverantwortlichen, der in der LLM-Antwort identifiziert wird, löst der Agent die E-Mail des Teilnehmers aus der extrahierten Teilnehmerliste auf und fragt Salesforce ab, um die Contact ID des Teilnehmers abzurufen.
  9. Der Agent erstellt einen Salesforce Task-Datensatz für jedes Aktionselement und einen Salesforce Event-Datensatz, der die Besprechung darstellt, beide verknüpft mit dem Kontakt des Teilnehmers.
  10. Der Agent sendet eine personalisierte Slack-Direktnachricht an jeden Teilnehmer mit der Besprechungszusammenfassung und seinen individuellen Aktionselementen.

Workflow-Diagramm

Das folgende Diagramm zeigt den Hauptanfrage-Verarbeitungsworkflow 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

Für die Verwendung dieses KI-Agenten benötigen Sie die folgenden Komponenten.

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 ändern.

Large Language Model (LLM)

Der Agent nutzt OpenAI GPT-4o, um Inhalte von Besprechungsnotizen zu analysieren und eine strukturierte Besprechungszusammenfassung, nächste Schritte und Aktionselemente pro Teilnehmer zu erstellen. Sie benötigen ein OpenAI-Konto mit Zugriff auf das GPT-4o-Modell und einen gültigen API-Schlüssel.

Gmail

Der Agent fragt ein dediziertes Gmail-Postfach nach Gemini-Besprechungsnotiz-E-Mails von gemini-notes@google.com ab und nutzt dazu die Gmail REST API. Sie benötigen ein Google Cloud-Projekt mit aktivierter Gmail API und konfigurierte OAuth 2.0-Anmeldedaten (Client-ID und Client-Geheimnis) für das Postfach.

Google Docs

Der Agent ruft Dokumentinhalte aus Google Docs mithilfe der Google Drive API-Methode files.export ab. Der Zugriff nutzt die gleichen Google OAuth 2.0-Anmeldedaten, die für Gmail konfiguriert wurden, sofern das zugehörige Google-Konto Lesezugriff auf die Besprechungsnotiz-Dokumente hat.

Salesforce

Der Agent fragt Salesforce-Kontaktdatensätze ab und erstellt Task- und Event-Datensätze. Sie benötigen ein Salesforce-Konto mit Anmeldebenutzername, Passwort und Sicherheitstoken.

Slack

Der Agent sendet Direktnachrichten an Besprechungsteilnehmer mithilfe der Slack Web API. Sie benötigen eine Slack-App mit einem Bot-Token, der mit den folgenden OAuth-Bereichen konfiguriert ist: users:read, users:read.email, conversations:open und chat:write.

Cloud Datastore

Der Agent nutzt Jitterbit Cloud Datastore, um Gmail OAuth-Aktualisierungstoken zu speichern und verarbeitete Besprechungsdokument-IDs zu verfolgen.

Installation, Konfiguration und Betrieb

Führen Sie diese Schritte aus, 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. Benutzerdefinierte Jitterbit API erstellen
  7. Google OAuth-Anmeldedaten einrichten
  8. Gmail-Zugriff autorisieren
  9. Projekt-Workflows überprüfen
  10. Projekt-Workflows auslösen

Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung.

Projekt herunterladen und installieren

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

  1. Melden Sie sich beim Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.
  2. Suchen Sie den KI-Agenten mit dem Namen Meeting Notes Agent. Nutzen Sie die Suchleiste oder wählen Sie im Bereich Filter unter Typ die Option AI Agent aus, um die Anzeige auf KI-Agenten zu beschränken.
  3. Klicken Sie auf den Link Documentation des Agenten, um seine Dokumentation in einem neuen Tab zu öffnen. Halten Sie den Tab offen, um später darauf zurückzugreifen.
  4. Klicken Sie auf Start Project, um ein Konfigurationsdialogfeld zu öffnen.

    Hinweis

    Falls Sie den KI-Agenten noch nicht erworben haben, wird stattdessen Get agent angezeigt. Klicken Sie darauf, um ein Informationsdialogfeld zu öffnen, und klicken Sie dann auf Submit, damit ein Vertreter Sie zum Kauf des KI-Agenten kontaktiert.

  5. Wählen Sie im Dialog Neues Projekt erstellen eine Umgebung aus, in der das Studio-Projekt erstellt werden soll, und klicken Sie dann auf Projekt erstellen.

  6. Nachdem das Fortschrittsdialog anzeigt, dass das Projekt erstellt wurde, verwenden Sie den Dialoglink Zu Studio gehen oder öffnen Sie das Projekt direkt über die Seite Studio Projekte.

Cloud Datastore vorbereiten

Der Agent verwendet zwei Cloud Datastore-Schlüsselspeicher, um Gmail-OAuth-Aktualisierungstoken zu speichern und verarbeitete Besprechungsdokument-IDs zu verfolgen:

Schlüsselspeicher Zweck
AIA_Authorized_Users Speichert die Slack-Benutzer-ID (Schlüssel), das OAuth-Token (Wert) und die E-Mail-Adresse des Benutzers (Value1) für autorisierte Benutzer.
AIA_Processed_Meetings Speichert verarbeitete Dokument-IDs und verhindert, dass der Agent Besprechungsnotizen, die er bereits verarbeitet hat, erneut verarbeitet.

Erstellen Sie jeden Schlüsselspeicher mit den folgenden benutzerdefinierten Feldern:

AIA_Authorized_Users

Feld Gespeicherter Wert
Key Slack-Benutzer-ID
Value OAuth-Token
Value1 E-Mail-Adresse

AIA_Processed_Meetings

Feld Gespeicherter Wert
Key Google Doc-ID
Value processed

Konfigurieren Sie nach dem Erstellen jedes Schlüsselspeichers die zugehörigen Cloud Datastore-Aktivitäten in Studio:

  1. Suchen Sie auf der Registerkarte Komponenten des Studio-Projekts unter Endpunkte jede Cloud Datastore-Aktivität, die diesem Speicher zugeordnet ist.
  2. Doppelklicken Sie, um die Aktivität zu öffnen, weisen Sie den Speichernamen zu und speichern Sie.

Projektvariablen konfigurieren

Legen Sie im aus dem Marketplace installierten Studio-Projekt Werte für die folgenden Projektvariablen fest.

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

Hinweis

Geben Sie maskierte Variablen direkt in das Feld Wert maskieren ein, um zu verhindern, dass Werte in Operationsprotokollen angezeigt werden.

Google OAuth

Variablenname Beschreibung
client_id Google OAuth 2.0-Client-ID für Gmail- und Google Docs API-Zugriff.
client_secret Google OAuth 2.0-Client-Secret.
refresh_token Gmail-OAuth-Aktualisierungstoken für den dedizierten Posteingang. Lassen Sie dieses Feld vor der ersten Ausführung leer. Dieser Wert wird nach Abschluss des Gmail-Autorisierungsschritts automatisch ausgefüllt.

OpenAI

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

Salesforce

Variablenname Beschreibung
Salesforce_user Salesforce-Anmeldebenutzername.
salesforce_password Salesforce-Anmeldekennwort.
salesforce_token Salesforce-Sicherheitstoken, das an das Kennwort für die API-Authentifizierung angehängt wird.

Slack

Variablenname Beschreibung
slack_access_token Slack-Bot-Token mit den Bereichen 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üsselspeicher AIA_Authorized_Users und AIA_Processed_Meetings.

Verbindungen testen

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

Um Verbindungen zu testen, rufen Sie die Registerkarte Projektendpunkte und Konnektoren in der Designkomponentenpalette auf, fahren Sie mit der Maus über jeden Endpunkt und klicken Sie auf Testen.

Projekt bereitstellen

Stellen Sie das Studio-Projekt bereit.

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

Benutzerdefinierte Jitterbit-API erstellen

Erstellen Sie eine benutzerdefinierte API mit den folgenden API-Services:

Nachdem Sie jeden API-Service konfiguriert haben, veröffentlichen Sie die benutzerdefinierte API.

Tipp

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

Gmail verbinden

Konfigurieren Sie diesen API-Service mit den folgenden Parametern:

Einstellung Wert
Servicename Connect Gmail
Operation Handle Connect Gmail
Pfad /connectgmail
Methode POST
Antworttyp System Variable

OAuth-Callback

Konfigurieren Sie diesen API-Service mit den folgenden Parametern:

Einstellung Wert
Servicename OAuth Callback
Operation OAuth Callback
Pfad /oauth/callback
Methode GET
Antworttyp System Variable

Besprechungsnotizen ausführen

Konfigurieren Sie diesen API-Service mit den folgenden Parametern:

Einstellung Wert
Servicename Run Meeting Notes
Operation Copilot trigger
Pfad /runmeetingnotes
Methode POST
Antworttyp System Variable

Gmail Copilot verbinden

Konfigurieren Sie diesen API-Service mit den folgenden Parametern:

Einstellung Wert
Servicename Connect Gmail Copilot
Operation Handle Connect Gmail
Pfad /connectgmail
Methode GET
Antworttyp System Variable

Google-OAuth-Anmeldedaten einrichten

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

Google-Cloud-Projekt erstellen

  1. Öffnen Sie einen Browser und navigieren 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 Projekt-Dropdown-Menü oben auf der Seite neben dem Google Cloud-Logo.

  3. Klicken Sie im angezeigten Dialog oben rechts auf Neues Projekt.

  4. Geben Sie im Feld Projektname einen aussagekräftigen Namen ein, z. B. Meeting Notes Agent QA.

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

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

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

Erforderliche APIs aktivieren

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

  2. Geben Sie in der Suchleiste Gmail API ein. Klicken Sie in den Ergebnissen auf Gmail API und klicken Sie 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 klicken Sie auf Aktivieren.

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

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

OAuth-Zustimmungsbildschirm konfigurieren

  1. Gehen Sie zu APIs & Services > OAuth consent screen.

  2. Wählen Sie Intern aus, wenn das dedizierte Gmail-Konto zu einer Google Workspace-Organisation gehört. Dies beschränkt den Zugriff auf Benutzer innerhalb Ihrer Organisation und wird für interne Tools empfohlen. Wählen Sie Extern aus, wenn Sie ein persönliches Gmail-Konto verwenden. Externe Apps bleiben im Testmodus, bis sie veröffentlicht werden, was autorisierte Benutzer 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 E-Mail-Adresse für Benutzerunterstützung und mindestens eine E-Mail-Adresse für Entwicklerkontakt ein. Klicken Sie auf Speichern und Weiter.

  5. Klicken Sie auf der Seite Bereiche auf Bereiche hinzufügen oder entfernen. Suchen Sie nach den folgenden Bereichen und fügen Sie sie 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 Weiter.

  6. Wenn Sie Extern ausgewählt haben, wird eine Seite Testbenutzer angezeigt. Klicken Sie auf Benutzer hinzufügen und fügen Sie die E-Mail-Adresse des dedizierten Gmail-Postfachs hinzu (z. B. meetingnotes@company.com). Klicken Sie auf Hinzufügen und dann auf Speichern und Weiter.

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

OAuth 2.0-Client-ID erstellen

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

  2. Wählen Sie unter Anwendungstyp die Option Webanwendung aus. Geben Sie im Feld Name ein Label wie Meeting Notes Agent - QA ein, um die Identifizierung in verschiedenen Umgebungen 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-Service-URL für die benutzerdefinierte API anhängen. Dieser Wert wird auf der Registerkarte Profil der API im API Manager als Basis-API-URL bezeichnet. Der Pfad muss genau /oauth/callback ohne nachgestellten Schrägstrich sein. Jede Abweichung verursacht einen redirect_uri_mismatch-Fehler, wenn der OAuth-Fluss ausgeführt wird.

  4. Klicken Sie auf Erstellen.

Anmeldedaten kopieren und speichern

Nach dem Klicken auf Erstellen zeigt Google einen Dialog mit der neuen Client-ID und dem Client-Secret an. Kopieren Sie beide Werte sofort und speichern Sie sie sicher in einem Passwort-Manager oder Secrets Vault. Das Client-Secret wird nur in diesem Dialog vollständig angezeigt. Wenn Sie es schließen, ohne es zu kopieren, können Sie das Secret später auf der Seite Anmeldedaten regenerieren, indem Sie auf Bearbeiten für den Anmeldedateneintrag klicken. Sie müssen dann aber 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.

Gmail-Zugriff autorisieren

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

So autorisieren Sie den Gmail-Zugriff:

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

Projekt-Workflows überprüfen

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

Authentifizierung und Polling

Workflow Beschreibung
Gmail OAuth Authentication Verwaltet die einmalige OAuth 2.0-Autorisierung für das dedizierte Gmail-Postfach und speichert das Aktualisierungstoken in Cloud Datastore.
Gmail Polling and Message Retrieval Wird nach einem 24-Stunden-Plan ausgeführt, um sich bei Gmail zu authentifizieren und neue E-Mails mit Besprechungsnotizen abzurufen.
Gmail OAuth Authentication

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

Gmail Polling and Message Retrieval

Dieser Workflow wird nach einem 24-Stunden-Operationsplan ausgeführt. Er fragt den Cloud Datastore-Schlüsselspeicher AIA_Authorized_Users nach dem gespeicherten Aktualisierungstoken ab, tauscht ihn gegen ein neues Gmail-Zugriffstoken aus und durchsucht das Gmail-Postfach nach E-Mails von gemini-notes@google.com innerhalb des vorherigen 24-Stunden-Fensters. Für jede gefundene Nachricht ruft der Workflow die vollständige Nachrichtennutzlast ab, dekodiert den Text mit Base64, extrahiert die eingebettete Google Doc-URL und analysiert die Dokument-ID aus der URL. Jede Dokument-ID wird dann an den Workflow zur Inhaltsextraktion und Deduplizierung weitergeleitet.

Verarbeitung von Besprechungsnotizen

Workflow Beschreibung
Google Docs Content Extraction and Deduplication Prüft, ob eine Besprechungsnotiz bereits verarbeitet wurde, und ruft Dokumentinhalte ab, falls neu.
OpenAI GPT-4o Processing Sendet Besprechungsnotizeninhalte an das LLM und analysiert die strukturierte Zusammenfassung und Antwort zu Aktionselementen.
Salesforce Task and Event Creation Erstellt Salesforce Task- und Event-Datensätze für jeden Besprechungsteilnehmer und löst Slack-Benachrichtigungen aus.
Copilot On-Demand Query Stellt den On-Demand-Abruf von Besprechungsaufgaben über einen Jitterbit API Manager API-Trigger bereit.
Inhaltsextraktion und Deduplizierung aus Google Docs

Dieser Workflow fragt den AIA_Processed_Meetings Cloud Datastore-Schlüsselspeicher ab, um zu prüfen, ob die aktuelle Dokument-ID bereits verarbeitet wurde. Existiert ein entsprechender Datensatz, überspringt der Workflow das Dokument. Bei neuen Dokumenten schreibt der Workflow die Dokument-ID in AIA_Processed_Meetings mit dem Wert processed, ruft dann die Google Docs-Export-API auf, um den Dokumentinhalt als Klartext abzurufen. Der extrahierte Text wird analysiert, um die Teilnehmerliste zu identifizieren und den Inhalt zwischen den Überschriften „Summary" und „Suggested next steps" für die nachgelagerte LLM-Verarbeitung zu isolieren.

OpenAI GPT-4o-Verarbeitung

Dieser Workflow erstellt einen Prompt aus dem extrahierten Besprechungsnotiz-Inhalt 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 Chat-Completion-Antwort, entfernt alle Markdown-Code-Fences aus dem Inhaltsblock und iteriert über die Aktionselemente, um Payloads pro Teilnehmer für die Salesforce- und Slack-Workflows vorzubereiten.

Salesforce-Task- und Event-Erstellung

Dieser Workflow verarbeitet jeden im LLM-Response identifizierten Aktionselement-Besitzer. Für jeden Besitzer löst der Workflow die E-Mail-Adresse des Teilnehmers aus der extrahierten Teilnehmerliste auf und führt dann eine SOQL-Abfrage aus, um den Salesforce-Contact-Datensatz nach E-Mail-Adresse abzurufen. Gibt die Abfrage genau einen übereinstimmenden Contact zurück, erstellt der Workflow einen Task-Datensatz mit der Aktionselementbeschreibung, einer Priorität, die aus dem LLM-Response zugeordnet ist (High, Medium oder Low), einem Fälligkeitsdatum aus dem LLM-Response (standardmäßig sieben Tage ab dem aktuellen Datum, falls nicht angegeben) und einem Status von Not Started. Außerdem erstellt er einen Event-Datensatz, der die Besprechung darstellt, mit einer Dauer von 30 Minuten und einem Aktivitätsdatum und einer Uhrzeit, die auf den Zeitpunkt der Operationsausführung festgelegt sind, verknüpft mit demselben Contact. Gibt die Abfrage null oder mehr als einen übereinstimmenden Contact zurück, wird das Aktionselement übersprungen. Nach der Erstellung der Salesforce-Datensätze löst der Workflow eine personalisierte Slack-Direktnachricht an den Teilnehmer aus, die die Besprechungszusammenfassung und seine individuellen Aktionselemente enthält.

Copilot On-Demand Query

Dieser Workflow stellt einen benutzerdefinierten API-Endpunkt des Jitterbit API Manager bereit, der einen user_email-Parameter im Request-Body akzeptiert und die Hauptverarbeitungs-Pipeline für Besprechungsnotizen für den angegebenen Benutzer erneut auslöst.

Workflows des Projekts auslösen

Nach der Bereitstellung des Projekts wird der primäre Verarbeitungs-Workflow für Besprechungsnotizen automatisch nach einem 24-Stunden-Operationsplan ausgeführt.

Hinweis

Operationspläne sind nicht im Projekt-Export enthalten und müssen nach der Bereitstellung manuell in Studio konfiguriert werden. Die Query Token-Operation muss einmal täglich ausgeführt werden.

Der Gmail OAuth Authentication-Workflow muss von einem Administrator manuell einmalig durch Navigation zum benutzerdefinierten API-Endpunkt /connect-gmail ausgelöst werden, bevor der geplante Polling-Workflow erfolgreich ausgeführt werden kann.

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

Fehlerbehebung

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

Für weitere Unterstützung wenden Sie sich an den Jitterbit-Support.