Zum Inhalt springen

Jitterbit Meeting Notes Agent

Übersicht

Jitterbit stellt Kunden den Meeting Notes Agent über den Jitterbit Marketplace zur Verfügung. Dieser Agent automatisiert die Verarbeitung von Besprechungsnotizen, die von Gemini generiert werden. Der Agent ruft 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 Plan ruft der Agent neue Besprechungsnotiz-E-Mails aus Gmail ab und extrahiert den Google Docs-Inhalt, der in jeder E-Mail verlinkt 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, die mit diesem Datensatz verlinkt sind, 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 ermöglicht das Abrufen von Aufgaben auf Anforderung über einen API-Trigger.

Der Agent führt die folgenden Aufgaben aus:

  • Ruft ein Gmail-Postfach nach einem 24-Stunden-Plan für Gemini-Besprechungsnotiz-E-Mails ab.
  • Ruft Textinhalte aus verknüpften Google Docs ab und extrahiert diese.
  • Dedupliziert verarbeitete Besprechungsnotizen mit 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 Abrufe von Besprechungsaufgaben auf Anforderung über einen API-Trigger.

Der Agent ist vorkonfiguriert, um mit diesen Services zu funktionieren. Du kannst ihn an andere Systeme anpassen, indem du die Endpunktkonfigurationen und Workflows änderst.

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

KI-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 Key Storage speichert Gmail OAuth-Token und verfolgt, welche Besprechungsnotizen bereits verarbeitet wurden.

Eine typische Interaktion verläuft wie folgt:

  1. Ein Operationsplan löst den Polling-Workflow alle 24 Stunden aus.
  2. Der Agent fragt einen Cloud Datastore Key Storage nach dem gespeicherten Gmail OAuth-Aktualisierungstoken ab und tauscht ihn gegen einen frischen 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 Docs-URL, dann analysiert die Dokument-ID aus der URL.
  5. Der Agent fragt den Cloud Datastore Key Storage 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 Key Storage 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 in der LLM-Antwort identifizierten Aktionselement-Besitzer löst der Agent die E-Mail-Adresse des Teilnehmers aus der extrahierten Teilnehmerliste auf und fragt Salesforce ab, um die Contact ID des Teilnehmers abzurufen.
  9. Der Agent erstellt für jedes Aktionselement einen Salesforce Task-Datensatz und einen Salesforce Event-Datensatz, der die Besprechung darstellt, beide verlinkt 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 Hauptanfrageverarbeitungs-Workflow für den Meeting Notes 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 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 sind folgende Komponenten erforderlich.

Harmony-Komponenten

Man benötigt eine Jitterbit Harmony-Lizenz mit Zugriff auf folgende Komponenten:

Unterstützte Endpoints

Der KI-Agent verbindet sich mit folgenden Endpoints. Man kann andere Systeme durch Änderung der Endpoint-Konfigurationen und Workflows des Projekts berücksichtigen.

Large Language Model (LLM)

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

Gmail

Der Agent prüft ein dediziertes Gmail-Postfach auf Gemini-Besprechungsnotiz-E-Mails von gemini-notes@google.com mit der Gmail REST API. Man benötigt ein Google Cloud-Projekt mit aktivierter Gmail API und OAuth 2.0-Anmeldedaten (Client-ID und Client-Secret) für das Postfach.

Google Docs

Der Agent ruft Dokumentinhalte aus Google Docs mit der Google Drive API-Methode files.export ab. Der Zugriff nutzt die gleichen für Gmail konfigurierten Google OAuth 2.0-Anmeldedaten, vorausgesetzt das zugeordnete Google-Konto hat Lesezugriff auf die Besprechungsnotiz-Dokumente.

Salesforce

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

Slack

