Tutoriel : Déployer une application web de conversation d’entreprise

Important

Les éléments marqués (préversion) dans cet article sont actuellement en préversion publique. Cette préversion est fournie sans contrat de niveau de service, nous la déconseillons dans des charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Dans cet article, vous déployez une application web de conversation d’entreprise qui utilise vos propres données avec un grand modèle de langage dans le portail Azure AI Foundry.

Votre source de données est utilisée pour aider à ancrer le modèle sur des données spécifiques. Ancrer signifie que le modèle utilise vos données pour l’aider à comprendre le contexte de votre question. Vous ne modifiez pas le modèle déployé lui-même. Vos données sont stockées de façon séparée et sécurisée dans votre source de données d’origine.

Les étapes de ce tutoriel sont les suivantes :

• Configurez les ressources.
• Ajoutez vos données.
• Testez le modèle avec vos données.
• Déployez votre application web.

Prérequis

• Un abonnement Azure : créez-en un gratuitement.

• Modèle de conversation Azure OpenAI déployé. Si vous ne l’avez pas encore fait, effectuez le démarrage rapide avec les terrains de jeu Azure AI Foundry pour créer cette ressource.

• Connexion d’un service de recherche pour indexer les exemples de données de produit. Si vous n’avez pas de service de recherche, suivez les étapes pour en créer un et le connecter.

• Copie locale des données de produit. Le dépôt Azure-Samples/rag-data-openai-python-promptflow sur GitHub contient des exemples d’informations sur les produits de vente au détail pertinents pour le scénario de ce tutoriel. Plus précisément, le fichier product_info_11.md contient des informations sur les chaussures de randonnée TrailWalker pertinentes pour cet exemple de didacticiel. Télécharger l’exemple de données de produit de vente au détail Contoso Trek dans un fichier ZIP sur votre ordinateur local.

• Un fournisseur de ressources Microsoft.Web inscrit dans l’abonnement sélectionné pour pouvoir le déployer sur une application web. Pour plus d’informations sur l’inscription d’un fournisseur de ressources, consultez Inscrire un fournisseur de ressources.

• Autorisations nécessaires pour ajouter des attributions de rôles dans votre abonnement Azure. L’octroi d’autorisations par attribution de rôle n’est autorisé que par le propriétaire des ressources Azure en question.

Portail Azure AI Foundry et portail Azure

Dans ce tutoriel, vous effectuez certaines tâches dans le portail Azure AI Foundry et d’autres tâches dans le portail Azure.

Le portail Azure AI Foundry est un environnement web permettant de créer, d’entraîner et de déployer des modèles d’IA. En tant que développeur, c’est là que vous allez créer et déployer votre application web de conversation.

Le portail Azure permet à un administrateur de gérer et de surveiller les ressources Azure. En tant qu’administrateur, vous allez utiliser le portail afin de configurer les paramètres pour différents services Azure qui sont requis pour l’accès à partir de l’application web.

Configuration des ressources

Important

Vous devez disposer des autorisations nécessaires pour ajouter des attributions de rôles dans votre abonnement Azure. L’octroi d’autorisations par attribution de rôle n’est autorisé que par le propriétaire des ressources Azure en question. Vous devrez peut-être demander au propriétaire de votre abonnement Azure (qui peut être votre administrateur informatique) d’effectuer cette section pour vous.

Pour que les ressources fonctionnent correctement au sein d’une application web, vous devez les configurer avec les autorisations appropriées. Cela s’effectue dans le portail Azure.

Pour commencer, identifiez les ressources que vous devez configurer à partir du portail Azure AI Foundry.

1. Ouvrez le portail Azure AI Foundry et sélectionnez le projet que vous avez utilisé pour déployer le modèle de conversation Azure OpenAI.

2. Sélectionnez ensuite Centre de gestion dans le volet gauche.

3. Sélectionnez Ressources connectées sous votre projet.

4. Identifiez les trois ressources que vous devez configurer : la ressource Azure OpenAI, la ressource Recherche Azure AI et le Stockage Blob Azure correspondant à votre magasin de données workspaceblobstore.

   

   Conseil

   Si vous avez plusieurs ressources Azure OpenAI, utilisez celle qui contient votre modèle de conversation déployé.

5. Pour chaque ressource, sélectionnez le lien pour ouvrir les détails de la ressource. Sur la page des détails, sélectionnez le nom de la ressource pour ouvrir la ressource correspondante dans le portail Azure. (Pour le magasin de données workspaceblobstore, sélectionnez Afficher dans le portail Azure).

6. Une fois l’onglet du navigateur ouvert, revenez au portail Azure AI Foundry et répétez le processus pour la ressource suivante.

