Erstellen einer Azure OpenAI-Verbindung
Um mit Azure OpenAI kommunizieren zu können, erstellen Sie eine Verbindung zu der Azure OpenAI-Analysequelle.
Die von diesen Verbindungen erhaltenen Daten können im Ladeskript und in Diagrammformeln verwendet werden, um Ihre Qlik Sense Analyse-Apps oder Skripte zu verbessern.
Vor dem Beginn
In Ihrem Microsoft Azure-Konto finden Sie den Azure OpenAI Service unter den Azure Cognitive Services. Er ist standardmäßig nicht aktiviert. Wenden Sie sich an Microsoft, wenn Sie Unterstützung beim Aktivieren des Azure OpenAI Service benötigen.
Verfügbare Konnektorkonfigurationen
Richten Sie Ihre Azure OpenAI-Analyseverbindung mit einer der folgenden Konfigurationen ein.
OpenAI Completions API - Rows
Mit dieser Konfiguration wird jede Datenzeile als Frage an die Completions API gesendet (in kleinen Batches für bessere Leistung). Jede Antwort wird als Text in einer Tabelle mit der gleichen Anzahl Zeilen wie die Eingabe gespeichert.
Diese Konfiguration kann sowohl im Datenladeskript als auch in den Diagrammformeln verwendet werden.
OpenAI Chat Completions API - Rows
Diese Konfiguration sendet jede Datenzeile als Anfrage an die OpenAI Chat Completions API. In diesem Fall werden die Anfragen mit der „user“-Nachrichtenrolle gestellt, und jede Datenzeile aus Qlik wird als getrennte Anfrage gesendet.
Diese Konfiguration kann sowohl im Datenladeskript als auch in den Diagrammformeln verwendet werden.
Erstellen der Verbindung
Sie können eine Verbindung mit dem Azure OpenAI-Analysekonnektor über die Seite „Erstellen“ des Aktivitätscenters Analysen oder über den Dateneditor in einer bereits erstellten App erstellen.Folgen Sie den Schritten unten, um eine Verbindung zu erstellen.
Informationen zum Festlegen der Parameterwerte finden Sie in der REST API-Referenz für den Azure OpenAI Service.
Gehen Sie folgendermaßen vor:
-
Erstellen Sie eine neue Qlik Sense App oder ein Skript und öffnen Sie den Dateneditor oder den Skript.
-
Klicken Sie auf Neue Verbindung erstellen.
-
Wählen Sie unter Bereich den Bereich aus, in den sich die Verbindung befinden soll.
-
Klicken Sie unter Analysequellen auf Azure OpenAI.
-
Wählen Sie die gewünschte Konfiguration aus. Weitere Informationen über die einzelnen verfügbaren Optionen finden Sie unter Verfügbare Konnektorkonfigurationen.
-
Geben Sie den Azure OpenAI API-Schlüssel ein.
- Geben Sie die Azure API-Version ein. Dieses Feld ist bereits mit dem aktuellen Standardwert ausgefüllt.
-
Passen Sie die anderen Standardparameterwerte wie erforderlich an.
Weitere Beschreibungen der Parameter finden Sie unter Konfigurierbare Einstellungen.
InformationshinweisSie müssen in den meisten Fällen den Parameterwert für Max. Token anpassen, damit die Verbindung Ihren Bedürfnissen entsprechend funktioniert. Dieser Parameter steuert die Größe der Antwort, die generiert wird. -
Klicken Sie auf Erstellen.
Die Datenverbindung wird in dem Bereich gespeichert, in dem die App erstellt wurde. Daher kann sie in anderen Qlik Sense Apps oder Skripten wiederverwendet werden.
Nachdem Sie die Verbindung erstellt haben, können Sie damit Daten laden, um sie an OpenAI zu senden. Zudem können Sie sie in Diagrammformeln verwenden. Weitere Informationen finden Sie unter Auswählen und Laden von Daten in einer Azure OpenAI-Verbindung und Verwenden von Azure OpenAI-Verbindungen in Visualisierungsformeln.
Konfigurierbare Einstellungen
Die Einstellungen in der folgenden Tabelle können im Verbindungsdialogfeld konfiguriert werden:
Feld | Beschreibung |
---|---|
Konfiguration auswählen | Wählen Sie unter Konfiguration die Konfiguration des Konnektors aus. Weitere Informationen finden Sie unter Verfügbare Konnektorkonfigurationen. |
Autorisierung | Geben Sie den Azure OpenAI API-Schlüssel ein. Weitere Informationen finden Sie in der REST API-Referenz für den Azure OpenAI Service. |
Azure OpenAI-Anfrage |
|
OpenAI Request |
|
Zuordnung |
Geben Sie als Verknüpfungsfeld ein Feld aus der Eingabedatentabelle an, das einen eindeutigen Identifikator enthält. Es ist erforderlich, dieses Feld in die Datenquelle einzuschließen, wenn eine Endpunktanforderung gestellt wird, damit die zurückgegebene Ergebnistabelle mittels eines Schlüssels mit der Quellfeldtabelle verknüpft wird. Das bezeichnete Feld wird als Feld in der Antwort zurückgegeben und ermöglicht die Verknüpfung der Antwort mit den Quelldaten im Datenmodell. Dabei kann es sich um ein beliebiges Feld mit einer eindeutigen ID handeln, entweder aus den Quelldaten oder als Teil des Tabellenladevorgangs. |
Name | Der Name der Verbindung. Wenn Sie keinen Namen eingeben, wird der Standardname verwendet. |