Der Agent versendet Direktnachrichten an Besprechungsteilnehmer mit der Slack Web API. Man benötigt eine Slack-App mit einem Bot-Token, der mit 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 nachzuverfolgen. Cloud Datastore ist Teil der Jitterbit Harmony-Plattform und erfordert kein separates Service-Konto, aber die Anzahl der verfügbaren Schlüsselspeicher hängt von der gekauften Cloud Datastore-Stufe der Organisation ab.

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. Jitterbit-benutzerdefinierte API erstellen
  7. Google OAuth-Anmeldedaten einrichten
  8. Gmail-Zugriff autorisieren
  9. Projekt-Workflows überprüfen
  10. Projekt-Workflows auslösen

Anleitungen 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 Meeting Notes Agent. Nutzen Sie die Suchleiste oder wählen Sie im Bereich Filter unter Typ den Eintrag 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. Lassen Sie den Tab offen, um später darauf zu verweisen.
  4. Klicken Sie auf Start Project, um einen Konfigurationsdialog zu öffnen.

Hinweis

Falls Sie den KI-Agent noch nicht erworben haben, wird stattdessen Get agent angezeigt. Klicken Sie darauf, um einen Informationsdialog zu öffnen, und klicken Sie dann auf Submit, damit sich ein Vertreter mit Ihnen bezüglich des Kaufs des KI-Agenten in Verbindung setzt.

  1. Wählen Sie im Dialog Create a New Project eine Umgebung aus, in der das Studio-Projekt erstellt wird, und klicken Sie auf Create Project.
  2. Nachdem das Fortschrittsdialog anzeigt, dass das Projekt erstellt wurde, nutzen Sie den Dialog-Link Go to Studio oder öffnen Sie das Projekt direkt über die Seite Studio Projekte.

Cloud Datastore vorbereiten

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

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 bereits verarbeitet wurden, erneut verarbeitet.

Erstellen Sie jeden Schlüsselspeicher. Die Felder Key, AlternativeKey und Value sind standardmäßig vorhanden.

AIA_Authorized_Users

Fügen Sie das folgende benutzerdefinierte Feld hinzu:

Feldname Typ Beschreibung
Key Text Slack-Benutzer-ID.
AlternativeKey Text Nicht verwendet.
Value Text OAuth-Token.
Value1 Text E-Mail-Adresse des Benutzers.

AIA_Processed_Meetings

Keine benutzerdefinierten Felder erforderlich.

Feldname Typ Beschreibung
Key Text Google Doc-ID.
AlternativeKey Text Nicht verwendet.
Value Text processed.

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

  1. Suchen Sie auf der Registerkarte Komponenten des Studio-Projekts unter Endpoints jede Cloud Datastore-Aktivität, die diesem Speicher zugeordnet ist.
  2. Doppelklicken Sie, um die Aktivität zu öffnen, ordnen 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 Aktionsmenü des Projekts und wählen Sie Project Variables aus, um die Konfigurationsschublade zu öffnen.

Hinweis

Geben Sie maskierte Variablen direkt in das Feld Mask Value 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-Geheimnis.
refresh_token Gmail-OAuth-Aktualisierungstoken für den dedizierten Posteingang. Lassen Sie es leer, bevor Sie das erste Mal ausführen. Dieser Wert wird automatisch ausgefüllt, nachdem Sie den Gmail-Autorisierungsschritt abgeschlossen haben.

OpenAI

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

Salesforce

Variablennname Beschreibung
Salesforce_user Salesforce-Anmeldebenutzername.
salesforce_password Salesforce-Anmeldekennwort.
salesforce_token Salesforce-Sicherheitstoken, das zum Kennwort für die API-Authentifizierung hinzugefügt wird.

Slack

Variablennname 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

Variablennname 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.

Zum Testen von Verbindungen rufen Sie die Palette der Designkomponenten auf, navigieren Sie zur Registerkarte Projektendpunkte und Konnektoren, 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 aus.

Benutzerdefinierte Jitterbit-API erstellen

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

