Configurer le classeur sémantique et retourner des légendes dans les résultats de la recherche

Le classement sémantique itère sur un jeu de résultats initial, en appliquant une méthodologie de classement L2 qui privilégie les résultats les plus sémantiquement pertinents en haut de la pile. Vous pouvez également obtenir des légendes sémantiques, avec des mises en surbrillance sur les termes et expressions les plus pertinents, ainsi que des réponses sémantiques.

Cet article explique comment configurer un index de recherche pour la reclassement sémantique.

Remarque

Si vous avez du code existant qui appelle la préversion ou les versions précédentes de l’API, consultez Migrer le code de classement sémantique pour obtenir de l’aide sur la modification de votre code.

Prérequis

• Un service de recherche sur un niveau Essentiel ou supérieur, soumis à la disponibilité de la région.

• Classeur sémantique activé sur votre service de recherche.

• Un index de recherche existant avec du contenu texte varié. Le classement sémantique s’applique à des champs de chaînes (non vectoriels), et fonctionne le mieux sur du contenu qui est d’ordre informationnel ou descriptif.

Choisissez un client

Vous pouvez spécifier une configuration sémantique sur des index nouveaux ou existants, à l’aide de l’un des outils et kits de développement logiciel (SDK) suivants pour ajouter une configuration sémantique :

• Portail Azure, avec le concepteur d’index pour ajouter une configuration sémantique
• Visual Studio Code avec le client REST et une API Créer ou Mettre à jour (REST).
• Kit de développement logiciel (SDK) Azure pour .NET
• Kit de développement logiciel (SDK) Azure pour Python
• Kit de développement logiciel (SDK) Azure pour Java
• Kit de développement logiciel (SDK) pour JavaScript

Ajouter une configuration sémantique

Une configuration sémantique est une section de votre index qui spécifie les entrées des champs pour le classement sémantique. Vous pouvez ajouter ou mettre à jour une configuration sémantique à tout moment, sans devoir reconstruire votre index. Si vous créez plusieurs configurations, vous pouvez spécifier une configuration par défaut. À l’exécution de la requête, spécifiez une configuration sémantique sur une demande de requête ou laissez-la vide pour utiliser la configuration par défaut.

Une configuration sémantique a un nom et les propriétés suivantes :

Propriété	Caractéristiques
Champ Titre	Une chaîne courte, idéalement de moins de 25 mots. Ce champ peut être le titre d’un document, le nom d’un produit ou un identificateur unique. Si vous n’avez pas de champ approprié, laissez-le vide.
Champs de contenu	Des blocs de texte plus longs en langage naturel, soumis à des limites maximales d’entrées de jeton sur les modèles Machine Learning. Le corps d’un document, la description d’un produit ou tout autre texte libre en sont des exemples courants.
Champs de mot clé	Une liste de mots clés, tels que les étiquettes d’un document, ou un terme descriptif, comme la catégorie d’un élément.

Vous pouvez spécifier seulement un champ de titre, mais vous pouvez avoir autant de champs de contenu et de mot clé que vous le souhaitez. Pour les champs de contenu et de mot clé, listez les champs par ordre de priorité, car les champs de moindre priorité peuvent être tronqués.

Pour toutes les propriétés de configuration sémantique, les champs que vous affectez doivent être :

• Avec les attributs searchable et retrievable
• Chaînes de type Edm.String, Collection(Edm.String), sous-champs de chaîne de Edm.ComplexType

Azure portal

1. Connectez-vous au portail Azure, puis accédez à un service de recherche pour lequel le classement sémantique est activé.

2. Dans le volet de navigation de gauche, à partir des Index, sélectionnez un index.

3. Sélectionnez Configurations sémantiques, puis Ajouter une configuration sémantique.

   

4. Sur la page Nouvelle configuration sémantique, entrez un nom de configuration sémantique, puis sélectionnez les champs à utiliser dans la configuration sémantique. Seuls les champs de type chaîne pouvant faire l’objet d’une recherche et récupérables sont autorisés. Veillez à répertorier les champs de contenu et les champs de mot clé par ordre de priorité.

   

5. Sélectionnez Enregistrer pour enregistrer les paramètres de configuration.

6. Sélectionnez à nouveau Enregistrer sur la page d’index pour enregistrer la configuration sémantique dans l’index.

REST API

1. Formulez une demande De création ou de mise à jour d’index .

2. Ajoutez une configuration sémantique à la définition d’index, peut-être après scoringProfiles ou suggesters. La spécification d’une configuration par défaut est facultative, mais elle est pratique si vous avez plusieurs configurations.

   "semantic": {
       "defaultConfiguration": "my-semantic-config-default",
       "configurations": [
           {
               "name": "my-semantic-config-default",
               "prioritizedFields": {
                   "titleField": {
                       "fieldName": "HotelName"
                   },
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ],
                   "prioritizedKeywordsFields": [
                       {
                           "fieldName": "Tags"
                       }
                   ]
               }
           },
                       {
               "name": "my-semantic-config-desc-only",
               "prioritizedFields": {
                   "prioritizedContentFields": [
                       {
                           "fieldName": "Description"
                       }
                   ]
               }
           }
       ]
   }
   

Kit de développement logiciel (SDK) .NET

Utilisez la classe SemanticConfiguration dans le SDK Azure pour .NET.

L’exemple suivant provient de l’exemple de classement sémantique créé par l’équipe SDK Azure.

string indexName = "hotel";
SearchIndex searchIndex = new(indexName)
{
    Fields =
    {
        new SimpleField("HotelId", SearchFieldDataType.String) { IsKey = true, IsFilterable = true, IsSortable = true, IsFacetable = true },
        new SearchableField("HotelName") { IsFilterable = true, IsSortable = true },
        new SearchableField("Description") { IsFilterable = true },
        new SearchableField("Category") { IsFilterable = true, IsSortable = true, IsFacetable = true },
    },
    SemanticSearch = new()
    {
        Configurations =
        {
            new SemanticConfiguration("my-semantic-config", new()
            {
                TitleField = new SemanticField("HotelName"),
                ContentFields =
                {
                    new SemanticField("Description")
                },
                KeywordsFields =
                {
                    new SemanticField("Category")
                }
            })
        }
    }
};

Étapes suivantes

Testez votre configuration sémantique en exécutant une requête sémantique.

Créer une requête sémantique