Utiliser l’application web Azure OpenAI

Outre Azure OpenAI Studio, les API et les SDK, vous pouvez également utiliser l’application web autonome disponible pour interagir avec les modèles Azure OpenAI en tirant parti d’une interface utilisateur graphique, que vous pouvez déployer à l’aide d'Azure OpenAI Studio ou d’un déploiement manuel.

Considérations importantes

• La publication crée une Azure App Service dans votre abonnement. Cela peut entraîner des coûts en fonction du plan tarifaire que vous sélectionnez. Lorsque vous avez terminé avec votre application, vous pouvez la supprimer du portail Azure.

• Les modèles gpt-4 vision-preview ne sont pas pris en charge.

• Par défaut, l'application sera déployée avec le fournisseur d'identité Microsoft déjà configuré, limitant l'accès à l'application aux membres de votre locataire Azure. Pour ajouter ou modifier l’authentification :

  1. Accédez au Portail Azure et recherchez le nom de l’application que vous avez spécifié lors de la publication. Sélectionnez l’application web, puis accédez à l’onglet Authentification dans le menu de navigation de gauche. Sélectionnez ensuite Ajouter un fournisseur d’identité.

     

  2. Sélectionnez Microsoft en tant que fournisseur d'identité. Les paramètres par défaut de cette page limitent l’application à votre locataire. Vous n’avez donc pas besoin de modifier autre chose ici. Sélectionnez ensuite Ajouter.

  Les utilisateurs sont maintenant invités à se connecter avec leur compte Microsoft Entra ID pour pouvoir accéder à votre application. Vous pouvez suivre un processus similaire pour ajouter un autre fournisseur d’identité si vous préférez. L’application n’utilise pas les informations de connexion de l’utilisateur d’une autre manière que pour vérifier qu’il est membre de votre tenant.

Personnalisation de l’application web

Vous pouvez personnaliser la logique front-end et back-end de l’application. L’application fournit plusieurs variables d’environnement pour des scénarios de personnalisation courants tels que la modification de l’icône dans l’application. Consultez le code source de l’application web et plus d’informations sur GitHub.

Lors de la personnalisation de l’application, nous vous recommandons :

• De réinitialiser la session de conversation (effacer la conversation) si l’utilisateur modifie des paramètres. D’informer l’utilisateur que son historique des conversations sera perdu.

• Communiquez clairement comment chaque paramètre implémenté va affecter l’expérience utilisateur.

• Quand vous effectuez une rotation des clés API pour votre ressource Azure OpenAI ou Recherche Azure AI, veillez à mettre à jour les paramètres d’application pour chacune de vos applications déployées pour qu’elles utilisent les nouvelles clés.

L’exemple de code source de l’application web est disponible sur GitHub. Le code source est fourni « tel quel » et en tant qu’exemple uniquement. Les clients sont responsables de toutes les personnalisations et implémentations de leurs applications web.

Mise à jour de l’application web

Remarque

Après le 1er février 2024, l’application web nécessite que la commande de démarrage de l’application soit définie sur python3 -m gunicorn app:app. Lors de la mise à jour d’une application publiée avant le 1er février 2024, vous devez ajouter manuellement la commande de démarrage à partir de la page App Service Configuration.

Nous recommandons d’extraire fréquemment les modifications de la main branche pour le code source de l’application web pour garantir que vous disposez des derniers correctifs de bogues, versions d’API et améliorations. En outre, l’application web doit être synchronisée chaque fois que la version de l’API utilisée est mise hors service.

Pensez à cliquer sur les boutons surveiller ou étoile du référentiel GitHub de l’application web pour être informé des modifications et des mises à jour apportées au code source.

Si vous n’avez pas personnalisé l’application :

• Vous pouvez suivre les étapes de synchronisation ci-dessous.

Si vous avez personnalisé ou modifié le code source de l’application :

• Vous devez mettre à jour manuellement le code source de votre application et le redéployer.
  • Si votre application est hébergée sur GitHub, envoyez (push) vos modifications de code à votre référentiel et utilisez les étapes de synchronisation ci-dessous.
  • Si vous redéployez l’application manuellement (par exemple, avec Azure CLI), suivez les étapes de votre stratégie de déploiement.

Synchroniser l’application web

1. Si vous avez personnalisé votre application, mettez à jour le code source de l’application.

2. Accédez à votre application web dans le Portail Azure.

3. Sélectionnez Centre de déploiement dans le menu de navigation, sous Déploiement.

4. Sélectionnez Synchroniser en haut de l’écran, puis confirmez que l’application sera redéployée.

   

Historique des conversations

Vous pouvez activer l’historique des conversations pour vos utilisateurs de l’application web. Lorsque vous activez la fonctionnalité, vos utilisateurs ont accès à leurs requêtes et réponses individuelles précédentes.

Pour activer l’historique des conversations, déployez ou redéployez votre modèle en tant qu’application web à l’aide d’Azure OpenAI Studio.

Important

L’activation de l’historique des conversations crée une instance Cosmos DB dans votre groupe de ressources et entraîne des frais supplémentaires pour le stockage utilisé.

Une fois que vous avez activé l’historique des conversations, vos utilisateurs peuvent l’afficher et le masquer dans le coin supérieur droit de l’application. Lorsque l’historique s’affiche, ils peuvent renommer ou supprimer des conversations. À mesure qu’elles sont connectées à l’application, les conversations sont automatiquement classées de la plus récente à la plus ancienne et nommées en fonction de la première requête de la conversation.

Supprimer votre instance Cosmos DB

La suppression de votre application web ne supprime pas automatiquement votre instance Cosmos DB. Pour supprimer votre instance Cosmos DB, ainsi que toutes les conversations stockées, vous devez accéder à la ressource associée dans le Portail Azure et la supprimer. Si vous supprimez la ressource Cosmos DB, mais que l’option d’historique des conversations est activée sur le studio, vos utilisateurs sont avertis d’une erreur de connexion, mais peuvent continuer à utiliser l’application web sans avoir accès à l’historique des conversations.

Étapes suivantes

• Ingénierie d’invite
• Azure OpenAI sur vos données