Crear una conexión a Azure OpenAI
Para comunicarse con Azure OpenAI, cree una conexión con la fuente de análisis de Azure OpenAI.
Los datos recibidos de estas conexiones se pueden usar en el script de carga y en expresiones de gráfico, para mejorar sus apps o scripts de análisis de Qlik Sense.
Antes de comenzar:
En su cuenta de Microsoft Azure, el servicio Azure OpenAI se encuentra dentro de los servicios cognitivos de Azure y, de forma predeterminada, no está habilitado. Póngase en contacto con Microsoft si necesita ayuda para habilitar el servicio Azure OpenAI.
Configuraciones de conectores disponibles
Configure su conexión de análisis de Azure OpenAI con una de las siguientes configuraciones.
OpenAI Completions API - Rows
Esta configuración envía cada fila de datos como una pregunta a la API de finalización (en lotes pequeños para mejorar el rendimiento). Cada respuesta se almacenará como texto en una tabla con el mismo número de filas que la entrada.
Esta configuración se puede utilizar tanto en el script de carga como en las expresiones de gráfico.
OpenAI Chat Completions API - Rows
Esta configuración envía cada fila de datos como una solicitud a la API de finalización de chat de OpenAI. En este caso, las solicitudes se realizan con el rol de mensaje "usuario" y cada fila de datos de Qlik se envía como una solicitud aparte.
Esta configuración se puede utilizar tanto en el script de carga como en las expresiones de gráfico.
Crear la conexión
Puede crear una conexión con el conector de analítica Azure OpenAI desde la página Crear del centro de actividades de Analítica, o desde el editor de carga de datos en una app que ya haya creado. Siga los pasos que se indican a continuación para crear una conexión.
Para obtener información sobre cómo establecer los valores de los parámetros, vea Referencia de la API REST de los servicios de Azure OpenAI.
Haga lo siguiente:
-
Cree una nueva app o script de Qlik Sense y abra Editor de carga de datos o Script.
-
Haga clic en Crear nueva conexión.
-
En Espacio, seleccione el espacio donde se ubicará la conexión.
-
En Fuentes de analítica, haga clic en Azure OpenAI.
-
Cierre la Configuración necesaria. Para más información sobre cada opción disponible, vea Configuraciones de conectores disponibles.
-
Escriba la Clave de API de Azure OpenAI.
- Escriba la Versión de API de Azure. Este campo ya está rellenado con el valor predeterminado actual.
-
Ajuste cualquiera de los otros valores de parámetros predeterminados según sea necesario.
Para obtener descripciones adicionales de los parámetros, consulte Ajustes configurables.
Nota informativaCasi siempre necesitará modificar el valor del parámetro Max Tokens para que la conexión funcione correctamente según sus necesidades. Este parámetro controla el tamaño de la respuesta que se generará. -
Haga clic en Crear.
La conexión de datos se guarda en el espacio donde se crea la app, por lo que se puede reutilizar en otras aplicaciones o scripts de Qlik Sense.
Una vez que haya creado la conexión, puede usarla para cargar datos y enviarlos a OpenAI. Además, puede usarla en expresiones gráficas. Para obtener más información, vea Seleccionar y cargar datos desde una conexión a Azure OpenAI y Utilizar conexiones a Azure OpenAI en expresiones de visualización.
Ajustes configurables
Los ajustes de la tabla siguiente se pueden configurar en el cuadro de diálogo de la conexión.
Campo | Descripción |
---|---|
Seleccionar configuración | En Configuración, seleccione la configuración para el conector. Para más información, vea Configuraciones de conectores disponibles. |
Autorización | Escriba la Clave de API de Azure OpenAI. Para más información, vea Referencia de la API REST de los servicios de Azure OpenAI. |
Solicitud de Azure OpenAI |
|
Solicitud de OpenAI |
|
Asociación |
Especifique un Campo de asociación, un campo de la tabla de datos de entrada que contiene un identificador único. Es necesario incluir este campo en los datos de origen al realizar una solicitud de punto de conexión para que la tabla de resultados devuelta se asocie con la tabla de campo de origen mediante una clave. El campo designado se devolverá como un campo en la respuesta y permitirá que la respuesta se asocie con los datos de origen en el modelo de datos. Puede ser cualquier campo con un ID único, ya sea de los datos de origen o como parte del proceso de carga de la tabla. |
Nombre | El nombre de la conexión. Si no indica un nombre se utiliza el nombre predeterminado. |