7. Lorsque vous avez terminé, vous devez avoir trois nouveaux onglets de navigateur ouverts : un pour Service de recherche, un pour Azure AI services et un pour le conteneur blobstore. Laissez les trois nouveaux onglets ouverts lorsque vous allez passer de l’un à l’autre pour configurer les ressources.

Activer une identité managée

Sous l’onglet de la ressource Service de recherche dans le portail Azure, activez l’identité managée :

1. Sous Paramètres dans le volet gauche, sélectionnez Identité.
2. Définissez l’État sur Activé.
3. Cliquez sur Enregistrer.

Sous l’onglet de la ressource Azure AI services dans le portail Azure, activez l’identité managée :

1. Sous Gestion des ressources dans le volet gauche, sélectionnez Identité.
2. Définissez l’État sur Activé.
3. Cliquez sur Enregistrer.

Définir le contrôle d’accès pour la recherche

Sous l’onglet de la ressource Service de recherche dans le portail Azure, définissez la stratégie d’accès aux API :

1. Sous Paramètres dans le volet gauche, sélectionnez Clés.
2. Sous Contrôle d’accès à l’API, sélectionnez Les deux.
3. Lorsque vous y êtes invité, sélectionnez Oui pour confirmer la modification.

Attribuer des rôles

Vous répéterez cette procédure plusieurs fois dans les éléments de la liste à puces ci-dessous.

La procédure générale d’affectation du contrôle d’accès en fonction du rôle (RBAC) pour n’importe quelle ressource est la suivante :

1. Accédez au portail Azure pour la ressource donnée.
2. Dans la page de gauche du portail Azure, sélectionnez Contrôle d’accès (IAM).
3. Sélectionnez + Ajouter>Ajouter une attribution de rôle.
4. Recherchez le rôle que vous devez attribuer et sélectionnez-le. Sélectionnez ensuite Suivant.
5. Lors de l’affectation d’un rôle à vous-même :
   1. Sélectionnez Utilisateur, groupe ou principal de service.
   2. Sélectionnez Sélectionner des membres.
   3. Recherchez votre nom et sélectionnez-le.
6. Lors de l’affectation d’un rôle à une autre ressource :
   1. Sélectionnez Identité managée.
   2. Sélectionnez Sélectionner des membres.
   3. Utilisez la liste déroulante pour rechercher le type de ressource que vous souhaitez affecter. Par exemple, Azure AI services ou Service de recherche.
   4. Sélectionnez la ressource dans la liste qui s’affiche. Il se peut qu’il n’y en ait qu’une seule, mais vous devez quand même la sélectionner.
7. Passez à l’Assistant et sélectionnez Vérifier + affecter pour ajouter l’attribution de rôle.

Suivez ces étapes pour affecter des rôles pour les ressources que vous configurez dans ce tutoriel :

• Affectez les rôles suivants sous l’onglet du navigateur pour Service de recherche dans le portail Azure :

  • Lecteur de données d’index de recherche à l’identité managée Azure AI services
  • Contributeur du service de recherche à l’identité managée Azure AI services
  • Contributeur à vous-même (pour trouver Contributeur, passez à l’onglet Rôles d’administrateur privilégié en haut. Tous les autres rôles se trouvent sous l’onglet Rôle de fonction de tâche.)

• Affectez les rôles suivants sous l’onglet du navigateur pour Azure AI services dans le portail Azure :

  • Contributeur OpenAI Cognitive Services à l’identité managée Service de recherche
  • Contributeur à vous-même.

• Affectez les rôles suivants sous l’onglet du navigateur pour Stockage Blob Azure dans le portail Azure :

  • Contributeur aux données Blob du stockage à l’identité managée Azure AI services
  • Lecteur des données blob du stockage à l’identité managée Service de recherche
  • Contributeur à vous-même

Vous avez terminé de configurer les ressources. Vous pouvez désormais fermer les onglets du navigateur du portail Azure si vous le souhaitez.

Ajouter vos données et réessayer le modèle de conversation

Dans le démarrage rapide avec les terrains de jeu Azure AI Foundry (c’est un prérequis pour ce didacticiel), observez la façon dont votre modèle répond sans vos données. Ajoutez maintenant vos données au modèle pour lui permettre de répondre aux questions relatives à vos produits.

Pour suivre cette section, vous avez besoin d’une copie locale des données de produit. Le dépôt Azure-Samples/rag-data-openai-python-promptflow sur GitHub contient des exemples d’informations sur les produits de vente au détail pertinents pour le scénario de ce tutoriel. Plus précisément, le fichier product_info_11.md contient des informations sur les chaussures de randonnée TrailWalker pertinentes pour cet exemple de didacticiel. Télécharger l’exemple de données de produit de vente au détail Contoso Trek dans un fichier ZIP sur votre ordinateur local.

