Creazione di una connessione Azure OpenAI

Per comunicare con Azure OpenAI, creare una connessione alla sorgente di analisi Azure OpenAI.

I dati ricevuti da queste connessioni possono essere utilizzati nello script di caricamento e nelle espressione del grafico per ottimizzare le app di analisi di Qlik Sense o gli script.

Prima di iniziare

Nell'account Microsoft Azure, il servizio Azure OpenAI si trova all'interno dei servizi cognitivi di Azure e non è abilitato per impostazione predefinita. Contattare Microsoft se si ha bisogno di assistenza di abilitare il servizio Azure OpenAI.

Configurazioni disponibili per il connettore

Impostare la connessione di analisi Azure OpenAI con una delle seguenti configurazioni.

API completamenti di OpenAI – Righe

Questa configurazione invia ogni riga di dati come una domanda all'API per il completamento (in lotti di piccole dimensioni per migliorare le prestazioni). Ogni risposta viene salvata come testo in una tabella con lo stesso numero di righe dell'input.

Questa configurazione può essere utilizzata sia nello script di caricamento che nelle espressioni del grafico.

API completamenti chat di OpenAI – Righe

Questa configurazione invia ogni riga di dati come una richiesta all'API di Completamenti chat OpenAI. In questo caso, le richieste sono completate con il ruolo messaggio “utente”, e ogni riga di dati viene inviata come una richiesta separata da Qlik.

Questa configurazione può essere utilizzata sia nello script di caricamento che nelle espressioni del grafico.

Creazione della connessione

È possibile creare una connessione al connettore di analisi Azure OpenAI dalla pagina Crea nel centro attività Analisi o dall'Editor caricamento dati in un'app già creata. Seguire i passaggi riportati di seguito per creare una connessione.

Per informazioni su come impostare i valori del parametro, vedere Riferimento API REST servizio Azure OpenAI.

Procedere come indicato di seguito:

1. Creare una nuova app o un nuovo script di Qlik Sense e aprire Editor caricamento dati o Script.

2. Fare clic su Crea nuova connessione.

3. In Spazio, selezionare lo spazio in cui verrà posizionata la connessione.

4. In Sorgenti di analisi, fare clic su Azure OpenAI.

5. Scegliere il tipo di Configurazione richiesto. Per maggiori informazioni su tutte le opzioni disponibili, vedere Configurazioni disponibili per il connettore.

6. Inserire la chiave dell'API Azure OpenAI.

7. Inserire la versione API Azure. Questo campo è già popolato con le impostazioni predefinite correnti.

8. Regolare qualsiasi valore predefinito dei parametri in base alle proprie esigenze.

   Per ulteriori descrizioni dei parametri, vedere Impostazioni configurabili.

   Nota informaticaSarà quasi sempre necessario alterare il valore del parametro Numero max token perché la connessioni funzioni correttamente in base alle proprie esigenze. Questo parametro controlla le dimensioni della risposta che verrà generata.

9. Fare clic su Crea.

La connessione dati è salvata nello spazio in cui è stata creata l'app, in modo da essere utilizzata in altre app o script di Qlik Sense.

Una volta creata la connessione, è possibile utilizzarla per caricare i dati da inviare a OpenAI. Inoltre, è possibile utilizzarla anche nelle espressioni del grafico. Per ulteriori informazioni, vedere Selezione e caricamento di dati da una connessione Azure OpenAI e Utilizzo delle connessioni Azure OpenAI nelle espressioni di visualizzazione.

Impostazioni configurabili

Le impostazioni nella seguente tabella possono essere configurate nella finestra di dialogo Connessione.