Erstellen einer OpenAI-Verbindung
Um mit der OpenAI-Plattform kommunizieren zu können, erstellen Sie eine Verbindung zu der OpenAI-Analysequelle.
Um mit OpenAI kommunizieren zu können, erstellen Sie eine Verbindung zu der OpenAI-Analysequelle. Erstellen Sie die Verbindung auf der Seite „Erstellen“ des Aktivitätscenters Analysen, Dateneditor oder Skript.
Die von diesen Verbindungen erhaltenen Daten können im Ladeskript und in Diagrammformeln verwendet werden, um Ihre Qlik Sense Analyse-Apps zu verbessern.
Konfigurationen und konfigurierbare Einstellungen
Richten Sie Ihre OpenAI-Analyseverbindung mit einer der folgenden Konfigurationen ein. Die konfigurierbaren Einstellungen können abhängig von der verwendeten Konfiguration variieren.
OpenAI Chat Completions API
Diese Konfiguration sendet jede Datenzeile als Frage an die OpenAI Chat Completions API. 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.
Die OpenAI-Dokumentation zur in dieser Konfiguration verwendeten API finden Sie unter Chat.
| Feld | Beschreibung |
|---|---|
| Konfiguration auswählen | Wählen Sie unter Konfiguration die Option OpenAI Chat Completions API aus. |
| Autorisierung | Geben Sie den OpenAI API-Schlüssel ein. Weitere Informationen finden Sie unter Generieren eines OpenAI API-Schlüssels. |
| 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. |
OpenAI Embeddings:
Mit dieser Konfiguration werden Zeilen von Eingabetext an die OpenAI Embeddings API gesendet. OpenAI gibt eine getrennte Vektordarstellung für jede Eingabe zurück. Diese Vektordarstellung hat eine Form, die von ML-Modellen genutzt werden kann.
Die OpenAI-Dokumentation zur in dieser Konfiguration verwendeten API finden Sie unter Embeddings.
| Feld | Beschreibung |
|---|---|
| Konfiguration auswählen | Wählen Sie unter Konfiguration die Option OpenAI Embeddings aus. |
| Autorisierung | Geben Sie den OpenAI API-Schlüssel ein. Weitere Informationen finden Sie unter Generieren eines OpenAI API-Schlüssels. |
| 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. |
Erstellen der Verbindung
Sie können eine Verbindung zum Analysekonnektor über das Aktivitätscenter Analysen, über den Dateneditor in einer vorhandenen App oder über Skript in einem vorhandenen Skript erstellen. Folgen Sie den Schritten unten, um eine Verbindung zu erstellen.
Gehen Sie folgendermaßen vor:
Erstellen Sie eine neue Qlik Sense App oder ein Skript. Öffnen Sie Dateneditor oder 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 OpenAI.
Wählen Sie die gewünschte Konfiguration aus. Weitere Informationen über die einzelnen verfügbaren Optionen finden Sie unter Konfigurationen und konfigurierbare Einstellungen.
Geben Sie Ihren OpenAI API-Schlüssel ein. Weitere Informationen finden Sie unter Generieren eines OpenAI API-Schlüssels.
Wählen Sie unter OpenAI-Modell das gewünschte OpenAI-Modell aus.
Passen Sie die anderen Standardparameterwerte wie erforderlich an. Diese Parameter werden in der Dokumentation der OpenAI API beschrieben. Weitere Informationen finden Sie unter Chat, Completions und Embeddings.
Weitere Beschreibungen der Parameter finden Sie unter Konfigurationen und 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 und Skripten wiederverwendet werden. Sie ist auch unter Datenverbindungen in Dateneditor oder Skript aufgelistet.
Nachdem Sie die Verbindung erstellt haben, können Sie sie verwenden, um Daten mit den Anfragen und den Antworten der Plattform auf die Anfragen zu laden. Zudem können Sie sie in Diagrammformeln verwenden. Weitere Informationen finden Sie unter Auswählen und Laden von Daten in einer OpenAI-Verbindung und Verwenden von OpenAI-Verbindungen in Visualisierungsformeln.
Detaillierte Beispiele
Ausführliche Beispiele für die Arbeit mit dem OpenAI-Analysekonnektor finden Sie unter Tutorial – Verwenden des OpenAI-Analysekonnektors in Qlik Cloud.