Démarrage rapide : vectoriser du texte et des images à l’aide du portail Microsoft Azure

Ce guide de démarrage rapide vous explique comment utiliser la vectorisation intégrée en utilisant l’Assistant Importation et vectorisation des données dans le portail Microsoft Azure. L’Assistant segmente votre contenu et appelle un modèle d’incorporation pour vectoriser le contenu pendant l’indexation et pour les requêtes.

Prérequis

• Un abonnement Azure. Créez-en un gratuitement.

• Un service Recherche Azure AI dans la même région qu’Azure AI. Nous vous recommandons le niveau Essentiel ou un niveau supérieur.

• Une source de données prise en charge avec les exemples de documents PDF du plan d’intégrité.

• Un modèle d’incorporation pris en charge.

• Être familiarisé avec l’Assistant. Pour plus d’informations, consultez Assistants Importation de données dans le portail Azure.

Sources de données prises en charge

L’Assistant Importation et vectorisation de données prend en charge un large éventail de sources de données Azure, mais ce guide de démarrage rapide fournit des étapes seulement pour les sources de données qui fonctionnent avec des fichiers entiers :

• Stockage Blob Azure pour les blobs et les tables. Stockage Azure doit être un compte avec des performances standard (universel v2). Le niveau d’accès peut être chaud, sporadique et froid.

• Azure Data Lake Storage (ADLS) Gen2 (un compte de stockage avec un espace de noms hiérarchique activé). Vous pouvez confirmer que Data Lake Storage est activé en vérifiant l’onglet Propriétés de la page vue d’ensemble vue d’ensemble.

  

• Lakehouse OneLake (préversion).

Modèles d’incorporation pris en charge

Utilisez un modèle d’incorporation sur une plateforme d’IA Azure dans la même région que Recherche Azure AI. Les instructions de déploiement figurent dans cet article.

