Zum Inhalt springen

Azure OpenAI-Connector für Jitterbit Studio

Zusammenfassung

Der Azure OpenAI-Connector stellt den Zugriff auf Azure OpenAI her.

Der Azure OpenAI-Connector bietet eine Schnittstelle zur Erstellung einer Azure OpenAI-Verbindung, die als Grundlage für die Generierung von Instanzen von Azure OpenAI-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Azure OpenAI.

Der Azure OpenAI-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Azure OpenAI-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

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

Azure OpenAI-Aktivitätstypen

  • Tools registrieren: Fügt einem Chatbot-Assistenten in Azure OpenAI Tools hinzu und ist als Ziel in einem Vorgang gedacht.

  • Bild anfordern: Generiert ein Bild basierend auf einem angegebenen Prompt in Azure OpenAI und ist als Ziel in einem Vorgang gedacht.

  • Prompt: Erstellt eine Textvervollständigung für den bereitgestellten Prompt in Azure OpenAI und ist als Ziel in einem Vorgang gedacht.

  • Bild herunterladen (veraltet): Ruft die URL eines zuvor generierten Bildes von Azure OpenAI ab und ist als Quelle in einem Vorgang gedacht.

Hinweis

Dieser Connector ist ein auf dem Connector SDK-basierten Connector, der von Jitterbit verwendet werden kann, um Änderungen an mit dem Connector SDK erstellten Connectors zu kommunizieren.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Azure OpenAI Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Hinweis

Der Connector verwendet die Chat Completion API für alle Modelle außer gpt-35-turbo-instruct, das die veraltete Completions API verwendet. Diese Änderung spiegelt die laufenden Modellstilllegungen von Microsoft wider. Weitere Informationen finden Sie unter Azure OpenAI Modellstilllegungen.

Tipp

Befolgen Sie diese Richtlinien, um den Chatverlauf zu verwalten über Operationen hinweg:

  • Cloud-Agentengruppen: Aktivieren Sie die Option Chat-Kontext über Operationen hinweg speichern in der Verbindungs-Konfiguration. Der Connector erhält den Gesprächskontext zwischen Operationen innerhalb derselben Umgebung, die dasselbe chatId verwenden (konfiguriert in der Register Tools-Aktivität).

  • Private Agenten: Der Chat-Kontext wird im lokalen Speicher für Operationen innerhalb derselben Operationenkette, die dasselbe chatId teilen, beibehalten.

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

Der Connector ruft die Liste der verfügbaren Modelle von Ihrer Azure OpenAI-Ressource ab, wenn Sie eine Aktivität konfigurieren. Nur Modelle, die in Ihrer Azure OpenAI-Ressource bereitgestellt sind, erscheinen im Auswahlmenü Modell-ID. Informationen zur Bereitstellung von Modellen finden Sie in der Dokumentation von Microsoft.

Fehlerbehebung

Wenn Sie Probleme mit dem Azure OpenAI-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für den Betrieb (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie in Ausführliches Protokollieren für Connectoren, die Jitterbit private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  6. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Operationen.