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 para 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.

  • Clave API/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:

    • Almacenar el contexto del chat a través de operaciones: (Grupos de agentes en la nube solamente.) Selecciona esta opción para habilitar la gestión del contexto del chat al usar un grupo de agentes en la nube. Cuando habilitas esta opción, el conector mantiene el historial de conversaciones entre operaciones dentro del mismo entorno que comparten el mismo chatId (configurado en la actividad de Registro de herramientas). Esto permite que Azure OpenAI haga referencia a interacciones anteriores a través de diferentes proyectos y flujos de trabajo.

      Nota

      Los agentes privados mantienen el contexto del chat en la memoria local solo para operaciones dentro de la misma cadena de operaciones que comparten el mismo chatId.

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

  • 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 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 política de organización Deshabilitar Actualización Automática del Conector.

  • 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 confirmar 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 confirmar 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 un Azure AI Search o instancia de Azure Cosmos DB para MongoDB (vCore).

Cuando seleccionas Azure AI Search como la fuente de datos, se muestran estos campos:

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

    Nota

    Para información sobre los requisitos previos del servicio Azure AI Search y la creación de un servicio Azure AI Search, 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 del recurso de Azure: La autenticación basada en clave (API Key) es compatible y está seleccionada por defecto.

  • Clave de origen 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 Configuraciones.

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.

Próximos 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 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 Menús de acciones en Conceptos básicos de conectores.

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.