Usar la aplicación web de Azure OpenAI
Junto con Azure OpenAI Studio, las API y los SDK, puede usar también la aplicación web independiente disponible para interactuar con los modelos de Azure OpenAI mediante una interfaz gráfica de usuario, que puede implementar mediante Azure OpenAI Studio o una implementación manual.
Consideraciones importantes
La publicación crea una instancia de Azure App Service en la suscripción. Puede suponer costes en función del plan de precios que elijas. Cuando haya terminado con la aplicación, podrá eliminarla de Azure Portal.
No se admiten modelos gpt-4 vision-preview.
De forma predeterminada, la aplicación se implementará con el proveedor de identidades de Microsoft ya configurado, lo que restringe el acceso a la aplicación a los miembros del inquilino de Azure. Para agregar o modificar la autenticación:
Vaya a Azure Portal y busque el nombre de la aplicación que especificó durante la publicación. Seleccione la aplicación web y vaya a la pestaña Autenticación del menú de navegación izquierdo. A continuación, seleccione Agregar un proveedor de identidades.
Seleccione Microsoft como proveedor de identidades. La configuración predeterminada de esta página restringirá la aplicación al inquilino solamente, por lo que no será necesario cambiar nada más aquí. A continuación, seleccione Agregar
Ahora se pedirá a los usuarios que inicien sesión con su cuenta de Microsoft Entra ID para poder acceder a su aplicación. Podría seguir un proceso similar para agregar otro proveedor de identidades si lo prefiriese. La aplicación no usa la información de inicio de sesión del usuario de ninguna otra manera que no sea comprobar que es miembro del inquilino.
Personalización de aplicaciones web
Puede personalizar la lógica de front-end y back-end de la aplicación. La aplicación proporciona varias variables de entorno para escenarios de personalización comunes, como cambiar el icono de la aplicación. Consulte el código fuente de la aplicación web y obtenga más información sobre GitHub.
Al personalizar la aplicación, se recomienda:
Restablecer la sesión de chat (borrar chat) si el usuario cambia cualquier configuración. Notificar al usuario que se perderá su historial de chat.
Comunicar claramente cómo afectará cada configuración que implemente a la experiencia del usuario.
Al rotar las claves de API para el recurso de Azure OpenAI o Azure AI Search, asegúrese de actualizar la configuración de la aplicación para que cada una de las aplicaciones implementadas use las nuevas claves.
El código fuente de ejemplo para la aplicación web está disponible en GitHub. El código fuente se proporciona "tal cual" y solo como ejemplo. Los clientes son responsables de toda la personalización e implementación de sus aplicaciones web.
Actualizar la aplicación web
Nota:
Después del 1 de febrero de 2024, la aplicación web requiere que el comando de inicio de la aplicación se establezca en python3 -m gunicorn app:app. Al actualizar una aplicación publicada antes del 1 de febrero de 2024, debe agregar manualmente el comando de inicio desde la página Configuración de App Service.
Se recomienda extraer los cambios de la rama main del código fuente de la aplicación web con frecuencia para asegurarse de que tiene las últimas correcciones de errores, versiones de la API y mejoras. Además, la aplicación web debe sincronizarse cada vez que se retira la versión de API que se usa.
Considere la posibilidad de hacer clic en los botones de reloj o estrella en el repositorio de GitHub de la aplicación web para recibir notificaciones sobre los cambios y las actualizaciones del código fuente.
Si no ha personalizado la aplicación:
- Puede seguir los pasos de sincronización siguientes
Si ha personalizado o cambiado el código fuente de la aplicación:
- Tendrá que actualizar manualmente el código fuente de la aplicación y volver a implementarlo.
- Si la aplicación está hospedada en GitHub, inserte los cambios de código en el repositorio y siga estos pasos de sincronización.
- Si va a implementar la aplicación manualmente (por ejemplo, la CLI de Azure), siga los pasos de la estrategia de implementación.
Sincronizar la aplicación web
Si ha personalizado la aplicación, actualice el código fuente de la aplicación.
Vaya a la aplicación web en Azure Portal.
Seleccione Centro de implementación en el menú de navegación, en Implementación.
Seleccione Sincronizar en la parte superior de la pantalla y confirme que la aplicación se volverá a implementar.
Historial de chat
Puede habilitar el historial de chat para los usuarios de la aplicación web. Al habilitar la característica, los usuarios tendrán acceso a sus consultas y respuestas anteriores individuales.
Para habilitar el historial de chats, implemente o vuelva a implementar el modelo como una aplicación web mediante Azure OpenAI Studio.
Importante
Al habilitar el historial de chat, se creará una instancia de Cosmos DB en el grupo de recursos y se incurrirán en cargos adicionales por el almacenamiento usado.
Una vez que haya habilitado el historial de chats, los usuarios podrán mostrarlo y ocultarlo en la esquina superior derecha de la aplicación. Cuando se muestra el historial, pueden cambiar el nombre o eliminar conversaciones. A medida que han iniciado sesión en la aplicación, las conversaciones se ordenarán automáticamente de la más reciente a la más antigua y se denominarán en función de la primera consulta de la conversación.
Eliminación de la instancia de Cosmos DB
La eliminación de la aplicación web no elimina automáticamente la instancia de Cosmos DB. Para eliminar la instancia de Cosmos DB, junto con todos los chats almacenados, debe ir al recurso asociado en el Azure Portal y eliminarlo. Si elimina el recurso de Cosmos DB pero mantiene habilitada la opción de historial de chat en Studio, se notificará a los usuarios un error de conexión, pero puede seguir usando la aplicación web sin acceso al historial de chat.