Dokumente mit KI in Jitterbit Studio verarbeiten

Einführung

Der Google Docs Connector und der OpenAI Connector lassen sich kombinieren, um Document-Processing-Pipelines in Studio zu erstellen. Diese Anleitung behandelt ein häufiges Muster: Ein Google Docs-Dokument nach ID abrufen, seinen Textinhalt mit einer Eingabeaufforderung an OpenAI übergeben, die das Modell anweist, wie es das Dokument verarbeitet, und das KI-generierte Ergebnis in einen Slack-Kanal posten.

Typische Anwendungsfälle sind die Zusammenfassung von Besprechungsnotizen, die Analyse von Verträgen und die strukturierte Datenerfassung aus unstrukturierten Dokumenten.

Diese Anleitung konzentriert sich auf die dokumentspezifischen Teile der Integration: Konfigurieren der Google Docs-Verbindung, Zuordnen von Dokumentinhalten zur Eingabeaufforderung und Weiterleiten der KI-Antwort. Informationen zur Einrichtung der OpenAI-Verbindung und zur allgemeinen Konfiguration der Prompt-Aktivität finden Sie unter OpenAI zum Verarbeiten von Daten in einer Studio-Operation verwenden.

Entwurfsmuster

Die Integration verwendet zwei verkettete Operationen:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR A["Transformation
Map document ID"] --> B[Google Docs Get Docs] --> C["Transformation
Map content to prompt"] --> D[OpenAI Prompt] D -->|On Success| E["Transformation
Map AI response"] --> F[Slack Post Message]

Operation 1 verwendet zwei Transformationen: eine Request-Transformation, die die Dokument-ID dem Get Docs-Request-Schema zuordnet, und eine Transformation, die das zurückgegebene Feld content dem OpenAI-Feld prompt zuordnet. Operation 2 liest die KI-Antwort aus der Prompt-Aktivität und postet sie in einen Slack-Kanal.

Teil 1: Google Docs-Verbindung und -Aktivität konfigurieren

Schritt 1: Google Docs-Verbindung erstellen

Öffnen Sie in Studio Ihr Projekt und klicken Sie auf die Registerkarte Project endpoints and connectors in der Design-Komponentenpalette.
Klicken Sie auf den Google Docs-Connector, um die Verbindungskonfiguration zu öffnen.
Connection Name: Geben Sie einen Namen ein, der diese Verbindung identifiziert, z. B. Google Docs.
Konfigurieren Sie die Authentifizierung wie in Google Docs-Voraussetzungen beschrieben.
Klicken Sie auf Test, um die Verbindung zu überprüfen, und klicken Sie dann auf Save Changes.

Schritt 2: Get Docs-Aktivität konfigurieren

Erweitern Sie in der Design-Komponentenpalette den erstellten Google Docs-Endpoint. Ziehen Sie den Aktivitätstyp Get Docs auf die Design-Canvas, um eine Aktivitätsinstanz zu erstellen.
Doppelklicken Sie auf die Aktivität, um ihre Konfiguration zu öffnen.
Name: Geben Sie einen Namen für die Aktivität ein, z. B. Get Document.
Klicken Sie auf Next, um die Datenschemas zu überprüfen, und klicken Sie dann auf Finished.

Die Get Docs-Aktivität verwendet diese Schemafelder:

Request: docid: die Dokument-ID des abzurufenden Google Docs.
Response: docname (Dokumenttitel), content (Textkörper des Dokuments) und errormsg (Fehlermeldung, falls vorhanden).

Die Dokument-ID wird in der Google Docs-URL angezeigt: https://docs.google.com/document/d/<document-id>/edit.

Schritt 3: Dokument-ID zuordnen

Fügen Sie vor der Get Docs-Aktivität eine Request-Transformation hinzu, um die Dokument-ID bereitzustellen. Ordnen Sie das Feld docid request mithilfe einer Projektvariablen zu, damit die ID ohne Bearbeitung der Transformation geändert werden kann:

<trans>
$google_docs_document_id
</trans>

Tipp

Für die dynamische Dokumentauswahl (z. B. Verarbeitung des zuletzt geänderten Dokuments) legen Sie google_docs_document_id in einem Script-Schritt fest, der der Get Docs-Operation vorausgeht, und verwenden Sie Ergebnisse aus einer Google Drive List Files-Aktivität.

Teil 2: Dokumentinhalt der OpenAI-Eingabeaufforderung zuordnen

Richten Sie vor der Konfiguration der Transformation die OpenAI-Verbindung und die Prompt-Aktivität wie in OpenAI zum Verarbeiten von Daten in einer Studio-Operation verwenden beschrieben ein.

Ordnen Sie in der Transformation zwischen der Get Docs-Aktivität (Quelle) und der OpenAI-Prompt-Aktivität (Ziel) die folgenden Felder zu.

Eingabeaufforderung zuordnen

Ordnen Sie das OpenAI-Feld prompt zu, um eine statische Anweisung mit dem Dokumenttext zu kombinieren. Verwenden Sie Source.content, um auf das Feld content aus dem Response-Schema von Get Docs zu verweisen:

<trans>
"Summarize the following meeting notes in three bullet points:\n\n" +
Source.content
</trans>

Strukturierte Ausgabe anfordern

Falls die nachgelagerte Verarbeitung ein vorhersehbares Format erfordert, fügen Sie Formatierungsanweisungen in die Eingabeaufforderung ein:

<trans>
"Extract the key decisions and action items from the following meeting notes. " +
"Return the result as a JSON object with these fields: " +
"\"summary\" (a one-sentence overview), \"decisions\" (an array of strings), " +
"\"action_items\" (an array of strings).\n\n" +
Source.content
</trans>

Anleitungen zum Parsen strukturierter JSON-Responses in einer nachgelagerten Operation finden Sie unter LLM-Responses mithilfe von Function Calling zu Studio-Operationen weiterleiten.

Get Docs-Fehler behandeln

Fügen Sie der Transformation einen Script-Knoten hinzu, um Fehler an die Oberfläche zu bringen, die von der Aktivität Get Docs zurückgegeben werden:

<trans>
if(Source.errormsg != "",
  RaiseError("Google Docs error: " & Source.errormsg)
);
</trans>

Teil 3: AI-Response aufrufen und in Slack veröffentlichen

Slack-Operation verketten

Konfigurieren Sie die Aktion On Success der OpenAI-Operation, um die nachgelagerte Slack-Operation auszuführen:

Öffnen Sie die Einstellungen der OpenAI-Operation.
Legen Sie auf der Registerkarte Actions die Aktion On Success auf Run Operation fest und wählen Sie die Slack-Operation aus.

Weitere Informationen zum Verketten von Operationen finden Sie unter Fehlerbehandlung in Operationen konfigurieren.

AI-Response zuordnen

Ordnen Sie in der Transformation der Slack-Operation choices[0].message.content aus dem Response-Schema der Aktivität Prompt dem Feld text der Slack-Nachricht zu:

<trans>
Source.choices[0].message.content
</trans>

OpenAI-Fehler behandeln

Fügen Sie einen Script-Knoten hinzu, um einen Fehler auszulösen, falls OpenAI ein nicht leeres Array errors zurückgibt:

<trans>
if(Length(Source.errors) > 0,
  RaiseError(Source.errors[0].message)
);
</trans>

Vollständige Schritte zur Konfiguration der Slack-Verbindung und Nachrichteneinstellungen finden Sie unter Slack-Benachrichtigung aus einer Studio-Operation senden.

Integration überprüfen

Stellen Sie die Get Docs-Operation bereit und führen Sie sie manuell aus.
Bestätigen Sie in den Operationsprotokollen, dass die Aktivität Get Docs erfolgreich abgeschlossen wurde und dass das Feld content den erwarteten Dokumenttext enthält.
Bestätigen Sie, dass die OpenAI Prompt-Operation ausgelöst wurde und erfolgreich abgeschlossen wurde.
Überprüfen Sie das OpenAI-Operationsprotokoll, um zu bestätigen, dass choices[0].message.content eine gültige KI-generierte Response enthält.
Überprüfen Sie den Slack-Kanal auf das veröffentlichte Ergebnis.

Falls die Aktivität Get Docs ein leeres Feld content zurückgibt, überprüfen Sie, ob die Dokument-ID korrekt ist und dass das Dienstkonto, das in der Google Docs-Verbindung konfiguriert ist, Lesezugriff auf das Dokument hat.