Saltar al contenido principal Saltar al contenido complementario

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.

Nota informativaNo se admite el envío de varias filas como contexto de chat. Debe incluir todas las preguntas en una sola fila de solicitudes.

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.

  1. Cree una nueva app o script de Qlik Sense y abra Editor de carga de datos o Script.

  2. Haga clic en Crear nueva conexión.

  3. En Espacio, seleccione el espacio donde se ubicará la conexión.

  4. En Fuentes de analítica, haga clic en Azure OpenAI.

  5. Cierre la Configuración necesaria. Para más información sobre cada opción disponible, vea Configuraciones de conectores disponibles.

  6. Escriba la Clave de API de Azure OpenAI.

  7. Escriba la Versión de API de Azure. Este campo ya está rellenado con el valor predeterminado actual.
  8. 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á.
  9. 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.

Ajustes configurables en el diálogo de 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
  • Azure Resource Name: el proyecto de recursos que ha configurado en Microsoft Azure.

    Azure Deployment Name: la implementación específica que ha configurado para el modelo de OpenAI que ha elegido.

  • Azure API Version: la versión de API en Azure. Se rellena previamente con el valor predeterminado actual.

Solicitud de OpenAI
  • Temperatura: la temperatura de muestreo que se utilizará.

  • Máximo de tokens: este parámetro ajusta la cantidad máxima de tokens que se generarán. En otras palabras, controla el tamaño de la respuesta que se generará. Casi siempre necesitará modificar el valor predeterminado para que la conexión funcione correctamente según sus necesidades.

  • Top P: ajusta el muestreo del núcleo. Esto se puede modificar como una alternativa al muestreo de Temperature.

  • Penalización de frecuencia: el grado en el que el modelo penaliza los tokens nuevos que se repiten palabra por palabra a partir de los tokens existentes.

  • Penalización de presencia: el grado en que el modelo penaliza los nuevos tokens que ya están contenidos en el texto hasta el momento en que se introducen.

  • Usuario: el ID del usuario final, que puede ayudar a supervisar violaciones de políticas.

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.

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.