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 zur OpenAI-Analysequelle. Die Verbindung wird auf der Seite „Erstellen“ des Aktivitätscenters Analysen, Dateneditor oder Skript hergestellt.
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 weiteren konfigurierbaren Einstellungen können abhängig von der verwendeten Konfiguration variieren.
OpenAI Completions API (GPT-3) - 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.
Die OpenAI-Dokumentation zur in dieser Konfiguration verwendeten API finden Sie unter Completions.
Feld | Beschreibung |
---|---|
Konfiguration auswählen | Wählen Sie unter Konfiguration die Option OpenAI Completions (GPT-3) - Rows 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 Completions API (GPT-3) - JSON Tables
Mit dieser Konfiguration wird eine Anfrage für jede Zeile gesendet, und als Antwort wird eine JSON-Datenliste erwartet. Der Konnektor konvertiert die JSON-Tabelle in eine Datentabelle im Qlik Datenmodell. Aufgrund der Art der OpenAI-Antworten sollte dieser Vorgang als experimentell betrachtet werden.
Diese Konfiguration kann im Ladeskript zum Zusammenfassen von Daten verwendet werden. Sie ist nicht für die Verwendung in Diagrammformeln vorgesehen. Abhängig davon, wie Sie die Frage stellen, wird möglicherweise nicht immer gültiges JSON zurückgegeben.
Feld | Beschreibung |
---|---|
Konfiguration auswählen | Wählen Sie unter Konfiguration die Option OpenAI Completions (GPT-3) - JSON Tables 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 Chat Completions API (GPT-3.5, GPT-4) - Rows
Diese Konfiguration funktioniert so ähnlich wie die Konfiguration OpenAI Completions API (GPT-3) - Rows. Sie sendet aber 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.
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 Completions (GPT-3.5, GPT-4) - Rows 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 den 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.