Suivez ces étapes pour ajouter vos données au terrain de jeu de conversation afin d’aider l’assistant à répondre aux questions sur vos produits. Vous ne modifiez pas le modèle déployé lui-même. Vos données sont stockées séparément et en toute sécurité dans votre abonnement Azure.

1. Accédez à votre projet dans Azure AI Foundry.

2. Sélectionnez terrains de jeux.

3. Sélectionnez Essayer le terrain de jeu de conversation.

4. Sélectionnez votre modèle de conversation déployé dans la liste déroulante Déploiement.

   

5. Sur le côté gauche du terrain de jeu de conversation, sélectionnez Ajouter vos données (PRÉVERSION)>+ Ajouter une nouvelle source de données.

   

6. Dans le menu déroulant Source de données, sélectionnez Charger les fichiers.

   

7. Sélectionnez Charger>Charger les fichiers pour parcourir vos fichiers locaux.

8. Sélectionnez les fichiers à charger. Sélectionnez les fichiers d’informations sur le produit que vous téléchargés ou créés précédemment. Ajoutez tous les fichiers maintenant. Vous ne pourrez pas ajouter plus de fichiers plus tard dans la même session de terrain de jeu.

9. Sélectionnez Charger pour charger le fichier dans votre compte de stockage Blob Azure. Sélectionnez ensuite Suivant.

   

10. Sélectionnez votre service Recherche Azure AI.

11. Pour le Nom de l’index vecteur, entrez product-info et sélectionnez Suivant.

12. Dans la page Paramètres de recherche sous Paramètres vectorielles, décochez la case Ajouter une recherche vectorielle à cette ressource de recherche. Ce paramètre permet de déterminer la façon dont le modèle répond aux requêtes. Sélectionnez ensuite Suivant.

    Remarque

    Si vous ajoutez une recherche vectorielle, d’autres options sont disponibles ici pour un coût supplémentaire.

13. Passez en revue vos paramètres et sélectionnez Créer un index vecteur.

14. Dans le terrain de jeu, vous pouvez voir que l’ingestion de vos données est en cours. Ce processus peut prendre quelques minutes. Avant de continuer, attendez de voir la source de données et le nom de l’index à la place de l’état.

    

15. Vous pouvez maintenant converser avec le modèle qui pose la même question qu’avant (« Combien coûtent les chaussures de randonnée TrailWalker ? »), et cette fois, il utilise des informations de vos données pour construire la réponse. Vous pouvez développer le bouton références pour afficher les données utilisées.

Déployez votre application web

Une fois que vous êtes satisfait de l’expérience dans le portail Azure AI Foundry, vous pouvez déployer le modèle en tant qu’application web autonome.

Accéder au groupe de ressources dans le portail Azure

Dans ce didacticiel, votre application web est déployée sur le même groupe de ressources que votre hub Azure AI Foundry. Plus tard, vous configurez l’authentification pour l’application web dans le portail Azure.

Suivez ces étapes pour accéder à votre groupe de ressources dans le portail Azure :

1. Accédez à votre projet dans Azure AI Foundry. Sélectionnez ensuite Centre de gestion dans le volet gauche.

2. Sous le titre Project, sélectionnez Vue d’ensemble.

3. Sélectionnez le nom du groupe de ressources pour ouvrir le groupe de ressources dans le portail Azure. Dans cet exemple, le groupe de ressources est nommé rg-sdg-ai.

   

4. Vous devriez maintenant être dans le portail Azure et voir le contenu du groupe de ressources où vous avez déployé le hub. Notez le nom et l’emplacement du groupe de ressources. Vous utiliserez ces informations dans la section suivante.

5. Laissez cette page ouverte dans un onglet de navigateur. Vous y reviendrez ultérieurement.

Déployer l’application web

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.

Pour déployer l’application web :

Important

Vous devez inscrire Microsoft.Web en tant que fournisseur de ressources avant de pouvoir déployer sur une application web.

1. Suivez les étapes décrites dans la section précédente pour ajouter vos données au terrain de jeu. (Vous pouvez déployer une application web avec ou sans vos propres données, mais vous avez besoin d’au moins un modèle déployé, comme décrit dans Démarrage rapide avec les terrains de jeu Azure AI Foundry.)

2. Sélectionnez Déployer > ... en tant qu’application web.

   

3. Sur la page Déployer sur une application web, entrez les détails suivants :

   • Nom : nom unique pour votre application web.
   • Abonnement: Votre abonnement Azure. Si vous ne voyez aucun abonnement disponible, commencez par inscrire Microsoft.Web en tant que fournisseur de ressources.
   • Groupe de ressources : sélectionnez un groupe de ressources dans lequel déployer l’application web. Utilisez le même groupe de ressources que le hub.
   • Emplacement : sélectionnez un emplacement dans lequel déployer l’application web. Utilisez le même emplacement que le hub.
   • Plan de tarification : choisissez un plan tarifaire pour l’application web.
   • Activer l'historique des discussions dans l'application web : Pour le tutoriel, la case Historique des discussions n'est pas cochée. Si vous activez la fonctionnalité, vos utilisateurs ont accès à leurs requêtes et réponses individuelles précédentes. Pour plus d'informations, consultez les remarques sur l'historique des discussions.

