Conexión de Azure OpenAI

Introducción

Una conexión de Azure OpenAI, creada utilizando el conector de Azure OpenAI, establece acceso a Azure OpenAI. Una vez que se configura una conexión, se pueden crear instancias de actividades de Azure OpenAI asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Azure OpenAI

Se crea una nueva conexión de Azure OpenAI utilizando el conector de Azure OpenAI desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión de Azure OpenAI existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión de Azure OpenAI

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Azure OpenAI se describe a continuación.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Azure OpenAI y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Azure OpenAI, que se refiere tanto a una conexión específica como a sus actividades.

• Punto final: Ingresa el punto final para el recurso de Azure OpenAI. Puedes encontrar el punto final en el Portal de Azure bajo Gestión de recursos > Claves y punto final en la barra lateral izquierda.

• API/Clave secreta: Ingresa la clave API para el recurso de Azure OpenAI. Puedes obtener la clave API en el Portal de Azure bajo Gestión de recursos > Claves y punto final en la barra lateral izquierda. Puedes usar los valores de los campos CLAVE 1 o CLAVE 2.

• Configuraciones opcionales: Haz clic para expandir estas configuraciones opcionales:

  • Agregar una fuente de datos: Selecciona esta opción para interactuar con los modelos de Azure OpenAI utilizando datos de tu fuente de datos. Cuando seleccionas esta opción, aparecen campos adicionales según la fuente de datos seleccionada. Consulta Fuentes de datos para descripciones de las siguientes opciones:

    • Búsqueda de AI de Azure
    • Azure Cosmos DB para MongoDB (vCore)

  • Usar configuraciones de proxy (Solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuraciones de proxy de agente privado.

• Prueba: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Desactivar actualización automática del conector política de organización.

• Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Fuentes de datos

Cuando habilitas Agregar una fuente de datos en la conexión, puedes interactuar con modelos de Azure OpenAI utilizando datos de una Búsqueda de AI de Azure o instancia de Azure Cosmos DB para MongoDB (vCore).

Búsqueda de AI de Azure

Cuando seleccionas Búsqueda de AI de Azure como la fuente de datos, se muestran estos campos:

• Seleccionar una fuente de datos: Usa el menú para seleccionar la Búsqueda de AI de Azure.

  Nota

  Para información sobre los requisitos previos del servicio de Búsqueda de AI de Azure y la creación de un servicio de Búsqueda de AI de Azure, consulta la documentación de Microsoft.

• Nombre del servicio de búsqueda de Azure AI: Ingresa el Nombre del servicio configurado para tu servicio de búsqueda de Azure AI.

  Nota

  Debes tener al menos el rol de Contribuyente de Servicios Cognitivos para el recurso de Azure OpenAI.

• Seleccionar tipo de autenticación de recurso de Azure: La autenticación basada en clave (API Key) es compatible y está seleccionada por defecto.

• Clave de fuente de datos del servicio de búsqueda de Azure AI: Ingresa ya sea la Clave de administrador principal o la Clave de administrador secundaria. Puedes encontrar estas claves en la página de Clave de tu servicio de búsqueda bajo Configuración.

Azure Cosmos DB para MongoDB (vCore)

Cuando seleccionas Azure Cosmos DB para MongoDB (vCore) como la fuente de datos, se muestran estos campos:

• Seleccionar una fuente de datos: Usa el menú para seleccionar Azure Cosmos DB para MongoDB (vCore).

• Cadena de conexión: Ingresa la cadena de conexión para el clúster de Azure Cosmos DB para MongoDB (vCore).

• Nombre de la base de datos: Ingresa el nombre de la base de datos. Configuras el nombre de la base de datos a través de herramientas de MongoDB o tu código de aplicación.

• Colección de la base de datos: Ingresa el nombre de la colección. Configuras el nombre de la colección a través de herramientas de MongoDB o tu código de aplicación.

Siguientes pasos

Después de que se ha creado una conexión de Azure OpenAI, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán ya sea como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta los Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Registrar Herramientas: Agrega herramientas a los asistentes de chatbot en Azure OpenAI y está destinado a ser utilizado como un objetivo en una operación.

• Solicitar Imagen: Genera una imagen basada en un aviso específico en Azure OpenAI y está destinado a ser utilizado como un objetivo en una operación.

• Aviso: Crea una finalización de texto para el aviso proporcionado en Azure OpenAI y está destinado a ser utilizado como un objetivo en una operación.

• Descargar Imagen (obsoleto): Recupera la URL de una imagen generada previamente de Azure OpenAI y está destinado a ser utilizado como una fuente en una operación.