Partager via

Démarrage rapide : Utiliser l’Explorateur de recherche pour exécuter des requêtes dans le portail Azure

Dans ce guide de démarrage rapide, vous allez apprendre à utiliser l’Explorateur de recherche, un outil de requête intégré dans le portail Azure pour exécuter des requêtes sur un index Recherche IA Azure. Utilisez cet outil pour tester une expression de requête ou de filtre ou pour vérifier si le contenu existe dans l’index.

Ce guide de démarrage rapide utilise un index existant pour illustrer l’explorateur de recherche.

Prérequis

Démarrer l’Explorateur de recherche

  1. Connectez-vous au portail Azure et sélectionnez votre service de recherche.

  2. Dans le volet gauche, sélectionnez Vue d’ensemble.

  3. Dans la barre de commandes, sélectionnez Explorateur de recherche.

    Capture d’écran de la commande Explorateur de recherche dans le portail.

    Vous pouvez également sélectionner l’onglet Explorateur de recherche dans la page d’index.

Rechercher de trois manières

Il existe trois approches d’interrogation dans l’Explorateur de recherche :

  • La fenêtre Affichage des requêtes fournit une barre de recherche par défaut. Il accepte une requête vide ou une requête de texte libre avec des booléens, tels que ocean view + parking.

  • La vue image fournit une fenêtre permettant de parcourir ou de glisser-déplacer des fichiers PNG, JPG ou JPEG. Sauf si votre index possède un vectoriseur d’image et une compétence équivalente, cette vue n’est pas disponible.

  • La vue JSON prend en charge les requêtes paramétrisées. Les paramètres Filters, orderby, select, count, searchFields et tous les autres paramètres doivent être définis dans la vue JSON.

    Capture d’écran des trois vues pour l’interrogation dans l’Explorateur de recherche.

Exemple : Requête d’image

L’Explorateur de recherche accepte les images en tant qu’entrées de requête par le biais de la Vue image, ce qui vous oblige à utiliser une paire vectoriseur-compétence prise en charge. Pour plus d’informations, consultez Configurer un vectoriseur dans un index de recherche.

L’index hotels-sample n’est pas configuré pour la vectorisation d’image. Si vous souhaitez exécuter des requêtes d’image, créez un index comme décrit dans le guide de démarrage rapide : Recherche vectorielle dans le portail Azure. Le guide de démarrage rapide s’appuie sur des exemples de données basés sur du texte. Vous devez donc utiliser des documents contenant des images.

Pour exécuter une requête d’image, sélectionnez ou faites glisser une image vers la zone de recherche, puis sélectionnez Rechercher. L’Explorateur de recherche vectorise l’image et envoie le vecteur au moteur de recherche pour l’exécution de la requête. Le moteur de recherche retourne des documents suffisamment similaires à l’image d’entrée, jusqu’au nombre spécifié k de résultats.

Capture d’écran des résultats de recherche pour la recherche d’images.

Exemples : requêtes JSON

Voici des exemples de requêtes JSON que vous pouvez exécuter à l’aide de l’Explorateur de recherche. Pour suivre ces exemples, basculez vers la vue JSON. Vous pouvez coller chaque exemple JSON dans la zone de texte.

Conseil

La vue JSON prend en charge la fonctionnalité Intellisense pour la complétion du nom de paramètre. Placez votre curseur dans la vue JSON et entrez un espace pour afficher la liste de tous les paramètres de requête. Vous pouvez également entrer une lettre, par exemple s, pour afficher uniquement les paramètres de requête qui commencent par cette lettre.

IntelliSense n’exclut pas les paramètres non valides. Utilisez donc votre meilleur jugement.

Exécuter une requête non spécifiée

Dans l’Explorateur de recherche, les requêtes POST sont formulées en interne à l’aide de Documents - Recherche Post (API REST), avec des réponses retournées sous forme de documents JSON détaillés.

Pour un premier aperçu du contenu, exécutez une recherche vide en sélectionnant Rechercher sans termes fournis. Une recherche vide est utile en tant que première requête, car elle renvoie des documents entiers pour vous permettre d'examiner leur composition. Dans une recherche vide, il n’existe aucun score de recherche et les documents sont retournés dans un ordre arbitraire ("@search.score": 1 pour tous les documents). Par défaut, 50 documents sont retournés par demande de recherche.

Ajoutez "count": true pour obtenir le nombre de correspondances trouvées dans un index. Dans une recherche vide, le nombre est le nombre total de documents dans l’index. Dans une recherche qualifiée, il correspond au nombre de documents correspondant à l’entrée de requête. Rappelez-vous que le service retourne les 50 premières correspondances par défaut. Le nombre peut donc indiquer plus de correspondances dans l’index que ce qui est retourné dans les résultats.

La syntaxe équivalente d'une recherche vide est * ou "search": "*".

{
   "search": "*",
   "count": true
}

Résultats

Capture d’écran d’un exemple de nombre.

Exécuter une requête de texte libre

La recherche en forme libre, avec ou sans opérateurs, est utile pour simuler des requêtes définies par l’utilisateur envoyées à partir d’une application personnalisée à Recherche Azure AI. Seuls les champs attribués comme pouvant faire l’objet d’une recherche dans l’index sont analysés pour les correspondances.

