Tworzenie połączenia OpenAI

Aby komunikować się z platformą OpenAI, utwórz połączenie ze źródłem analityki OpenAI.

Aby komunikować się z OpenAI, utwórz połączenie ze źródłem analityki OpenAI. Utwórz połączenie w hubie lub narzędziu Edytor ładowania danych albo Edytor skryptów.

Danych otrzymanych z tych połączeń można używać w skrypcie ładowania i w wyrażeniach wykresu w celu ulepszenia aplikacji analitycznych Qlik Sense.

Konfiguracje i konfigurowalne ustawienia

Skonfiguruj połączenie analityczne OpenAI za pomocą jednej z poniższych konfiguracji. Inne konfigurowalne ustawienia mogą się różnić w zależności od używanej konfiguracji.

OpenAI Completions API (GPT-3) — wiersze

Ta konfiguracja wysyła każdy wiersz danych jako pytanie do interfejsu API uzupełnień (w małych partiach w celu zwiększenia wydajności). Każda odpowiedź jest zapisywana jako tekst w tabeli z taką samą liczbą wierszy jak w danych wejściowych.

Tej konfiguracji można używać w skrypcie ładowania danych oraz w wyrażeniach wykresu.

Aby zapoznać się z dokumentacją OpenAI dotyczącą interfejsu API używanego w tej konfiguracji, zobacz Uzupełnienia.

Konfigurowalne ustawienia dla konfiguracji „OpenAI Completions API (GPT-3) — wiersze”
Pole	Opis
Select Configuration	W obszarze Konfiguracja wybierz opcję Uzupełnienia OpenAI (GPT-3) — Wiersze.
Authorization	Wprowadź Klucz API OpenAI. Więcej informacji można znaleźć w temacie Generowanie klucza API OpenAI.
OpenAI Request	OpenAI Model: stosowany model. Temperature: temperatura próbkowania do użycia. Max Tokens: ten parametr określa maksymalną liczbę generowanych tokenów. Innymi słowy, kontroluje rozmiar odpowiedzi, która zostanie wygenerowana. Aby połączenie prawidłowo zaspokajało Twoje potrzeby, prawie zawsze należy zmienić wartość domyślną. Top P: dostosowuje próbkowanie jądra. Parametr ten można zmienić jako alternatywę dla próbkowania Temperature. Frequency Penalty: stopień, w jakim model karze za nowe tokeny, które są dosłownie powtarzane z istniejących tokenów. Presence Penalty: stopień, w jakim model karze za nowe tokeny, które są już zawarte w tekście do momentu ich wprowadzenia. User: identyfikator użytkownika końcowego, który może pomóc w monitorowaniu naruszeń zasad.
Association	Określ Association Field, pole z tabeli danych wejściowych zawierające unikatowy identyfikator. Pole to należy uwzględnić w danych źródłowych podczas tworzenia żądania punktu końcowego, aby zwrócona tabela wyników była powiązana z tabelą pól źródłowych przy użyciu klucza. Wyznaczone pole zostanie zwrócone jako pole w odpowiedzi i umożliwi powiązanie odpowiedzi z danymi źródłowymi w modelu danych. Może to być dowolne pole z unikatowym identyfikatorem, pochodzące z danych źródłowych lub używane w ramach procesu ładowania tabeli.
Name	Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna.

OpenAI Completions API (GPT-3) — tabele JSON

Ta konfiguracja wysyła żądanie w każdym wierszu, w którym oczekuje się odpowiedzi w postaci listy danych JSON. Łącznik przekonwertuje tabelę JSON na tabelę danych w modelu danych Qlik. Funkcję tę należy traktować jako eksperymentalną ze względu na charakter odpowiedzi OpenAI.

Tej konfiguracji można użyć w skrypcie ładowania do syntezy danych. Nie jest ona przeznaczona do stosowania w wyrażeniach wykresów. W zależności od sposobu zadania pytania może ona nie zawsze zwracać prawidłowy kod JSON.

Modele GPT mogą nie zawsze dokładnie przewidywać wygląd JSON — na przykład liczby zawierające tekst bez cudzysłowów. W niektórych przypadkach można zadać pytanie, dodając „jako lista JSON” do żądania w skrypcie ładowania. Inne sytuacje wymagają dużo większej szczegółowości, aby uzyskać pożądany wynik.

