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

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

Votre source de données base le modèle avec des données spécifiques. Se baser signifie que le modèle utilise vos données pour comprendre le contexte de votre question. Vous ne modifiez pas le modèle déployé en lui-même. Vos données restent distinctes et sécurisées dans votre source de données d’origine.

Les étapes de ce tutoriel sont les suivantes :

Conditions préalables

• Un compte Azure avec un abonnement actif. Si vous n’en avez pas, créez un compte Azure gratuit, qui inclut un abonnement d’essai gratuit.
• Si vous n’en avez pas, créez un projet hub.

• Modèle de conversation Azure OpenAI déployé. Terminez le guide de démarrage rapide Foundry Playground pour créer cette ressource si vous n’en avez pas.

• 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 référentiel Azure-Samples/rag-data-openai-python-promptflow sur GitHub contient des exemples d’informations sur les produits de vente au détail pour le scénario de ce didacticiel. Le fichier product_info_11.md contient des informations sur les chaussures de randonnée TrailWalker pour l’ exemple de ce didacticiel. Téléchargez les exemples de données de produits 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é afin que vous puissiez effectuer un déploiement 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. Seul le propriétaire des ressources Azure spécifiques peut accorder des autorisations par attribution de rôle.

Portail Foundry et portail Azure

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

Le portail Foundry est un environnement web permettant de créer, d’entraîner et de déployer des modèles IA. En tant que développeur, c’est là que vous générez et déployez 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 utilisez le portail pour configurer des paramètres pour différents services Azure requis pour l’accès à partir de l’application web.

Configuration des ressources

Pour que les ressources fonctionnent correctement dans une application web, configurez les autorisations appropriées dans le portail Azure.

Tout d’abord, identifiez les ressources que vous devez configurer dans le portail Foundry.

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

2. Sélectionnez 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 / Astuce

   Si vous ne voyez pas Type dans le tableau, sélectionnez Colonnes dans le coin supérieur droit, puis ajoutez ou réorganisez les colonnes Sélectionnées. Si vous avez plusieurs ressources Azure OpenAI, utilisez celle qui contient votre modèle de conversation déployé.

5. Recherchez chacun de ces noms dans le portail Azure. Ouvrez chacun d’eux dans un nouvel onglet de navigateur pour pouvoir basculer entre eux.

6. Lorsque vous avez terminé, vous avez trois nouveaux onglets de navigateur ouverts : Service de recherche, Foundry et conteneur blobstore. Laissez les trois onglets ouverts, car vous devez basculer entre eux pour configurer les ressources.

Activer une identité managée

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

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

Dans l’onglet navigateur de la ressource Foundry dans le portail Azure, activez l’identité managée :

1. Dans le volet gauche, sous Gestion des ressources, 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 navigateur de la ressource de service de recherche dans le portail Azure, définissez la stratégie d’accès aux API :

1. Dans le volet gauche, sous Paramètres, 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.

Attribuer des rôles

Répétez ce modèle pour chaque ressource dans les étapes 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. Ensuite, sélectionnez 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, Foundry Tools ou le service Search.
   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.

Procédez de la manière suivante pour attribuer des rôles pour les ressources que vous avez configurées dans ce didacticiel :

• Attribuez ces rôles dans l’onglet de navigateur pour Service de recherche dans le portail Azure :

  • Lecteur de données d’index de recherche pour l’identité managée Foundry
  • Contributeur de service de recherche à l'identité gérée Foundry
  • 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.)

• Attribuez ces rôles dans l’onglet navigateur de Foundry dans le portail Azure :

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

• Attribuez ces rôles sous l’onglet navigateur du stockage Blob Azure dans le portail Azure :

  • Contributeur aux données Blob du stockage pour l’identité managée Foundry
  • 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 guide de démarrage rapide du terrain de jeu Foundry (c’est-à-dire un prérequis pour ce didacticiel), vous voyez comment votre modèle répond sans vos données. Ajoutez vos données au modèle afin qu’elles puissent répondre à des questions sur 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 qui sont pertinentes pour cet exemple de didacticiel. Téléchargez les exemples de données de produits 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 Microsoft Foundry.