Vous n’avez pas besoin de la vue JSON pour une requête de texte libre, mais nous l’fournissons au format JSON pour assurer la cohérence avec d’autres exemples de cet article.

Notez que lorsque vous indiquez des critères de recherche, comme des termes ou expressions de requête, le classement de la recherche intervient. L'exemple suivant illustre une recherche de texte libre. Le @search.score est un score de pertinence calculé pour la correspondance à l’aide de l’algorithme de scoring par défaut.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Résultats

Vous pouvez utiliser Ctrl+F pour rechercher des termes spécifiques dans les résultats.

Capture d’écran d’un exemple de requête de texte libre.

Limiter les champs dans les résultats de la recherche

Ajoutez "select" pour limiter les résultats aux champs explicitement nommés pour obtenir une sortie plus lisible dans l’Explorateur de recherche. Seuls les champs attribués comme récupérables dans l’index peuvent apparaître dans les résultats.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Résultats

Capture d’écran de la restriction des champs dans l’exemple de résultats de recherche.

Retourner le jeu de résultats suivant

Azure AI Search retourne les 50 premières correspondances en fonction du rang de recherche. L’index de l’exemple d’hôtels n’a que 50 hôtels. Nous utilisons donc un nombre plus petit pour illustrer la pagination. Pour obtenir l’ensemble suivant de documents correspondants, ajoutez "top": 20 et "skip": 10 augmentez le jeu de résultats à 20 documents (la valeur par défaut est 50, la valeur maximale est 1 000), en ignorant les 10 premiers documents. Vous pouvez vérifier la clé de document (HotelId) pour identifier un document.

N'oubliez pas qu'il vous faut fournir des critères de recherche, terme ou expression de requête, pour obtenir des résultats classés. Les scores de recherche diminuent à mesure que vous descendez dans les résultats de recherche.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Résultats

Capture d’écran du retour du lot suivant des résultats de recherche.

Filtrer les expressions (supérieur à, inférieur à, égal à)

Utilisez le paramètre filter pour spécifier des critères d’inclusion ou d’exclusion. Le champ doit être attribué comme filtrable dans l’index. Cet exemple recherche les évaluations supérieures à quatre :

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Résultats

Capture d’écran d’un exemple de filtre.

Trier les résultats

Ajoutez orderby pour trier les résultats selon un autre champ à côté du score de recherche. Le champ doit être attribué comme triable dans l’index. Dans les cas où la valeur filtrée est identique (par exemple, le même prix), l’ordre est arbitraire, mais vous pouvez ajouter d’autres critères pour affiner le tri. Voici un exemple d’expression que vous pouvez utiliser pour tester ceci :

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Résultats

Capture d’écran d’un exemple de tri.

Éléments importants à retenir

Dans ce guide de démarrage rapide, vous avez utilisé l’Explorateur de recherche pour interroger un index à l’aide de l’API REST.

  • Les résultats sont retournés sous forme de documents JSON détaillés afin que vous puissiez afficher la construction et le contenu de chaque document dans son intégralité. Le select paramètre d’une expression de requête limite les champs retournés.

  • Les résultats de la recherche sont composés de tous les champs attribués comme récupérables dans l’index. Sélectionnez l’onglet Champs pour passer en revue les attributs.

  • La recherche de mots clés, similaire à ce que vous pouvez entrer dans un navigateur web commercial, est utile pour tester une expérience utilisateur final. Par exemple, en supposant l’index hotels-sample, entrez "activities 'outdoor pool' restaurant OR continental breakfast", puis utilisez Ctrl-F pour rechercher des termes dans les résultats de recherche.

  • Les expressions de requête et de filtre sont articulées dans une syntaxe implémentée par la Recherche Azure AI. Par défaut, cela correspond à une syntaxe simple, mais vous pouvez également utiliser Lucene complète pour de plus puissantes requêtes. Les expressions de filtre sont articulées dans une syntaxe OData.

Nettoyer les ressources

Lorsque vous travaillez dans votre propre abonnement, nous vous recommandons, à la fin de chaque projet, de déterminer si vous avez toujours besoin des ressources que vous avez créées. Les ressources laissées en cours d’exécution peuvent vous coûter de l’argent. Vous pouvez supprimer les ressources une par une, ou choisir de supprimer le groupe de ressources afin de supprimer l’ensemble des ressources.

Dans le portail Azure, vous pouvez rechercher et gérer des ressources en sélectionnant Toutes les ressources ou groupes de ressources dans le volet gauche.

N’oubliez pas qu’un service de recherche gratuit est limité à trois index, trois indexeurs et trois sources de données. Pour rester sous la limite, vous pouvez supprimer ces éléments individuellement dans le portail Azure.

Étape suivante

Pour en savoir plus sur les structures et la syntaxe des requêtes, utilisez un client REST pour créer des expressions de requête qui utilisent plus de parties de l’API REST. Documents - Recherche post (API REST) est particulièrement utile pour l’apprentissage et l’exploration.

Démarrage rapide : Recherche en texte intégral

  • Last updated on