Zum Inhalt springen

OpenAI-Verbindung in Jitterbit Studio

Einführung

Eine OpenAI-Verbindung, die mit dem OpenAI-Connector erstellt wird, stellt den Zugriff auf OpenAI her. Nach der Konfiguration einer Verbindung können Sie Instanzen von OpenAI-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

OpenAI-Verbindung erstellen oder bearbeiten

Eine neue OpenAI-Verbindung wird mit dem OpenAI-Connector von einem dieser Orte aus erstellt:

Eine vorhandene OpenAI-Verbindung kann von diesen Orten aus bearbeitet werden:

OpenAI-Verbindung konfigurieren

Im Folgenden wird jedes Benutzeroberflächenelement des OpenAI-Verbindungskonfigurationsbildschirms beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede OpenAI-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den OpenAI-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • API/Geheimer Schlüssel: Geben Sie den API-Schlüssel ein. API-Schlüssel werden auf der Seite API-Schlüssel der OpenAI-Instanz generiert.

  • API-Version: Die Version V1 ist die einzige unterstützte Version und ist standardmäßig ausgewählt.

  • Proxy-Einstellungen verwenden (nur privater Agent): Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agents für HTTPS-Proxy zu verwenden. Dieser Connector unterstützt keinen NTLM-Proxy.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Organisations-ID: Geben Sie die Organisations-ID für die OpenAI-Instanz ein. Ihre Organisations-ID finden Sie auf der Seite Organisationseinstellungen.

    • Chat-Kontext über Vorgänge hinweg speichern (nur V2-Aktivitäten): Klicken Sie, um das Kurzzeitgedächtnis zu aktivieren, das den Chat-Kontext über den Umfang eines einzelnen Vorgangs hinaus speichert.

      Wichtig

      Das Aktivieren dieser Einstellung speichert den Chat-Kontext über Vorgangsketten hinweg nur für Cloud-Agent-Gruppen. Private Agents speichern den Chat-Kontext immer im Speicher für Vorgänge innerhalb derselben Vorgangskette, die dieselbe chatId gemeinsam nutzen, unabhängig von dieser Einstellung.

      Wenn diese Option aktiviert ist, werden diese zusätzlichen Einstellungen angezeigt:

      • Chat-Kontext-TTL: Geben Sie die Zeitdauer ein, für die der Chat-Kontext im Kurzzeitgedächtnis in Sekunden beibehalten werden soll. Der Standardwert ist 86400 Sekunden (1 Tag).

  • Maximale im Kontext gespeicherte Nachrichten: Geben Sie die maximale Anzahl der Nachrichten ein, die im Chatverlauf des Kurzzeitspeichers gespeichert werden sollen. Der Standardwert und der Mindestwert beträgt 10 Nachrichten.

  • Wenn Chatverlauf nicht gefunden wird: Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn der Chatverlauf nicht im Kurzzpeicher gefunden wird:

    • Neuen Kontext erstellen: (Standard.) Ein neuer Chatverlauf wird erstellt.

    • Anfrage fehlschlagen lassen: Die Anfrage schlägt fehl.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Beim Testen der Verbindung wird die neueste Version des Connectors von den Agent(en) in der Agentgruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Automatisches Connector-Update deaktivieren .

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nach dem Erstellen einer OpenAI-Verbindung platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

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

  • Tools registrieren (veraltet): Fügt Tools zu einem Assistenten in OpenAI hinzu und ist als Ziel in einem Vorgang vorgesehen.

    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 es ermöglicht, Tool-Registrierungen über Vorgänge hinweg in Cloud-Agentgruppen beizubehalten, nicht nur in privaten Agenten.

  • Bild erstellen: Erstellt Bilder basierend auf einer angegebenen Eingabeaufforderung in OpenAI und ist als Ziel in einem Vorgang vorgesehen.

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

  • Tools registrieren V2: Fügt Tools zu einem Assistenten mit der OpenAI-Responses-API hinzu und ist als Ziel in einem Vorgang vorgesehen.

  • MCP-Server-Tools registrieren: Registriert einen Remote-MCP-Server als Tool-Anbieter bei OpenAI und ist als Ziel in einem Vorgang vorgesehen.

  • Prompt (Veraltet): Erstellt eine Textvervollständigung für die bereitgestellte Eingabeaufforderung in OpenAI und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

    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 Prompt V2-Aktivität ersetzt, deren Verwendung der OpenAI Responses API es ermöglicht, den Chat-Kontext beizubehalten und registrierte Tools in Cloud-Agent-Gruppen aufzurufen, nicht nur in privaten Agents.

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