4. Sélectionnez Déployer.

5. Attendez que l’application soit déployée, ce qui peut prendre quelques minutes.

6. Quand il est prêt, le bouton Lancer est activé dans la barre d’outils. Ne lancez pas encore l’application et ne fermez pas la page du terrain de jeu de conversation, car vous allez y revenir plus tard.

Configurer l’authentification d’application web

Par défaut, vous seul pouvez accéder à l’application web. Dans ce tutoriel, vous pouvez ajouter l’authentification pour restreindre l’accès à l’application aux membres de votre locataire Azure. Les utilisateurs sont maintenant invités à se connecter avec leur compte Microsoft Entra 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 locataire.

1. Revenez à l’onglet du navigateur contenant le portail Azure (ou rouvrez le portail Azure dans un nouvel onglet de navigateur) et regardez le contenu du groupe de ressources où vous avez déployé l’application web (vous devrez peut-être actualiser l’affichage de l’application web).

2. Sélectionnez la ressource App Service dans la liste des ressources du groupe de ressources.

3. Dans le menu de gauche réductible, sous Paramètres, sélectionnez Authentification.

   

4. Si vous voyez Microsoft référencé comme fournisseur d’identité sur cette page, rien d’autre n’est nécessaire. Vous pouvez ignorer l’étape suivante.

5. Ajoutez un fournisseur d’identité avec les paramètres suivants :

   • Fournisseur d’identité : sélectionnez Microsoft comme 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.
   • Type de locataire : main-d’œuvre
   • Inscription d’application : créer une inscription d’application
   • Nom : nom de votre service d’application web
   • Types de comptes pris en charge : locataire actuel – Locataire unique
   • Restreindre l’accès : nécessite une authentification
   • Requêtes non authentifiées : redirection HTTP 302 trouvée – recommandée pour les sites web

Utilisez l’application web

Vous avez presque terminé. Vous pouvez maintenant tester l’application web.

1. Si vous avez modifié les paramètres, attendez 10 minutes pour que les paramètres d’authentification prennent effet.

2. Revenez à l’onglet de navigateur contenant la page du terrain de jeu de conversation dans le portail Azure AI Foundry.

3. Sélectionnez Lancer pour lancer l’application web déployée. Si vous y êtes invité, acceptez la demande d’autorisations.

4. Si vous ne voyez pas Lancer dans le terrain de jeu, sélectionnez Applications web dans le volet gauche, puis sélectionnez votre application dans la liste pour la lancer.

   Si les paramètres d’authentification n’ont pas encore pris effet, fermez l’onglet du navigateur de votre application web et revenez au terrain de jeu de conversation dans le portail Azure AI Foundry. Attendez un peu plus longtemps et réessayez.

5. Dans votre application web, vous pouvez poser la même question qu’avant (« Combien coûtent les chaussures de randonnée TrailWalker ? »), et cette fois il utilise des informations de vos données pour construire la réponse. Vous pouvez développer le bouton Informations de référence pour afficher les données utilisées.

   

Comprendre l’historique des conversations

Grâce à la fonction d’historique des conversations, vos utilisateurs ont accès à leurs requêtes et réponses individuelles précédentes.

Vous pouvez activer l'historique des discussions lorsque vous déployez l'application Web. Cochez la case Activer l’historique des discussions dans l’application Web.

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

Une fois l’historique des conversations activé, 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.

Si vous supprimez la ressource Cosmos DB, mais conservez l’option d’historique des conversations activée dans 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.

Mettre à jour l’application web

Utilisez le terrain de jeu pour ajouter plus de données ou tester le modèle avec différents scénarios. Lorsque vous êtes prêt à mettre à jour l’application web avec le nouveau modèle, sélectionnez une nouvelle fois Déployer > ...en tant qu’application web. Sélectionnez Mettre à jour une application web existante et choisissez l’application web existante dans la liste. Le nouveau modèle est déployé sur l’application web existante.

Nettoyer les ressources

Pour éviter la facturation de coûts inutiles, vous devez supprimer les ressources créées dans ce guide de démarrage rapide si elles ne sont plus nécessaires. Pour gérer les ressources, vous pouvez utiliser le Portail Microsoft Azure.

Contenu connexe

• Bien démarrer avec la création d’une application de conversation en utilisant le Kit de développement logiciel (SDK) de flux d’invite
• Créez une application de conversation personnalisée avec le Kit de développement logiciel (SDK) Azure AI..