Configurer le classificateur sémantique et afficher des légendes dans les résultats de recherche

Le classement sémantique itère sur un jeu de résultats initial, en appliquant une méthodologie de classement L2 qui promeut 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 et les réponses sémantiques.

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

Conditions préalables

• Recherche Azure AI dans n’importe quelle region qui fournit un classement sémantique.

• Index de recherche existant avec du contenu de texte enrichi. Le classement sémantique s’applique aux champs de chaînes (non-vecteurs) et fonctionne le mieux sur le contenu qui est informationnel ou descriptif.

• Autorisation de créer et d’utiliser des objets sur Recherche Azure AI. Nous vous recommandons d’accéder en fonction du rôle, mais vous pouvez utiliser des clés API si une attribution de rôle n’est pas réalisable. Pour plus d’informations, consultez Se connecter à un service de recherche.

• La version 2026-08-01-preview de l’API REST du service de recherche.

Choisir 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 :

• Azure Portal, à l’aide de l'index designer pour ajouter une configuration sémantique.
• Visual Studio Code avec le client REST et l'API Créer ou Mettre à Jour l'Index (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) Azure pour JavaScript

Ajouter une configuration sémantique

Certaines charges de travail créent automatiquement une configuration sémantique. Si vous utilisez la récupération agentique et une source knowledge qui indexe le contenu sur Recherche Azure AI, votre index généré a déjà une configuration sémantique qui fonctionne pour votre contenu.

Pour les autres charges de travail, vous pouvez configurer vous-même une configuration sémantique. Une configuration sémantique est une section de votre index qui établit les entrées de champ utilisées pour le classement sémantique. Vous pouvez ajouter ou mettre à jour une configuration sémantique à tout moment, aucune reconstruction n’est nécessaire. Si vous créez plusieurs configurations, vous pouvez spécifier une valeur par défaut. Au moment de la requête, spécifiez une configuration sémantique sur une requête de requête ou laissez-la vide pour utiliser la valeur par défaut.

Vous pouvez créer jusqu’à 100 configurations sémantiques dans un seul index.

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

Vous ne pouvez spécifier qu’un seul 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é, répertoriez les champs dans l’ordre de priorité, car les champs de priorité inférieure peuvent être tronqués.

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

• Attribué comme searchable et retrievable
• Chaînes de type Edm.String, Collection(Edm.String), sous-champs de chaîne de Edm.ComplexType

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")
                }
            })
        }
    }
};

Activez les modèles de classement sémantique en préversion (préversion)

À l’aide des API REST en préversion et des SDK Azure en préversion qui prennent en charge cette propriété, vous pouvez configurer facultativement un index pour utiliser des modèles de classement sémantique en préversion si l’un d’eux est déployé dans votre région. Il n’existe aucun mécanisme permettant de savoir si une préversion est disponible ou si elle a été utilisée sur une requête spécifique. Pour cette raison, nous vous recommandons d’utiliser cette propriété dans des environnements de test, et seulement si vous souhaitez essayer les derniers modèles de classement sémantique.

La propriété de configuration est , et elle est "flightingOptIn": truedéfinie dans la section de configuration sémantique d’un index. La propriété a la valeur null ou false par défaut. Vous pouvez définir la valeur true sur une demande de création ou de mise à jour à tout moment et affecter les requêtes sémantiques en avance, en supposant que la requête stipule une configuration sémantique qui inclut la propriété.

PUT https://myservice.search.windows.net/indexes('hotels')?allowIndexDowntime=False&api-version=2026-08-01-preview

{
  "name": "hotels",
  "fields": [ ],
  "scoringProfiles": [ ],
  "defaultScoringProfile": "geo",
  "suggesters": [ ],
  "analyzers": [ ],
  "corsOptions": { },
  "encryptionKey": { },
  "similarity": { },
  "semantic": {
    "configurations": [
      {
        "name": "semanticHotels",
        "prioritizedFields": {
          "titleField": {
            "fieldName": "hotelName"
          },
        "prioritizedContentFields": [
            {
              "fieldName": "description"
            },
            {
              "fieldName": "description_fr"
            }
          ],
        "prioritizedKeywordsFields": [
            {
              "fieldName": "tags"
            },
            {
              "fieldName": "category"
            }
          ],
        "flightingOptIn": true
        }
      }
    ]
  },
  "vectorSearch": {  }
}

Étapes suivantes

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