OpenAI-Verbindung in Jitterbit Studio

Einführung

Eine OpenAI-Verbindung, die mit dem OpenAI-Connector erstellt wurde, ermöglicht den Zugriff auf OpenAI. Sobald eine Verbindung konfiguriert ist, können Instanzen von OpenAI-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer OpenAI-Verbindung

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

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene OpenAI-Verbindung kann von diesen Standorten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Menü für Komponentenaktionen in Projektbereich Komponentenregister).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer OpenAI-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die OpenAI-Verbindung wird im Folgenden beschrieben.

• 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 sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• API/Geheimschlü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 wird standardmäßig ausgewählt.

• Proxy-Einstellungen verwenden (nur privater Agent): Bei der Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die 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 Operationen hinweg speichern (nur V2-Aktivitäten): Klicken Sie, um das Kurzzeitgedächtnis zu aktivieren, das den Chat-Kontext über den Rahmen einer einzelnen Operation hinaus speichert.

    Wichtig

    Das Aktivieren dieser Einstellung speichert den Chat-Kontext über Operationen hinweg nur für Cloud-Agentengruppen. Private Agents speichern immer den Chat-Kontext im Speicher für Operationen innerhalb derselben Operationenkette, die dieselbe chatId teilen, unabhängig von dieser Einstellung.

    Wenn aktiviert, werden diese zusätzlichen Einstellungen angezeigt:

    • TTL des Chat-Kontexts: Geben Sie die Dauer in Sekunden an, um den Chat-Kontext im Kurzzeitgedächtnis zu behalten. Der Standardwert beträgt 86400 Sekunden (1 Tag).

    • Maximale Anzahl an Nachrichten, die im Kontext gespeichert werden: Geben Sie die maximale Anzahl an Nachrichten an, die im Kurzzeitgedächtnis des Chat-Kontexts gespeichert werden sollen. Der Standard- und Mindestwert beträgt 10 Nachrichten.

    • Wenn der Chat-Kontext nicht gefunden wird: Wählen Sie die Aktion aus, die ausgeführt werden soll, wenn der Chat-Kontext im Kurzzeitgedächtnis nicht gefunden wird:

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

      • Anfrage fehlschlagen: Die Anfrage schlägt fehl.

• Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

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

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration 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 Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine OpenAI-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe 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 dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.

• Tools registrieren: Fügt einem Assistenten in OpenAI Werkzeuge hinzu und ist als Ziel in einer Operation vorgesehen.

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

• Prompt V2: Erstellt eine Antwort für den bereitgestellten Prompt unter Verwendung der Responses API von OpenAI und ist als Ziel in einer Operation vorgesehen.

• Tools registrieren V2: Fügt einem Assistenten Werkzeuge unter Verwendung der Responses API von OpenAI hinzu und ist als Ziel in einer Operation vorgesehen.

• MCP-Server-Tools registrieren: Registriert einen entfernten MCP-Server als Werkzeuganbieter bei OpenAI und ist als Ziel in einer Operation vorgesehen.

• Prompt: Erstellt eine Textvervollständigung für den bereitgestellten Prompt in OpenAI und ist als Ziel in einer Operation vorgesehen.

• Übersetzung erstellen: Übersetzt Audiodateien in englischen Text in OpenAI und ist als Ziel in einer Operation vorgesehen.