Zum Inhalt springen

OpenAI-Connector in Jitterbit Studio

Zusammenfassung

Der OpenAI-Connector stellt den Zugriff auf OpenAI her.

Der OpenAI-Connector bietet eine Schnittstelle zum Erstellen einer OpenAI-Verbindung, die Grundlage für die Generierung von Instanzen von OpenAI-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit OpenAI über die Verbindung.

Der OpenAI-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer OpenAI-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte OpenAI-Verbindung und ihre Aktivitäten als OpenAI-Endpunkt bezeichnet:

OpenAI-Aktivitätstypen

  • Transkription erstellen: Transkribiert Audio basierend auf der erkannten Eingabe-Sprache in OpenAI in Text und soll als Ziel in einem Vorgang verwendet werden.

  • Tools registrieren (veraltet): Fügt einem Assistenten in OpenAI Tools hinzu und soll als Ziel in einem Vorgang verwendet werden.

    Warnung

    Die Aktivität Tools registrieren (veraltet) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in der Version 12.8 durch die neu gestaltete Aktivität Tools registrieren V2 ersetzt, deren Verwendung der OpenAI-Responses-API ermöglicht es, Tool-Registrierungen über Vorgänge hinweg in Cloud-Agent-Gruppen beizubehalten, nicht nur in privaten Agents.

  • Bild erstellen: Erstellt Bilder basierend auf einer angegebenen Eingabeaufforderung in OpenAI und soll als Ziel in einem Vorgang verwendet werden.

  • Prompt V2: Erstellt eine Antwort für die bereitgestellte Eingabeaufforderung mit der OpenAI-Responses-API und soll als Ziel in einem Vorgang verwendet werden.

  • Tools registrieren V2: Fügt einem Assistenten mit der OpenAI-Responses-API Tools hinzu und soll als Ziel in einem Vorgang verwendet werden.

  • MCP-Server-Tools registrieren: Registriert einen Remote-MCP-Server als Tool-Provider bei OpenAI und soll als Ziel in einem Vorgang verwendet werden.

  • Prompt (veraltet): Erstellt eine Textvervollständigung für die bereitgestellte Eingabeaufforderung in OpenAI und soll als Ziel in einem Vorgang verwendet werden.

    Warnung

    Die Aktivität Prompt (veraltet) ist veraltet und wird nicht mehr unterstützt. In einer zukünftigen Version wird diese Aktivität dauerhaft entfernt. Sie wurde in der Version 12.8 durch die neu gestaltete Aktivität Prompt V2 ersetzt, deren Verwendung der OpenAI-Responses-API ermöglicht es, Chat-Kontext beizubehalten und registrierte Tools in Cloud-Agent-Gruppen aufzurufen, nicht nur in privaten Agents.

  • Übersetzungsaktivität erstellen: Übersetzt Audiodateien in OpenAI in englischen Text und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK basierender Connector, auf den sich Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Connectoren beziehen kann.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Der OpenAI-Connector erfordert die Verwendung einer Agent-Version 10.1 oder höher. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter, wenn erforderlich.

Wichtig

Für die folgende Funktionalität muss ein privater Agent verwendet werden:

Der OpenAI-Connector verwendet die OpenAI-API. Weitere Informationen zu den Schema-Knoten und Feldern finden Sie in der API-Dokumentation.

Unterstützte OpenAI-Modelle

Dieser Connector unterstützt diese OpenAI-Modelle:

Fehlerbehebung

Bei Problemen mit dem OpenAI-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.openai" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

Praktische Anwendung