Si vous utilisez Azure OpenAI Service, le point de terminaison doit avoir un sous-domaine personnalisé associé. Un sous-domaine personnalisé est un point de terminaison qui inclut un nom unique (par exemple, https://hereismyuniquename.cognitiveservices.azure.com). Si le service a été créé via le Portail Azure, ce sous-domaine est automatiquement généré dans le cadre de la configuration de votre service. Vérifiez que votre service inclut un sous-domaine personnalisé avant de l’utiliser avec l’intégration de Recherche Azure AI.

Les ressources Azure OpenAI Service (avec accès aux modèles d’incorporation) créées dans le portail Azure AI Foundry ne sont pas prises en charge. Seules les ressources Azure OpenAI Service créées dans le Portail Azure sont compatibles avec l’intégration de la compétence Incorporation d’Azure OpenAI.

Exigences relatives aux points de terminaison publics

Dans le cadre de ce guide de démarrage rapide, l’accès public doit être activé pour toutes les ressources précédentes afin que les nœuds du portail Azure puissent y accéder. Sinon, l’Assistant échoue. Une fois l’Assistant exécuté, vous pouvez activer des pare-feux et des points de terminaison privés sur les composants d’intégration à des fins de sécurité. Pour plus d’informations, consultez Connexions sécurisées dans les Assistants d’importation.

Si des points de terminaison privés sont déjà présents et que vous ne pouvez pas les désactiver, une autre option consiste à exécuter le flux respectif de bout en bout à partir d’un script ou d’un programme sur une machine virtuelle. La machine virtuelle doit se trouver sur le même réseau virtuel que le point de terminaison privé. Voici un exemple de code Python pour la vectorisation intégrée. Le même référentiel GitHub contient des exemples dans d’autres langages de programmation.

autorisations

Vous pouvez utiliser l’authentification par clé et des chaînes de connexion d’accès complet, ou Microsoft Entra ID avec des attributions de rôle. Nous vous recommandons d’utiliser des attributions de rôle pour les connexions du service de recherche à d’autres ressources.

1. Sur Recherche Azure AI, activez les rôles.

2. Configurez votre service de recherche pour utiliser une identité managée.

3. Sur votre plateforme de source de données et votre fournisseur de modèles d’incorporation, créez des attributions de rôles qui permettent au service de recherche d’accéder aux données et aux modèles. Préparer des exemples de données fournit des instructions pour configurer des rôles pour chaque source de données prise en charge.

Un service de recherche gratuit prend en charge les connexions en fonction du rôle à Recherche Azure AI, mais il ne prendra pas en charge les identités managées sur les connexions sortantes vers Stockage Azure ou Azure AI Vision. Ce niveau de prise en charge signifie que vous devez utiliser l’authentification basée sur les clés sur les connexions entre un service de recherche gratuit et d’autres services Azure.

Pour les connexions plus sécurisées :

• Utilisez le niveau Essentiel ou supérieur.
• Configurez une identité managée et utilisez des rôles pour l’accès autorisé.

Vérifier l’espace disponible

Si vous commencez par le niveau Gratuit, vous êtes limité à trois index, aux sources de données, aux ensembles de compétences et aux indexeurs. Le niveau De base vous limite à 15. Avant de commencer, assurez-vous de disposer d’assez d’espace pour stocker des éléments supplémentaires. Ce guide de démarrage rapide crée une occurrence de chaque objet.

Préparer l’exemple de données

Cette section traite du contenu qui fonctionne pour ce guide de démarrage rapide.

Configurer les modèles d’incorporation

L’Assistant peut utiliser des modèles incorporés déployés à partir d’Azure OpenAI, d’Azure AI Vision ou du catalogue de modèles dans le portail Azure AI Foundry.

Démarrer l’Assistant

1. Connectez-vous au portail Azure avec votre compte Azure, puis accédez à votre service Azure AI Search.

2. Dans la page Vue d’ensemble, sélectionnez Importation et vectorisation des données.

   

Connexion à vos données

L’étape suivante consiste à se connecter à une source de données à utiliser pour l’index de recherche.

Vectoriser votre texte

Dans cette étape, spécifiez le modèle d’incorporation pour vectoriser les données segmentées.

La segmentation est intégrée et non configurable. Les paramètres effectifs sont les suivants :

"textSplitMode": "pages",
"maximumPageLength": 2000,
"pageOverlapLength": 500,
"maximumPagesToTake": 0, #unlimited
"unit": "characters"

1. Dans la page Vectoriser votre texte, choisissez la source du modèle d’incorporation :

   • Azure OpenAI
   • Catalogue de modèles Azure AI Foundry
   • Ressource multimodale Azure AI Vision existante dans la même région qu’Azure AI Search. S’il n’existe aucun compte multiservices Azure AI Services dans la même région, cette option n’est pas disponible.

2. Sélectionnez l’abonnement Azure.

3. Effectuez des sélections en fonction de la ressource :

   • Pour Azure OpenAI, choisissez un déploiement existant de text-embedding-ada-002, text-embedding-3-large ou text-embedding-3-small.

   • Pour le catalogue Azure AI Foundry, choisissez un déploiement existant d’un modèle d’incorporation Azure ou Cohere.

   • Pour les incorporations multimodales AI Vision, sélectionnez le compte.

   Pour plus d’informations, consultez Configurer des modèles d’incorporation plus haut dans cet article.

4. Spécifiez si vous souhaitez que votre service de recherche s’authentifie à l’aide d’une clé API ou d’une identité managée.

   • L’identité doit avoir un rôle d'utilisateur OpenAI Cognitive Services OpenAI sur le compte multiservices Azure AI.

5. Cochez la case indiquant que vous avez connaissance des effets de l’utilisation de ces ressources sur la facturation.

   

6. Cliquez sur Suivant.

Vectoriser et enrichir vos images

Les fichiers PDF du plan d’intégrité incluent un logo d’entreprise, mais aucune autre image. Vous pouvez ignorer cette étape si vous utilisez les exemples de documents.

Cependant, si vous travaillez avec du contenu qui inclut des images utiles, vous pouvez appliquer l’IA de deux manières :

• Utiliser un modèle d’incorporation d’images pris en charge à partir du catalogue ou choisir l’API d’incorporations multimodales Azure AI Vision pour vectoriser les images.

• Utilisez la reconnaissance optique de caractères (OCR) pour reconnaître du texte dans des images. Cette option appelle la compétence OCR pour lire du texte à partir d’images.

La Recherche Azure AI et votre ressource Azure AI doivent se trouver dans la même région ou être configurées pour les connexions de facturation sans clé.

1. Dans la page Vectoriser vos images, spécifiez le type de connexion que l’Assistant doit établir. Pour la vectorisation d’images, l’Assistant peut se connecter à des modèles d’incorporation dans le portail Azure AI Foundry ou Azure AI Vision.

2. Spécifiez l’abonnement.

3. Pour le catalogue de modèles Azure AI Foundry, spécifiez le projet et le déploiement. Pour plus d’informations, consultez Configurer des modèles d’incorporation plus haut dans cet article.

4. Si vous le souhaitez, vous pouvez fissurer des images binaires (par exemple, des fichiers de documents analysés) et utiliser des OCR pour reconnaître du texte.

5. Cochez la case indiquant que vous avez connaissance des effets de l’utilisation de ces ressources sur la facturation.

   

6. Cliquez sur Suivant.

Ajouter le classement sémantique

Dans la page Paramètres avancés, vous pouvez éventuellement ajouter un classement sémantique pour reclasser les résultats à la fin de l’exécution de la requête. La reclassement place les correspondances les plus sémantiquement pertinentes en haut.

Mapper de nouveaux champs

Points clés de cette étape :

• Le schéma d’index fournit des champs vectoriels et non vectoriels pour les données segmentées.
• Vous pouvez ajouter des champs, mais vous ne pouvez pas supprimer ou modifier des champs générés.
• Le mode d’analyse syntaxique crée des segments (un document de recherche par segment).

Sur la page Paramètres avancés, vous pouvez éventuellement ajouter de nouveaux champs en supposant que la source de données fournit des métadonnées ou des champs qui ne sont pas récupérés lors du premier passage. Par défaut, l’Assistant génère les champs suivants avec ces attributs :

Vous ne pouvez pas modifier les champs générés ou leurs attributs, mais vous pouvez ajouter de nouveaux champs si votre source de données les fournit. Par exemple, Stockage Blob Azure fournit une collection de champs de métadonnées.

1. Sélectionnez Ajouter.

2. Choisissez un champ source dans la liste des champs disponibles, fournissez un nom de champ à l’index et acceptez le type de données par défaut ou remplacez si nécessaire.

   Les champs de métadonnées sont interrogeables, mais non récupérables, filtrables, à choix multiples ou triables.

3. Sélectionnez Réinitialiser si vous souhaitez restaurer le schéma dans sa version d’origine.

Planifier l’indexation

Dans la page Paramètres avancés, vous pouvez éventuellement spécifier une planification d’exécution pour l’indexeur.

1. Sélectionnez Suivant une fois que vous avez terminé avec la page Paramètres avancés.

Terminez l’Assistant.

1. Dans la page Passer en revue votre configuration, spécifiez un préfixe pour les objets créés par l’Assistant. Un préfixe courant vous aide à rester organisé.

2. Sélectionnez Créer.

Au terme de la configuration, l’Assistant crée les objets suivants :

• Connexion de la source de données.

• Index avec des champs vectoriels, des vectoriseurs, des profils vectoriels et des algorithmes vectoriels. Vous ne pouvez pas concevoir ou modifier l’index par défaut pendant le flux de travail de l’Assistant. Les index sont conformes à l’API REST 2024-05-01-preview.

• Ensemble de compétences avec la compétence Fractionnement de texte pour la segmentation et une compétence d’incorporation pour la vectorisation. La compétence d’incorporation est la compétence AzureOpenAIEmbeddingModel pour Azure OpenAI ou la compétence AML pour le catalogue de modèles Azure AI Foundry. L’ensemble de compétences comprend également la configuration projections d’index, qui permet de mapper les données d’un document dans la source de données à ses blocs correspondants dans un index « enfant ».

• Indexeur avec mappages de champs et mappages de champs de sortie (le cas échéant).

Vérifier les résultats

L’Explorateur de recherche accepte les chaînes de texte comme entrée, puis vectorise le texte pour l’exécution de requête vectorielle.

1. Dans le portail Microsoft Azure, accédez à Gestion de la recherche>Index, puis sélectionnez l’index que vous avez créé.

2. Sélectionnez Options de requête et masquez les valeurs vectorielles dans les résultats de recherche. Cette étape facilite la lecture de vos résultats de recherche.

   

3. Dans le menu Vue, sélectionnez Vue JSON afin de pouvoir entrer du texte pour votre requête vectorielle dans le paramètre de requête vectorielle text.

   

   La requête par défaut est une recherche vide ("*"), mais inclut des paramètres pour retourner le nombre de correspondances. Il s’agit d’une requête hybride qui exécute des requêtes textuelles et vectorielles en parallèle. Elle inclut le classement sémantique. Elle spécifie les champs à retourner dans les résultats via l’instruction select.

    {
      "search": "*",
      "count": true,
      "vectorQueries": [
        {
          "kind": "text",
          "text": "*",
          "fields": "text_vector,image_vector"
        }
      ],
      "queryType": "semantic",
      "semanticConfiguration": "my-demo-semantic-configuration",
      "captions": "extractive",
      "answers": "extractive|count-3",
      "queryLanguage": "en-us",
      "select": "chunk_id,text_parent_id,chunk,title,image_parent_id"
    }
   

4. Remplacez les espaces réservés astérisques (*) par une question relative aux plans d’intégrité, telle que Which plan has the lowest deductible?.

    {
      "search": "Which plan has the lowest deductible?",
      "count": true,
      "vectorQueries": [
        {
          "kind": "text",
          "text": "Which plan has the lowest deductible?",
          "fields": "text_vector,image_vector"
        }
      ],
      "queryType": "semantic",
      "semanticConfiguration": "my-demo-semantic-configuration",
      "captions": "extractive",
      "answers": "extractive|count-3",
      "queryLanguage": "en-us",
      "select": "chunk_id,text_parent_id,chunk,title"
    }
   

5. Sélectionnez Rechercher pour exécuter la requête.

   

   Chaque document est un bloc du fichier PDF d’origine. Le champ title indique le fichier PDF du bloc. Chaque chunk est assez long. Vous pouvez le copier puis le coller dans un éditeur de texte pour lire la valeur entière.

6. Pour voir tous les blocs d’un document spécifique, ajoutez un filtre sur le champ title_parent_id pour un fichier PDF spécifique. Vous pouvez vérifier l’onglet Champs de votre index pour confirmer que ce champ est filtrable.

   {
      "select": "chunk_id,text_parent_id,chunk,title",
      "filter": "text_parent_id eq 'aHR0cHM6Ly9oZWlkaXN0c3RvcmFnZWRlbW9lYXN0dXMuYmxvYi5jb3JlLndpbmRvd3MubmV0L2hlYWx0aC1wbGFuLXBkZnMvTm9ydGh3aW5kX1N0YW5kYXJkX0JlbmVmaXRzX0RldGFpbHMucGRm0'",
      "count": true,
      "vectorQueries": [
          {
             "kind": "text",
             "text": "*",
             "k": 5,
             "fields": "text_vector"
          }
       ]
   }
   

Nettoyage

Azure AI Search est une ressource facturable. Si elle n’est plus nécessaire, supprimez-la de votre abonnement pour éviter des frais.

Étape suivante

Ce guide de démarrage rapide vous a présenté l’Assistant Importation et vectorisation des données qui crée tous les objets nécessaires à la vectorisation intégrée. Si vous souhaitez explorer chaque étape en détail, essayez un exemple de vectorisation intégrée.