2. Sélectionnez Terrains de jeu dans le volet gauche.

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>+ 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 avez 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. Ensuite, sélectionnez 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. Ensuite, sélectionnez 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

Lorsque vous êtes satisfait de l’expérience dans le portail Foundry, déployez le modèle en tant qu’application web autonome.

Accéder au groupe de ressources dans le portail Azure

Dans ce tutoriel, déployez votre application web sur le même groupe de ressources que votre hub Foundry. Vous allez configurer l’authentification pour l’application web dans le portail Azure.

Procédez de la manière suivante pour accéder à votre groupe de ressources dans le portail Azure :

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

2. Sous le titre Projet, 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 êtes maintenant dans le portail Azure où vous pouvez voir le contenu du groupe de ressources dans lequel 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, supprimez-la du portail Azure.

Pour déployer l’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’un modèle déployé, comme décrit dans le guide de démarrage rapide du terrain de jeu 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 se déploie. Ce processus 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. Vous y retournerez ultérieurement.

Configurer l’authentification d’application web

Par défaut, vous êtes le seul à pouvoir accéder à l’application web. Dans ce didacticiel, ajoutez l’authentification pour restreindre l’accès aux membres de votre locataire Azure. Les utilisateurs se connectent avec leur compte Microsoft Entra pour accéder à votre application. Vous pouvez suivre un processus similaire pour ajouter un autre fournisseur d’identité si vous préférez. L’application utilise uniquement les informations de connexion de l’utilisateur pour vérifier qu’elle est membre de votre locataire.

1. Revenez à l’onglet du navigateur avec le portail Azure ou ouvrez le portail Azure dans un nouvel onglet de navigateur. Affichez le contenu du groupe de ressources dans lequel vous avez déployé l’application web. Vous devrez peut-être actualiser la vue pour voir 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

Utiliser l’application web

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

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

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

3. Sélectionnez Lancer pour ouvrir 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 l’ouvrir.

   Si les paramètres d’authentification ne sont pas encore actifs, fermez l’onglet du navigateur de votre application web et revenez au terrain de jeu de conversation dans le portail Foundry. Attendez un peu plus longtemps, puis réessayez.

5. Dans votre application web, posez la même question qu’avant (« Combien valent les chaussures de randonnée TrailWalker »). Cette fois, l’application utilise des informations de vos données pour construire la réponse. Développez le bouton Référence pour afficher les données utilisées.

   

Comprendre l’historique des conversations

Avec la fonctionnalité d’historique des conversations, vos utilisateurs peuvent voir leurs requêtes et réponses précédentes.

Activez l’historique des conversations lorsque vous déployez l’application web. Cochez la case Activer l’historique des discussions dans l’application Web.

Après avoir activé l’historique des conversations, vos utilisateurs peuvent l’afficher ou le masquer dans le coin supérieur droit de l’application. Lorsque l’historique est affiché, ils peuvent renommer ou supprimer des conversations. À mesure qu’elles sont connectées à l’application, les conversations sont classées du plus récent au plus ancien, et nommées en fonction de la première requête de la conversation.

Si vous supprimez la ressource Cosmos DB mais que l’option d’historique des conversations est activée dans le studio, vos utilisateurs voient une erreur de connexion, mais peuvent continuer à utiliser l’application web sans 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, puis 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 les coûts Azure inutiles, supprimez les ressources que vous avez créées dans ce guide de démarrage rapide si vous n’en avez pas besoin. Gérez les ressources dans le portail Azure.

Contenu connexe

• Commencez à créer une application de chat en utilisant le SDK Prompt Flow
• Créer une application de conversation personnalisée avec le SDK Azure AI