Zum Inhalt springen

Azure OpenAI-Verbindung

Einführung

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

Erstellen oder Bearbeiten einer Azure OpenAI-Verbindung

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

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

Konfigurieren einer Azure OpenAI-Verbindung

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

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

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

  • Endpunkt: Geben Sie den Endpunkt für die Azure OpenAI-Ressource ein. Sie finden den Endpunkt 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. Sie können den API-Schlüssel im Azure-Portal unter Ressourcenverwaltung > Schlüssel und Endpunkt in der linken Seitenleiste abrufen. 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:

  • 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 Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Ä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 fragt Sie, ob Sie die Änderungen wirklich 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 fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Datenquellen

Wenn Sie Eine Datenquelle hinzufügen in der Verbindung aktivieren, können Sie mit Azure OpenAI-Modellen unter Verwendung von Daten aus einer Azure AI Search oder einer Azure Cosmos DB für MongoDB (vCore) Instanz interagieren.

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

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

    Hinweis

    Für Informationen zu den Voraussetzungen des Azure AI Search-Dienstes und zur Erstellung eines Azure AI Search-Dienstes siehe die Dokumentation von Microsoft.

  • Name des Azure AI Search-Dienstes: 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.

  • Wählen Sie den Authentifizierungstyp für Azure-Ressourcen aus: Die schlüsselbasierte Authentifizierung (API-Schlüssel) wird unterstützt und ist standardmäßig ausgewählt.

  • Datenquellenschlüssel für den Azure AI Search-Dienst: Geben Sie entweder den Primären Administratorschlüssel oder den Sekundären Administratorschlüssel ein. Diese Schlüssel finden Sie auf der Schlüssel-Seite Ihres Suchdienstes unter Einstellungen.

Azure Cosmos DB für MongoDB (vCore)

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

  • Wählen Sie eine Datenquelle aus: Verwenden Sie das Menü, um die Azure Cosmos DB für MongoDB (vCore) auszuwählen.

  • Verbindungszeichenfolge: Geben Sie die Verbindungszeichenfolge für den Azure Cosmos DB für 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

Nachdem eine Azure OpenAI-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, 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. Weitere Informationen finden Sie in den Aktionsmenüs in den Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

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

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

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

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