Saltar al contenido

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:

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

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.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • 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:

  • Probar: 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 los agentes 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 política de organización Deshabilitar actualización automática del conector.

  • Guardar cambios: Haga 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, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Fuentes de datos

Cuando habilita Agregar una fuente de datos en la conexión, puede 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).

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

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

    Nota

    Para obtener 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, consulte la documentación de Microsoft.

  • Nombre del servicio de Búsqueda de AI de Azure: Ingrese el Nombre del servicio configurado para su servicio de búsqueda de AI de Azure.

    Nota

    Debe 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: Ingrese la clave de administrador principal o la clave de administrador secundaria. Puede encontrar estas claves en la página de Clave de su servicio de búsqueda bajo Configuración.

Azure Cosmos DB para MongoDB (vCore)

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

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

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

  • Nombre de la base de datos: Ingrese el nombre de la base de datos. Puede configurar el nombre de la base de datos a través de herramientas de MongoDB o su código de aplicación.

  • Colección de la base de datos: Ingrese el nombre de la colección. Puede configurar el nombre de la colección a través de herramientas de MongoDB o su código de aplicación.

Próximos pasos

Después de que se ha creado una conexión de Azure OpenAI, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán 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, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Registrar herramientas: Agrega herramientas a asistentes de chatbot en Azure OpenAI y está destinado a ser utilizado como un destino 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 destino en una operación.

  • Prompt: 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.

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