# Tworzenie połączenia Azure OpenAI

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

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

## Zanim rozpoczniesz

Na koncie Microsoft Azure usługa Azure OpenAI znajduje się w Azure Cognitive Services i nie jest domyślnie włączona. Jeśli potrzebujesz pomocy przy włączaniu usługi Azure OpenAI, skontaktuj się z firmą Microsoft.

## Dostępne konfiguracje łączników

Skonfiguruj połączenie analityczne Azure OpenAI za pomocą jednej z poniższych konfiguracji.

### OpenAI Completions API

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ź zostanie zapisana 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.

### OpenAI Chat Completions API

Ta konfiguracja 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.

InformacjaWysył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.

## Tworzenie połączenia

Możesz utworzyć połączenie z łącznikiem analitycznym Azure OpenAI ze strony Utwórz centrum aktywności Analytics lub z Edytora ładowania danych w utworzonej już aplikacji. Aby utworzyć połączenie, wykonaj poniższe czynności.

Aby uzyskać informacje dotyczące sposobu ustawiania wartości parametrów, zobacz [Dokumentację interfejsu API REST usługi Azure OpenAI Service](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference).

Wykonaj następujące czynności:

1. Utwórz nową aplikację Qlik Sense lub skrypt i otwórz Edytor ładowania danych lub Skrypt.

2. Kliknij polecenie Utwórz nowe połączenie.

3. W obszarze Przestrzeń wybierz przestrzeń, w której będzie się znajdować połączenie.

4. W sekcji Źródła do analityki kliknij pozycję Azure OpenAI.

5. Wybierz potrzebną Konfigurację. Więcej informacji na temat każdej dostępnej opcji, zawiera temat [Dostępne konfiguracje łączników](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl).

6. Wprowadź Klucz API Azure OpenAI.

7. Wprowadź Wersję Azure API. To pole jest już wypełnione bieżącą wartością domyślną.

8. W razie potrzeby dostosuj dowolne inne domyślne wartości parametrów.

   Dodatkowe opisy parametrów zawiera temat [Konfigurowalne ustawienia](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Configur).

   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.

9. Kliknij 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 lub skryptach Qlik Sense.

Po utworzeniu połączenia można go użyć do załadowania danych do wysłania do Azure OpenAI. Ponadto można go używać w wyrażeniach wykresów. Więcej informacji zawierają tematy [Wybieranie i ładowanie danych z połączenia Azure OpenAI](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-load.htm) oraz [Używanie połączeń Azure OpenAI w wyrażeniach wizualizacji](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-use.htm).

## Konfigurowalne ustawienia

W oknie dialogowym połączenia można konfigurować ustawienia z następującej tabeli:

Konfigurowalne ustawienia w oknie dialogowym połączeń

| Pole | Opis |
| --- | --- |
| Select Configuration (Wybierz konfigurację) | W obszarze Konfiguracja wybierz konfigurację łącznika. Więcej informacji zawiera temat [Dostępne konfiguracje łączników](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-azure-openai-create.htm#Availabl). |
| Autoryzacja | Wprowadź Klucz Azure OpenAI API. Aby uzyskać więcej informacji, zobacz [Dokumentację interfejsu API REST usługi Azure OpenAI Service](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference). |
| Azure OpenAI Request (Żądanie Azure OpenAI) | <ul> <li> <p><span>Azure Resource Name</span> (Nazwa zasobu Azure): projekt zasobów skonfigurowany w <span>Microsoft Azure</span>.</p> <p><span>Azure Deployment Name</span> (Nazwa wdrożenia Azure): konkretne wdrożenie skonfigurowane dla wybranego modelu OpenAI.</p> </li> <li> <p><span>Azure API&nbsp;Version</span> (Wersja API Azure): wersja API w Azure. To pole jest wstępnie wypełnione bieżącą wartością domyślną.</p> </li> </ul> |
| OpenAI Request (Żądanie Open AI) | <ul> <li> <p><span>Temperature</span> (Temperatura): temperatura próbkowania do użycia.</p> </li> <li> <p><span>Max Tokens</span> (Maksimum tokenów): 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ą.</p> </li> <li> <p><span>Top P</span>: dostosowuje próbkowanie jądra. Parametr ten można zmienić jako alternatywę dla próbkowania <span>Temperature</span>.</p> </li> <li> <p><span>Frequency Penalty</span> (Kara za częstotliwość): stopień, w jakim model karze za nowe tokeny, które są dosłownie powtarzane z istniejących tokenów.</p> </li> <li> <p><span>Presence Penalty</span> (Kara za obecność): stopień, w jakim model karze za nowe tokeny, które są już zawarte w tekście do momentu ich wprowadzenia.</p> </li> <li> <p><span>User</span> (Użytkownik): identyfikator użytkownika końcowego, który może pomóc w monitorowaniu naruszeń zasad.</p> </li> </ul> |
| Asocjacja | Określ Association Field, pole z tabeli danych wejściowych zawierające unikatowy identyfikator.<br><br>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. |
| Nazwa | Nazwa połączenia. Jeśli nie wprowadzisz nazwy, zostanie użyta nazwa domyślna. |

## Dowiedz się więcej

* [Dokumentacja interfejsu API REST usługi Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/reference)