Zum Inhalt springen

Azure OpenAI-Connector für Jitterbit Integration 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.

Note

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

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.

Important

Um den Chatverlauf zu verwalten, müssen Sie einen privaten Agenten verwenden, um den Gesprächskontext zwischen den API-Aufrufen aufrechtzuerhalten.

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.

Dieser Connector unterstützt die Azure OpenAI-Versionen 2024-10-21 und 2025-03-01 Vorschau.

Fehlersuche

Wenn Sie Probleme mit dem Azure OpenAI-Connector haben, werden die folgenden Schritte zur Fehlersuche 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 Auto Connector Update 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 Operationen (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 Protokoll für den 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 Protokoll für Connectoren finden Sie unter Ausführliches Protokoll für Connectoren, die Jitterbit private Agenten verwenden.

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

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