Zum Inhalt springen

Azure OpenAI-Verbindung in Jitterbit Studio

Einführung

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

Azure OpenAI-Verbindung erstellen oder bearbeiten

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

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

Azure OpenAI-Verbindung konfigurieren

Nachfolgend werden alle Elemente der Benutzeroberfläche des Azure 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 Azure OpenAI-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Azure OpenAI-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • Endpunkt: Geben Sie den Endpunkt für die Azure OpenAI-Ressource ein. Den Endpunkt finden Sie im Azure-Portal unter Ressourcenverwaltung > Schlüssel und Endpunkt in der linken Seitenleiste.

  • API-/Geheimschlüssel: Geben Sie den API-Schlüssel für die Azure OpenAI-Ressource ein. Den API-Schlüssel erhalten Sie im Azure-Portal unter Ressourcenverwaltung > Schlüssel und Endpunkt in der linken Seitenleiste. Sie können die Werte aus den Feldern SCHLÜSSEL 1 oder SCHLÜSSEL 2 verwenden.

  • Optionale Einstellungen: Klicken Sie, um diese optionalen Einstellungen zu erweitern:

    • Datenquelle hinzufügen: Wählen Sie diese Option, um mit Azure OpenAI-Modellen zu interagieren und dabei Daten aus Ihrer Datenquelle zu verwenden. Wenn Sie diese Option auswählen, werden zusätzliche Felder basierend auf Ihrer ausgewählten Datenquelle angezeigt. Siehe Datenquellen für Beschreibungen der folgenden Optionen:

    • Chat-Kontext über Vorgänge hinweg speichern: (Nur Cloud-Agent-Gruppen.) Wählen Sie diese Option, um die Chat-Kontextverwaltung bei Verwendung einer Cloud-Agent-Gruppe zu aktivieren. Wenn Sie diese Option aktivieren, verwaltet der Connector den Gesprächsverlauf zwischen Vorgängen in derselben Umgebung, die dieselbe chatId gemeinsam nutzen (konfiguriert in der Aktivität „Tools registrieren"). Dies ermöglicht Azure OpenAI, auf vorherige Interaktionen über verschiedene Projekte und Workflows hinweg zu verweisen.

Hinweis

Private Agents verwalten den Chat-Kontext nur im lokalen Speicher für Operationen innerhalb derselben Operationskette, die dieselbe chatId verwenden.

  • Proxy-Einstellungen verwenden (nur Private Agent): Bei Verwendung eines Private Agent kann diese Einstellung ausgewählt werden, um Private-Agent-Proxy-Einstellungen zu nutzen.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, lädt der Agent (oder die Agents) in der Agentgruppe, die der aktuellen Umgebung zugeordnet ist, die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

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

  • Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration 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: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration 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.

Datenquellen

Wenn Sie Datenquelle hinzufügen in der Verbindung aktivieren, können Sie mit Azure OpenAI-Modellen interagieren und dabei Daten aus einer Azure AI Search- oder Azure Cosmos DB for MongoDB (vCore)-Instanz verwenden.

Wenn Sie Azure AI Search als Datenquelle auswählen, werden diese Felder angezeigt:

  • Datenquelle auswählen: Verwenden Sie das Menü, um die Azure AI Search auszuwählen.

    Hinweis

    Informationen zu Voraussetzungen für den Azure AI Search-Dienst und zum Erstellen eines Azure AI Search-Diensts finden Sie in der Microsoft-Dokumentation.

  • Name des Azure AI Search-Diensts: Geben Sie den konfigurierten Dienstnamen für Ihren Azure AI Search-Dienst ein.

    Hinweis

    Sie müssen mindestens die Rolle Cognitive Services Contributor für die Azure OpenAI-Ressource haben.

  • Authentifizierungstyp für Azure-Ressource auswählen: Schlüsselbasierte Authentifizierung (API-Schlüssel) wird unterstützt und ist standardmäßig ausgewählt.

  • Datenschlüssel des Azure AI Search-Diensts: Geben Sie entweder den Primären Admin-Schlüssel oder den Sekundären Admin-Schlüssel ein. Diese Schlüssel finden Sie auf der Seite Schlüssel Ihres Suchdiensts unter Einstellungen.

Azure Cosmos DB for MongoDB (vCore)

Wenn Sie Azure Cosmos DB for MongoDB (vCore) als Datenquelle auswählen, werden diese Felder angezeigt:

  • Datenquelle auswählen: Verwenden Sie das Menü, um Azure Cosmos DB for MongoDB (vCore) auszuwählen.

  • Verbindungszeichenfolge: Geben Sie die Verbindungszeichenfolge für den Azure Cosmos DB for MongoDB (vCore)-Cluster ein.

  • Datenbankname: Geben Sie den Datenbanknamen ein. Sie konfigurieren den Datenbanknamen über MongoDB-Tools oder Ihren Anwendungscode.

  • Datenbanksammlung: Geben Sie den Sammlungsnamen ein. Sie konfigurieren den Sammlungsnamen über MongoDB-Tools oder Ihren Anwendungscode.

Nächste Schritte

Nach dem Erstellen einer Azure OpenAI-Verbindung platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder als Ziele (zum Verarbeiten von Daten in einem Vorgang) 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:

  • Register Tools: Fügt Tools zu Assistenten in Azure OpenAI hinzu und ist als Ziel in einem Vorgang vorgesehen.

  • Request Image: Generiert ein Bild basierend auf einer angegebenen Eingabeaufforderung in Azure OpenAI und ist als Ziel in einem Vorgang vorgesehen.

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

  • Download Image (deprecated): Ruft die URL eines zuvor generierten Bildes aus Azure OpenAI ab und ist als Quelle in einem Vorgang vorgesehen.