Konfigurowalne ustawienia dla konfiguracji „OpenAI Completions API (GPT-3) — tabele JSON”
Pole	Opis
Select Configuration	Pod pozycją Konfiguracja wybierz pozycję OpenAI Completions (GPT-3) — tabele JSON.
Authorization	Wprowadź Klucz API OpenAI. Więcej informacji można znaleźć w temacie Generowanie klucza API OpenAI.
OpenAI Request	OpenAI Model: stosowany model. Temperature: temperatura próbkowania do użycia. Max Tokens: ten parametr określa maksymalną liczbę generowanych tokenów. Innymi słowy, kontroluje rozmiar odpowiedzi, która zostanie wygenerowana. Aby połączenie prawidłowo zaspokajało Twoje potrzeby, prawie zawsze należy zmienić wartość domyślną. Top P: dostosowuje próbkowanie jądra. Parametr ten można zmienić jako alternatywę dla próbkowania Temperature. Frequency Penalty: stopień, w jakim model karze za nowe tokeny, które są dosłownie powtarzane z istniejących tokenów. Presence Penalty: stopień, w jakim model karze za nowe tokeny, które są już zawarte w tekście do momentu ich wprowadzenia. User: identyfikator użytkownika końcowego, który może pomóc w monitorowaniu naruszeń zasad.
Association	Określ Association Field, pole z tabeli danych wejściowych zawierające unikatowy identyfikator. Pole to należy uwzględnić w danych źródłowych podczas tworzenia żądania punktu końcowego, aby zwrócona tabela wyników była powiązana z tabelą pól źródłowych przy użyciu klucza. Wyznaczone pole zostanie zwrócone jako pole w odpowiedzi i umożliwi powiązanie odpowiedzi z danymi źródłowymi w modelu danych. Może to być dowolne pole z unikatowym identyfikatorem, pochodzące z danych źródłowych lub używane w ramach procesu ładowania tabeli.
Name	Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna.

OpenAI Chat Completions API (GPT-3.5, GPT-4) — wiersze

Ta konfiguracja działa podobnie jak konfiguracja OpenAI Completions API (GPT-3) — wiersze, ale wysyła każdy wiersz danych jako żądanie do OpenAI Chat Completions API. W tym przypadku żądania są wysyłane z rolą komunikatu „użytkownik”, a każdy wiersz danych z Qlik jest wysyłany jako osobne żądanie.

Wysyłanie wielu wierszy jako kontekstu czatu nie jest obsługiwane. Wszystkie pytania należy zawrzeć w jednym wierszu żądania.

Tej konfiguracji można używać w skrypcie ładowania danych oraz w wyrażeniach wykresu.

Aby zapoznać się z dokumentacją OpenAI dotyczącą interfejsu API używanego w tej konfiguracji, zobacz Czat.

Konfigurowalne ustawienia dla konfiguracji „OpenAI Completions API (GPT-3.5, GPT-4) — wiersze”
Pole	Opis
Select Configuration	W obszarze Konfiguracja wybierz opcję Uzupełnienia OpenAI (GPT-3.5, GPT-4) — Wiersze.
Authorization	Wprowadź Klucz API OpenAI. Więcej informacji można znaleźć w temacie Generowanie klucza API OpenAI.
OpenAI Request	OpenAI Model: stosowany model. Temperature: temperatura próbkowania do użycia. Max Tokens: ten parametr określa maksymalną liczbę generowanych tokenów. Innymi słowy, kontroluje rozmiar odpowiedzi, która zostanie wygenerowana. Aby połączenie prawidłowo zaspokajało Twoje potrzeby, prawie zawsze należy zmienić wartość domyślną. Top P: dostosowuje próbkowanie jądra. Parametr ten można zmienić jako alternatywę dla próbkowania Temperature. Frequency Penalty: stopień, w jakim model karze za nowe tokeny, które są dosłownie powtarzane z istniejących tokenów. Presence Penalty: stopień, w jakim model karze za nowe tokeny, które są już zawarte w tekście do momentu ich wprowadzenia. User: identyfikator użytkownika końcowego, który może pomóc w monitorowaniu naruszeń zasad.
Association	Określ Association Field, pole z tabeli danych wejściowych zawierające unikatowy identyfikator. Pole to należy uwzględnić w danych źródłowych podczas tworzenia żądania punktu końcowego, aby zwrócona tabela wyników była powiązana z tabelą pól źródłowych przy użyciu klucza. Wyznaczone pole zostanie zwrócone jako pole w odpowiedzi i umożliwi powiązanie odpowiedzi z danymi źródłowymi w modelu danych. Może to być dowolne pole z unikatowym identyfikatorem, pochodzące z danych źródłowych lub używane w ramach procesu ładowania tabeli.
Name	Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna.