Nach der Konfiguration der einzelnen API-Services 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
Vorgang Handle Connect Gmail
Pfad /connectgmail
Methode POST
Antworttyp System Variable

OAuth-Rückruf

Konfigurieren Sie diesen API-Service mit den folgenden Parametern:

Einstellung Wert
Servicename OAuth Callback
Vorgang 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
Vorgang Copilot-Auslöser
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
Vorgang Handle Connect Gmail
Pfad /connectgmail
Methode GET
Antworttyp System Variable

Google-OAuth-Anmeldedaten einrichten

Jede Jitterbit-Umgebung benötigt eigene OAuth-2.0-Anmeldedaten, da der Redirect-URI exakt mit der API-Service-URL der bereitgestellten Custom API übereinstimmen muss. Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, um Anmeldedaten 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 Berechtigung hat, Google Cloud-Projekte für Ihre Organisation zu erstellen oder zu verwalten.

  2. Klicken Sie auf die Projektauswahlschaltfläche oben auf der Seite neben dem Google Cloud-Logo.

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

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

  5. Wählen Sie Ihre Organisation in der Dropdown-Liste 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 die Projektauswahlschaltfläche erneut und wählen Sie das neue Projekt. 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 Gmail API in die Suchleiste 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. Falls eine API fehlt, schlägt der OAuth-Zustimmungsflow fehl.

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

  2. Wählen Sie Intern, wenn das dedizierte Gmail-Konto zu einer Google Workspace-Organisation gehört. Dies schränkt den Zugriff auf Benutzer innerhalb Ihrer Organisation ein 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 den Zugriff 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 Nutzer-Support-E-Mail und mindestens eine Entwickler-Kontakt-E-Mail ein. Klicken Sie auf Speichern und Fortfahren.

  5. Klicken Sie auf der Seite Bereiche auf Bereiche hinzufügen oder entfernen. Suchen Sie die folgenden Bereiche 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 Fortfahren.

  6. Falls Sie Extern ausgewählt haben, wird eine Seite Testbenutzer angezeigt. Klicken Sie auf Benutzer hinzufügen und geben Sie die E-Mail-Adresse des dedizierten Gmail-Postfachs ein (etwa 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.

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.

  2. Wählen Sie unter Anwendungstyp die Option Webanwendung. Geben Sie im Feld Name ein Label ein, etwa Meeting Notes Agent - QA, um die Identifikation über Umgebungen hinweg zu vereinfachen.

  3. Scrollen Sie nach unten zum Abschnitt Autorisierte Redirect-URIs und klicken Sie auf URI hinzufügen. Geben Sie den Redirect-URI ein, indem Sie /oauth/callback an die API-Service-URL für die Custom API anhängen. Dieser Wert ist auf der Registerkarte Profil der API im API Manager als Basis-API-URL gekennzeichnet. Der Pfad muss exakt /oauth/callback ohne nachfolgenden Schrägstrich sein. Jede Abweichung führt zu einem redirect_uri_mismatch-Fehler, wenn der OAuth-Flow ausgeführt wird.

  4. Klicken Sie auf Erstellen.

Anmeldedaten kopieren und speichern

Nach dem Klicken auf Create zeigt Google ein Dialogfeld 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 Dialogfeld vollständig angezeigt. Wenn Sie das Dialogfeld schließen, ohne es zu kopieren, können Sie das Secret später auf der Seite Credentials regenerieren, indem Sie auf Edit für den Credential-Eintrag klicken. Sie müssen dann aber auch die client_secret Projektvariable mit dem neuen Wert aktualisieren. Klicken Sie auf OK, um das Dialogfeld 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 Refresh-Token im AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher zur Verwendung in nachfolgenden geplanten Ausführungen.

So autorisieren Sie den Gmail-Zugriff:

  1. Nach dem Bereitstellen des Projekts rufen Sie den Handle Connect Gmail Vorgang im Workflow Gmail OAuth Authentication auf, indem Sie zum /connect-gmail API-Endpunkt navigieren, der von Jitterbit API Manager veröffentlicht wird.
  2. Führen Sie den Google-Genehmigungsbildschirm für das dedizierte Gmail-Konto aus. Google leitet zurück zum Jitterbit API-Callback-Endpunkt mit einem Autorisierungscode.
  3. Der Agent tauscht den Autorisierungscode gegen Zugriffs- und Refresh-Tokens, ruft die zugehörige Gmail-Adresse ab und speichert das Refresh-Token im AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher.
  4. Bestätigen Sie, dass die refresh_token Projektvariable gefüllt ist oder dass ein Datensatz in der AIA_Authorized_Users Sammlung angezeigt wird, 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 funktionalen Gruppen 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 Refresh-Token in Cloud Datastore.
Gmail Polling and Message Retrieval Wird nach einem 24-Stunden-Plan ausgeführt, um sich bei Gmail zu authentifizieren und neue Meeting-Note-E-Mails abzurufen.
Gmail OAuth Authentication

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

Gmail Polling and Message Retrieval

Dieser Workflow wird nach einem 24-Stunden-Operationszeitplan ausgeführt. Er fragt den AIA_Authorized_Users Cloud Datastore-Schlüsselspeicher nach dem gespeicherten Refresh-Token ab, tauscht ihn gegen ein neues Gmail-Zugriffs-Token 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 Nachricht ab, dekodiert den Text Base64, extrahiert die eingebettete Google Docs-URL und analysiert die Dokument-ID aus der URL. Jede Dokument-ID wird dann an den Workflow zur Inhaltsextraktion und Deduplizierung weitergeleitet.

Verarbeitung von Meeting Notes

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

Dieser Workflow fragt den Cloud Datastore-Schlüsselspeicher AIA_Processed_Meetings ab, um zu prüfen, ob die aktuelle Dokument-ID bereits verarbeitet wurde. Falls ein übereinstimmender Datensatz vorhanden ist, ü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 Nur-Text 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 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 Chat-Completion-Response, entfernt alle Markdown-Code-Umgrenzungen aus dem Inhaltsblock und iteriert über die Aktionselemente, um benutzerdefinierte Payloads pro Teilnehmer für die Salesforce- und Slack-Workflows vorzubereiten.

Salesforce-Aufgaben- und Ereigniserstellung

Dieser Workflow verarbeitet jeden Aktionselementverantwortlichen, der in der LLM-Response identifiziert wurde. Für jeden Verantwortlichen 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. Falls die Abfrage genau einen übereinstimmenden Contact zurückgibt, erstellt der Workflow einen Task-Datensatz mit der Beschreibung des Aktionselements, einer aus der LLM-Response zugeordneten Priorität (High, Medium oder Low), einem aus der LLM-Response stammenden Fälligkeitsdatum (mit Standardwert sieben Tage ab dem aktuellen Datum, wenn nichts angegeben ist) und einem Status von Not Started. Es erstellt auch einen Event-Datensatz, der die Besprechung darstellt, mit einer Dauer von 30 Minuten und einem Aktivitätsdatum und einer Uhrzeit, die auf den Zeitpunkt des Vorgangsablaufs eingestellt sind, verknüpft mit demselben Contact. Falls die Abfrage null oder mehr als einen übereinstimmenden Contact zurückgibt, 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 deren einzelne Aktionselemente enthält.

Copilot On-Demand Query

Dieser Workflow macht einen benutzerdefinierten API-Endpunkt des Jitterbit API Manager verfügbar, der einen Parameter user_email 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-stündigen Operationsplan ausgeführt.

Hinweis

Operationspläne sind nicht im Projektexport 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 aufgerufen werden, indem dieser zum benutzerdefinierten API-Endpunkt /connect-gmail navigiert, 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

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

Um weitere Hilfe zu erhalten, wenden Sie sich an den Jitterbit Support.