Dokumente mit KI in Jitterbit Studio verarbeiten

Einführung

Der Google Docs Connector und der OpenAI Connector können kombiniert werden, um Dokumentenverarbeitungs-Pipelines im Studio zu erstellen. Dieser Leitfaden behandelt ein häufiges Muster: Abrufen eines Google Docs-Dokuments anhand der ID, Übermitteln des Textinhalts an OpenAI mit einem Prompt, der das Modell anweist, wie es verarbeitet werden soll, und Posten des von der KI generierten Ergebnisses in einen Slack-Kanal.

Typische Anwendungsfälle umfassen die Zusammenfassung von Besprechungsnotizen, Vertragsanalysen und die strukturierte Datenerfassung aus unstrukturierten Dokumenten.

Dieser Leitfaden konzentriert sich auf die dokumentenspezifischen Teile der Integration: Konfiguration der Google Docs-Verbindung, Zuordnung des Dokumenteninhalts in den Prompt und Weiterleitung der KI-Antwort. Für die Einrichtung der OpenAI-Verbindung und die allgemeine Konfiguration der Prompt-Aktivität siehe OpenAI zur Datenverarbeitung in einer Studio-Operation verwenden.

Entwurfsmuster

Die Integration verwendet zwei verkettete Operationen:

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

Teil 1: Konfigurieren der Google Docs-Verbindung und -Aktivität

Schritt 1: Erstellen der Google Docs-Verbindung

1. Öffnen Sie in Studio Ihr Projekt und klicken Sie auf die Projektendpunkte und Connectoren-Registerkarte in der Design-Komponentenpalette.

2. Klicken Sie auf den Google Docs-Connector, um die Verbindungs-Konfiguration zu öffnen.

3. Verbindungsname: Geben Sie einen Namen ein, der diese Verbindung identifiziert, zum Beispiel Google Docs.

4. Konfigurieren Sie die Authentifizierung wie in den Google Docs-Voraussetzungen beschrieben.

5. Klicken Sie auf Test, um die Verbindung zu überprüfen, und klicken Sie dann auf Änderungen speichern.

Schritt 2: Konfigurieren Sie die Get Docs-Aktivität

1. Erweitern Sie im Design-Komponenten-Palette den Google Docs-Endpunkt, den Sie erstellt haben. Ziehen Sie den Aktivitätstyp Get Docs auf die Design-Leinwand, um eine Aktivitätsinstanz zu erstellen.

2. Doppelklicken Sie auf die Aktivität, um ihre Konfiguration zu öffnen.

3. Name: Geben Sie einen Namen für die Aktivität ein, zum Beispiel Get Document.

4. Klicken Sie auf Weiter, um die Datenschemas zu überprüfen, und klicken Sie dann auf Fertig.

Die Get Docs-Aktivität verwendet diese Schemafelder:

• Anfrage: docid: die Dokument-ID des Google Docs, das abgerufen werden soll.
• Antwort: docname (Dokumenttitel), content (Textinhalt des Dokuments) und errormsg (Fehlermeldung, falls vorhanden).

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

Schritt 3: Dokument-ID zuordnen

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

<trans>
$google_docs_document_id
</trans>

Teil 2: Dokumentinhalt der OpenAI-Eingabeaufforderung zuordnen

Bevor Sie die Transformation konfigurieren, richten Sie die OpenAI-Verbindung und die Prompt-Aktivität ein, wie in Verwenden Sie OpenAI zur Verarbeitung von Daten in einer Studio-Operation beschrieben.

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

Map the prompt

Mappen Sie das OpenAI prompt-Feld, um eine statische Anweisung mit dem Dokumenteninhalt zu kombinieren. Verwenden Sie Source.content, um auf das content-Feld aus dem Get Docs-Antwortschema zuzugreifen:

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

Request structured output

Wenn die nachgelagerte Verarbeitung ein vorhersehbares Format erfordert, fügen Sie Formatierungsanweisungen in das Prompt 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>

Für Anleitungen zum Parsen strukturierter JSON-Antworten in einer nachgelagerten Operation siehe Route LLM responses to Studio operations using function calling.

Handle Get Docs errors

Fügen Sie einen Skriptnode zur Transformation hinzu, um Fehler anzuzeigen, die von der Get Docs-Aktivität zurückgegeben werden:

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

Part 3: Access the AI response and post to Slack

Chain the Slack operation

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

1. Öffnen Sie die Einstellungen der OpenAI-Operation.

2. Setzen Sie im Tab Actions die On Success-Aktion auf Run Operation und wählen Sie die Slack-Operation aus.

Für weitere Informationen zum Verketten von Operationen siehe Configure error handling in operations.

Map the AI response

Mappen Sie im Transformation der Slack-Operation choices[0].message.content aus dem Antwortschema der Prompt-Aktivität auf das Slack-Nachrichtenfeld text:

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

Handle OpenAI errors

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

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

Für vollständige Schritte zur Konfiguration der Slack-Verbindung und der Nachrichten siehe Send a Slack notification from a Studio operation.

Überprüfen Sie die Integration

1. Bereitstellen und ausführen Sie die Get Docs-Operation manuell.

2. Bestätigen Sie in den Betriebsprotokollen, dass die Get Docs-Aktivität erfolgreich abgeschlossen wurde und dass das Feld content den erwarteten Dokumenttext enthält.

3. Bestätigen Sie, dass die OpenAI Prompt-Operation ausgelöst und erfolgreich abgeschlossen wurde.

4. Überprüfen Sie das OpenAI-Betriebsprotokoll, um zu verifizieren, dass choices[0].message.content eine gültige, von der KI generierte Antwort enthält.

5. Überprüfen Sie den Slack-Kanal auf das veröffentlichte Ergebnis.

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