Osadzenia OpenAI

Ta konfiguracja wysyła wiersze tekstu wejściowego do interfejsu API OpenAI Embeddings. OpenAI zwraca oddzielną reprezentację wektorową każdego wejścia. Ta reprezentacja wektorowa ma formę, która może być wykorzystywana przez modele uczenia maszynowego.

Aby zapoznać się z dokumentacją OpenAI dotyczącą interfejsu API używanego w tej konfiguracji, zobacz Osadzenia.

Konfigurowalne ustawienia konfiguracji „Osadzenia OpenAI”.
Pole	Opis
Select Configuration	W obszarze Konfiguracja wybierz opcję Osadzenia OpenAI.
Authorization	Wprowadź Klucz API OpenAI. Więcej informacji można znaleźć w temacie Generowanie klucza API OpenAI.
OpenAI Request	OpenAI Model: stosowany model. User: identyfikator użytkownika końcowego, który może pomóc w monitorowaniu naruszeń zasad.
Association	Określ Association Field, pole z tabeli danych wejściowych zawierające unikatowy identyfikator. Pole to należy uwzględnić w danych źródłowych podczas tworzenia żądania punktu końcowego, aby zwrócona tabela wyników była powiązana z tabelą pól źródłowych przy użyciu klucza. Wyznaczone pole zostanie zwrócone jako pole w odpowiedzi i umożliwi powiązanie odpowiedzi z danymi źródłowymi w modelu danych. Może to być dowolne pole z unikatowym identyfikatorem, pochodzące z danych źródłowych lub używane w ramach procesu ładowania tabeli.
Name	Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna.

Tworzenie połączenia

Połączenie z łącznikiem analitycznym można utworzyć z huba, z narzędzia Edytor ładowania danych w istniejącej aplikacji lub z narzędzia Edytor skryptów w istniejącym już skrypcie. Aby utworzyć połączenie, wykonaj poniższe czynności.

Wykonaj następujące czynności:

Utwórz nową aplikację lub skrypt Qlik Sense. Otwórz Edytor ładowania danych lub Edytor skryptów.
Kliknij polecenie Utwórz nowe połączenie.
W sekcji Źródła do analityki kliknij pozycję OpenAI.
Wybierz potrzebną Konfigurację. Więcej informacji na temat każdej dostępnej opcji zawiera temat Konfiguracje i konfigurowalne ustawienia.
Wprowadź Klucz API OpenAI. Więcej informacji można znaleźć w temacie Generowanie klucza API OpenAI.
W sekcji OpenAI model wybierz model OpenAI, którego chcesz używać.
W razie potrzeby dostosuj dowolne inne domyślne wartości parametrów. Parametry te są opisane w dokumentacji API OpenAI. Więcej informacji zawierają tematy Czat, Uzupełnienia i Osadzenia.

Dodatkowe opisy parametrów zawiera temat Konfiguracje i konfigurowalne ustawienia.

InformacjaAby połączenie prawidłowo zaspokajało Twoje potrzeby, prawie zawsze należy zmienić wartość parametru Max Tokens. Ten parametr kontroluje rozmiar odpowiedzi, która zostanie wygenerowana.
Kliknij polecenie Utwórz.

Połączenie danych jest zapisywane w przestrzeni, w której tworzona jest aplikacja, dzięki czemu można je ponownie wykorzystać w innych aplikacjach i skryptach Qlik Sense. Jest ono również wymienione w obszarze Połączenia danych w Edytor ładowania danych lub Edytor skryptów.

Po utworzeniu połączenia można go użyć do ładowania danych z żądaniami i odpowiedziami platformy na nie. Ponadto można go używać w wyrażeniach wykresów. Więcej informacji zawierają tematy Wybieranie i ładowanie danych z połączenia OpenAI oraz Używanie połączeń OpenAI w wyrażeniach wizualizacji.

Szczegółowe przykłady

Pełne przykłady pracy z łącznikiem analityki OpenAI zawiera temat Samouczek — Korzystanie z łącznika analityki OpenAI w Qlik Cloud.

Dowiedz się więcej

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!

Przekaż tu opinię