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.

L'invio di più righe come contesto di una chat non è supportato. È necessario includere tutte le domane in un'unica riga di richiesta.

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 dall'hub o dall'Editor di 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:

Creare una nuova app o un nuovo script di Qlik Sense e aprire Editor caricamento dati o Editor di script.
Fare clic su Crea nuova connessione.
In Sorgenti di analisi, fare clic su Azure OpenAI.
Scegliere il tipo di Configurazione richiesto. Per maggiori informazioni su tutte le opzioni disponibili, vedere Configurazioni disponibili per il connettore.
Inserire la chiave dell'API Azure OpenAI.
Inserire la versione API Azure. Questo campo è già popolato con le impostazioni predefinite correnti.
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.
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.

Impostazioni configurabili nella finestra di dialogo di connessione
Campo	Descrizione
Seleziona configurazione	In Configurazione, selezionare la configurazione per il connettore. Per ulteriori informazioni, vedere Configurazioni disponibili per il connettore.
Autorizzazione	Inserire la chiave dell'API Azure OpenAI. Per maggiori informazioni, vedere Riferimento API REST servizio Azure OpenAI.
Richiesta Azure OpenAI	Nome risorsa Azure: il progetto della risorsa configurato in Microsoft Azure. Nome distribuzione Azure: la distribuzione specifica configurata per il modello OpenAI scelto. Versione API Azure: la versione API in Azure. Questa è pre-popolata con il valore predefinito corrente.
Richiesta OpenAI	Temperatura: la temperatura da usare per il campionamento. Numero max token: questo parametro regola il numero massimo di token da generare. In altre parole, controlla le dimensioni della risposta che verrà generata. Sarà quasi sempre necessario alterare il valore predefinito perché la connessioni funzioni correttamente in base alle proprie esigenze. P principale: regola il nucleo del campionamento. È possibile modificarlo in alternativa al campionamentoTemperatura. Penalità frequenza: il grado in cui il modello penalizza i nuovi token ripetuti letteralmente da token esistenti. Penalità presenza: il grado in cui il modello penalizza i nuovi token già contenuti nel testo fino al punto in cui sono introdotti. Utente: l'ID dell'utente finale, che consente di monitorare le violazioni dei criteri.
Associazione	Specificare un Campo Associazione dalla tabella dati di input contenente un identificatore univoco. È necessario includere questo campo nei dati di origine quando si crea una richiesta endpoint per la tabella risultati restituita da associare alla tabella campo di origine usando una chiave. Il campo designato verrà restituito come campo nella risposta e consentirà l'associazione della risposta ai dati di origine nel modello dati. Può trattarsi di qualsiasi campo con un ID univoco, dai dati di origine o all'interno del processo di caricamento delle tabelle.
Name	Il nome della connessione. Se non si inserisce un nome, viene utilizzato il quello predefinito.

Ulteriori informazioni

Riferimento API REST servizio Azure OpenAI

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!

Lascia qui il tuo feedback